メインコンテンツまでスキップ

サイト翻訳 API

ユニウェブのサイト翻訳言語を取得できます。
サイト翻訳言語を変更する場合は言語 APIをご利用ください。
API で利用している言語コードは、言語コードについてを参照ください。

備考

サイト翻訳 API の利用にはサイト翻訳機能のご契約が必要です。

uniweb.translation.initialize()

サイト翻訳 API を利用する前にセットアップ処理が必要です。
非同期で実行され、Promise を返します。

initialize(): Promise<void>;

uniweb.translation.getLanguages()

サイト翻訳で利用可能な言語一覧を取得します。

レスポンス (getLanguages)

言語情報オブジェクトの配列を返します。

const languages = uniweb.translation.getLanguages();

// レスポンスの例:
[
{
lang_code: 'es', // ISO 639-1 言語コードまたは BCP 47 言語タグ
japanese_text: 'スペイン語', // 日本語での言語名
english_text: 'Spanish', // 英語での言語名
native_text: 'Español', // 現地語名
},
{
lang_code: 'en',
japanese_text: '英語',
english_text: 'English',
native_text: 'English',
},
// ...
];

uniweb.translation.getCurrentLanguage()

現在サイト翻訳中の言語を取得します。

レスポンス (getCurrentLanguage)

現在の翻訳言語の情報オブジェクトを返します。
翻訳可能でない言語が選択されている場合は、undefinedが返ります。

const currentLang = uniweb.translation.getCurrentLanguage();
// レスポンスの例:
{
lang_code: "es", // ISO 639-1 言語コードまたは BCP 47 言語タグ
japanese_text: "スペイン語", // 日本語名
english_text: "Spanish", // 英語名
native_text: "Español" // 現地語名
}