ユーザーインターフェイス要素のローカライゼーション localization-of-user-interface-elements

混在メディアビューアに表示されるコンテンツには、ローカリゼーションの対象となるものもあります。 このガイドラインには、ズームボタン、スピンボタン、ビデオコントロール、閉じるボタン、フルスクリーンボタンおよびスウォッチのスクロールボタンが含まれます。

ビューア内のテキスト内のローカライズ可能なコンテンツは、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
再生できるビデオがない場合に表示されるエラーメッセージ。
recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8