ユーザーインターフェイス要素のローカライゼーション

スピンビューアに表示されるコンテンツには、ズームボタンやフルスクリーンボタンなど、ローカライゼーションの対象となるものもあります。

ローカライズ可能なビューア内のテキストコンテンツは、すべてSYMBOLと呼ばれる特別なビューアSDK識別子で表されます。 すべてのシンボルに、標準搭載のビューアに付属の英語ロケール("en")に対応するデフォルトのテキスト値があります。 また、必要な数のロケールに対してユーザー定義の値を設定することもできます。

ビューアの開始は、現在のロケールをチェックし、ロケールでサポートされている各シンボルにユーザ定義の値があるかどうかを確認します。 存在する場合は、ユーザー定義の値が使用されます。それ以外の場合は、そのまま使用できるデフォルトのテキストに戻ります。

ユーザ定義のローカライゼーションデータは、ローカライゼーションJSONオブジェクトとしてビューアに渡すことができます。 このオブジェクトには、サポートされるロケールのリスト、各ロケールのSYMBOLテキスト値、およびデフォルトロケールが含まれます。

このようなローカライゼーションオブジェクトの例を次に示します。

{ 
"en":{ 
"CloseButton.TOOLTIP":"Close", 
"ZoomInButton.TOOLTIP":"Zoom In" 
 }, 
 "fr":{ 
"CloseButton.TOOLTIP":"Fermer", 
"ZoomInButton.TOOLTIP":"Agrandir" 
}, 
defaultLocale:"en" 
}

上記の例では、ローカライゼーションオブジェクトは2つのロケール("en""fr")を定義し、各ロケールの2つのユーザーインターフェイス要素にローカライゼーションを提供します。

Webページコードは、設定オブジェクトのlocalizedTextsフィールドの値として、ローカライゼーションオブジェクトをビューアのコンストラクターに渡す必要があります。 別の方法として、setLocalizedTexts(localizationInfo)メソッドを呼び出してローカライゼーションオブジェクトを渡すこともできます。

次のシンボルがサポートされています。

シンボル

ツールチップの対象

コンテナ.LABEL

最上位レベルのビューア要素のARIAラベル。

SpinView.ROLE_DESCRIPTION

メイン表示コンポーネントのARIAロールの説明です。

SpinView.USAGE_HINT

ARIAキーボードユーザー向けの使用上のヒントです。

CloseButton.TOOLTIP

閉じるボタン。

ZoomInButton.TOOLTIP

ズームインボタン。

ZoomOutButton.TOOLTIP

ズームアウトボタン。

ZoomResetButton.TOOLTIP

ズームリセットボタン

FullScreenButton.TOOLTIP_SELECTED

通常の状態でのフルスクリーンボタン。

FullScreenButton.TOOLTIP_UNSELECTED

フルスクリーン状態でのフルスクリーンボタン。

PanLeftButton.TOOLTIP

左スピンボタン。

PanRightButton.TOOLTIP

右へスピンボタン。

このページ