カルーセルビューアに表示されるコンテンツには、ローカライゼーションの対象となるものもあります。 例えば、スライドナビゲーションボタンがあります。
ローカライズ可能なビューア内のテキストコンテンツは、すべてSYMBOLと呼ばれる特別なビューアSDK識別子で表されます。 すべてのシンボルには、標準搭載のビューアに付属の英語ロケール("en"
)に対するデフォルトの関連テキスト値があり、また、必要な数のロケールに対してユーザ定義値を設定できます。
ビューアの開始は、現在のロケールをチェックして、そのロケールでサポートされている各シンボルに対してユーザ定義値があるかどうかを確認します。 存在する場合は、ユーザー定義の値が使用されます。それ以外の場合は、そのまま使用できるデフォルトのテキストに戻ります。
ユーザ定義のローカライゼーションデータは、ローカライゼーションJSONオブジェクトとしてビューアに渡すことができます。 このオブジェクトには、サポートされるロケールのリスト、各ロケールのシンボルテキスト値、およびデフォルトロケールが含まれます。
このようなローカライゼーションオブジェクトの例を次に示します。
{
"en":{
"PanLeftButton.TOOLTIP":"Left",
"PanRightButton.TOOLTIP":"Right"
},
"fr":{
"PanLeftButton.TOOLTIP":"Gauchiste",
"PanRightButton .TOOLTIP":"Droit"
},
defaultLocale:"en"
}
上の例では、ローカライゼーションオブジェクトは2つのロケール("en"
と"fr"
)を定義し、各ロケールの2つのユーザーインターフェイス要素にローカライゼーションを提供します。
Webページコードは、設定オブジェクトのlocalizedTexts
フィールドの値として、ローカライゼーションオブジェクトをビューアのコンストラクターに渡す必要があります。 別の方法として、setLocalizedTexts(localizationInfo)
メソッドを呼び出してローカライゼーションオブジェクトを渡すこともできます。
次のシンボルがサポートされています。
シンボル |
ツールチップの対象 |
---|---|
PlayPauseButton.TOOLTIP_SELECTED |
再生/一時停止ボタンが選択された状態。 |
PlayPauseButton.TOOLTIP_UNSELECTED |
再生/一時停止ボタンが選択されていなかった状態。 |
CAROUSELVIEWER_TOOLTIP_GOTO |
前のスライドボタンと次のスライドボタンのツールチップとARIAラベル。 次の2つの置換トークンを受け入れます。現在のスライドインデックスの場合は$CURRENT_FRAME$ 、スライドの総数の場合は $TOTAL_FRAMES$ です。 |
コンテナ.LABEL |
最上位レベルのビューア要素のARIAラベル。 |
CarouselView.ROLE_DESCRIPTION |
メイン表示コンポーネントのARIAロールの説明です。 |
CarouselView.USAGE_HINT |
ARIAキーボードユーザー向けの使用上のヒントです。 |