ユーザーインターフェイス要素のローカリゼーション localization-of-user-interface-elements
Flyout ビューアに表示される特定のコンテンツは、ローカライゼーションの影響を受けます。 このコンテンツには、ロード時にフライアウト ズーム ビューによって表示されるユーザ インタフェース要素のツール ヒントと情報メッセージが含まれます。
ローカライズ可能なビューア内のすべてのテキストコンテンツは、SYMBOL と呼ばれる特別な Viewer SDK 識別子で表されます。 すべての SYMBOL には、デフォルトのビューアに付属する英語ロケール("en"
)のテキスト値が関連付けられています。 また、必要な数のロケールに対してユーザー定義の値を設定することもできます。
ビューアは起動時、現在のロケールを調べて、そのロケールでサポートされている各 SYMBOL にユーザー定義の値があるかどうかを確認します。 デフォルト値が存在する場合は、ユーザー定義の値が使用され、存在しない場合は、標準のデフォルトテキストにフォールバックします。
ユーザー定義のローカライゼーションデータは、ローカライゼーション JSON オブジェクトとしてビューアに渡すことができます。 このようなオブジェクトには、サポートされているロケール、各ロケールの SYMBOL テキスト値、デフォルトのロケールのリストが含まれます。
このようなローカリゼーションオブジェクトの例を次に示します。
{
"en":{
"FlyoutZoomView.TIP_BUBBLE_OVER":"Mouse over to zoom",
"FlyoutZoomView.TIP_BUBBLE_TAP":"Tap and hold to zoom"
},
"fr":{
"FlyoutZoomView.TIP_BUBBLE_OVER":"Passez la souris sur pour zoomer",
"FlyoutZoomView.TIP_BUBBLE_TAP":"Appuyez et maintenez pour agrandir"
},
defaultLocale:"en"
}
上記の例では、localization オブジェクトは 2 つのロケール("en"
と "fr"
)を定義し、各ロケールで 2 つのユーザーインターフェイス要素のローカライゼーションを提供します。
Web ページのコードは、ローカリゼーションオブジェクトを、設定オブジェクトの localizedTexts
フィールドの値として、ビューアコンストラクターに渡す必要があります。 別のオプションとして、setLocalizedTexts(localizationInfo)
メソッドを呼び出してローカリゼーションオブジェクトを渡すこともできます。
次の記号がサポートされています。