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

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

ビューア内のテキスト内容は、ローカライズ可能ですべて、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)メソッドを呼び出してローカライゼーションオブジェクトを渡す方法があります。

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

シンボル

ツールチップ

Container.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

右へスピンボタン。

このページ