カルーセルビューアに表示されるコンテンツには、ローカリゼーションの対象となるものもあります。 このコンテンツには、スライドナビゲーションボタンが含まれます。
ビューア内のテキスト内容がローカライズ可能な場合は、それぞれ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$ (スライドの合計数)。 |
Container.LABEL |
トップレベルのビューア要素のARIAラベル。 |
CarouselView.ROLE_DESCRIPTION |
メインビューコンポーネントのARIAロールの説明。 |
CarouselView.USAGE_HINT |
ARIAキーボードユーザー用の使用ヒント |