混在メディアビューアで表示されるコンテンツには、ローカライゼーションの対象となるものもあります。 例えば、ズームボタン、スピンボタン、ビデオコントロール、閉じるボタン、フルスクリーンボタン、スウォッチスクロールボタンなどです。
ローカライズ可能なビューア内のテキストコンテンツは、すべてSYMBOLと呼ばれる特別なビューアSDK識別子で表されます。 すべてのシンボルに、標準搭載のビューアに付属の英語ロケール("en"
)に対応するデフォルトのテキスト値があります。 また、必要な数のロケールに対してユーザー定義の値を設定することもできます。
ビューアの開始は、現在のロケールをチェックし、ロケールでサポートされている各シンボルにユーザ定義の値があるかどうかを確認します。 存在する場合は、ユーザー定義の値が使用されます。それ以外の場合は、そのまま使用できるデフォルトのテキストに戻ります。
ユーザ定義のローカライゼーションデータは、ローカライゼーションJSONオブジェクトとしてビューアに渡すことができます。 このオブジェクトには、サポートされるロケールのリスト、各ロケールのシンボルテキスト値、およびデフォルトロケールが含まれます。
このようなローカライゼーションオブジェクトの例を次に示します。
{
"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ラベル。 |
ZoomView.ROLE_DESCRIPTION |
メイン表示コンポーネントのARIAロールの説明です。 |
ZoomView.USAGE_HINT |
ARIAキーボードユーザー向けの使用上のヒントです。 |
SpinView.ROLE_DESCRIPTION |
メイン表示コンポーネントのARIAロールの説明です。 |
SpinView.USAGE_HINT |
ARIAキーボードユーザー向けの使用上のヒントです。 |
FlyoutZoomView.ROLE_DESCRIPTION |
メイン表示コンポーネントのARIAロールの説明です。 |
FlyoutZoomView.USAGE_HINT |
ARIAキーボードユーザー向けの使用上のヒントです。 |
CloseButton.TOOLTIP |
閉じるボタン。 |
ZoomInButton.TOOLTIP |
ズームインボタン。 |
ZoomOutButton.TOOLTIP |
ズームアウトボタン。 |
ZoomResetButton.TOOLTIP |
ズームリセットボタン |
FlyoutZoomView.TIP_BUBBLE_OVER |
インラインズームモードのデスクトップシステム。 |
FlyoutZoomView.TIP_BUBBLE_TAP |
インラインズームモードのタッチデバイス |
FullScreenButton.TOOLTIP_SELECTED |
通常の状態でのフルスクリーンボタン。 |
FullScreenButton.TOOLTIP_UNSELECTED |
フルスクリーン状態でのフルスクリーンボタン。 |
ClosedCaptionButton.TOOLTIP_SELECTED |
クローズドキャプションボタンが選択された状態。 |
ClosedCaptionButton.TOOLTIP_UNSELECTED |
クローズドキャプションボタンが選択されていない状態。 |
ScrollLeftButton.TOOLTIP |
左スクロールボタン。 |
ScrollRightButton.TOOLTIP |
右スクロールボタン。 |
ScrollUpButton.TOOLTIP |
上スクロールボタン。 |
ScrollDownButton.TOOLTIP |
下スクロールボタン。 |
PanLeftButton.TOOLTIP |
左スピンボタン。 |
PanRightButton.TOOLTIP |
右へスピンボタン。 |
PlayPauseButton.TOOLTIP_SELECTED |
再生/一時停止ボタンが選択された状態。 |
PlayPauseButton.TOOLTIP_UNSELECTED |
再生/一時停止ボタンが選択解除された状態。 |
PlayPauseButton.TOOLTIP_REPLAY |
再生/一時停止ボタンの状態。 |
VideoScrubber.TOOLTIP |
ビデオスクラバー。 |
VideoTime.TOOLTIP |
コントロールバーのビデオ時間。 |
MutableVolume.TOOLTIP_SELECTED |
ミュート可能ボリュームが選択された状態。 |
MutableVolume.TOOLTIP_UNSELECTED |
ミュート可能ボリュームが選択解除されました。 |
MutableVolume.TOOLTIP_VOLUME |
ARIA aria-valuetext 属性で公開されたボリュームスライダノブのラベル。 |
VideoPlayer.ERROR |
再生可能なビデオがない場合に表示されるエラーメッセージ。 |