混在メディアビューアに表示されるコンテンツには、ローカリゼーションの対象となるものもあります。 このガイドラインには、ズームボタン、スピンボタン、ビデオコントロール、閉じるボタン、フルスクリーンボタンおよびスウォッチのスクロールボタンが含まれます。
ビューア内のテキスト内のローカライズ可能なコンテンツは、SYMBOL と呼ばれる、特別な Viewer SDK 識別子で表されます。 SYMBOL には、英語のロケール ( "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 ラベル。 |
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 |
のデスクトップシステム inline ズームモード |
FlyoutZoomView.TIP_BUBBLE_TAP |
のタッチデバイス inline ズームモード |
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 |
再生できるビデオがない場合に表示されるエラーメッセージ。 |