フライアウトビューアに表示されるコンテンツには、ローカリゼーションの対象となるものもあります。 このコンテンツには、ユーザインターフェイス要素のツールチップや、読み込み時にフライアウトズームビューで表示される情報メッセージなどが含まれます。
ビューア内のテキスト内のローカライズ可能な内容は、SYMBOL と呼ばれる、特別な Viewer SDK 識別子で表されます。 SYMBOL には、英語のロケール ( "en"
) が標準のビューアに付属しており、必要に応じてロケールのユーザ定義値も設定されている場合があります。
ビューアが起動すると、現在のロケールがチェックされ、そのロケールでサポートされる各シンボルに対してユーザ定義の値が存在するかどうかが確認されます。 ある場合は、ユーザー定義の値を使用します。それ以外の場合は、標準のデフォルトテキストにフォールバックされます。
ユーザ定義のローカリゼーションデータは、ローカライゼーション 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"
}
上記の例では、ローカリゼーションオブジェクトで 2 つのロケール ( "en"
および "fr"
) を参照し、各ロケールで 2 つのユーザーインターフェイス要素のローカライゼーションを提供します。
Web ページコードでは、このようなローカリゼーションオブジェクトを localizedTexts
設定オブジェクトのフィールド。 別のオプションとして、 setLocalizedTexts(localizationInfo)
メソッド。
次のシンボルがサポートされています。
記号 |
説明 |
---|---|
Container.LABEL |
トップレベルのビューア要素の ARIA ラベル。 |
FlyoutZoomView.ROLE_DESCRIPTION |
メインビューコンポーネントの ARIA ロールの説明。 |
FlyoutZoomView.USAGE_HINT |
ARIA キーボードユーザー向けの使用ヒント。 |
FlyoutZoomView.TIP_BUBBLE_OVER |
デスクトップシステムに関する情報メッセージ。 |
FlyoutZoomView.TIP_BUBBLE_TAP |
タッチデバイスに関する情報メッセージ。 |
ScrollLeftButton.TOOLTIP |
左スクロールボタンのツールチップ。 |
ScrollRightButton.TOOLTIP |
右スクロールボタンのツールチップ。 |
ScrollUpButton.TOOLTIP |
上スクロールボタンのツールチップ。 |
ScrollDownButton.TOOLTIP |
下スクロールボタンに関するツールチップ。 |