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

フライアウトビューアに表示される特定のコンテンツは、ローカライズの対象となります。 このコンテンツには、ユーザーインターフェイス要素のツールヒントと、読み込み時にフライアウトズームビューで表示される情報メッセージが含まれています。

ローカライズ可能なビューア内のすべてのテキストコンテンツは、SYMBOLと呼ばれる特別なビューアSDK IDで表されます。 任意のSYMBOLには、標準ビューアで指定された英語ロケール ("en")のデフォルトの関連テキスト値が含まれており、必要に応じてユーザー定義の値が設定されている場合もあります。

ビューアが起動すると、現在のロケールをチェックして、そのようなロケールでサポートされている各SYMBOLにユーザー定義の値があるかどうかを確認します。 存在する場合は、ユーザー定義の値を使用します。それ以外の場合は、デフォルトのデフォルトのテキストにフォールバックします。

ユーザー定義のローカライゼーションデータは、ローカライゼーション JSON オブジェクトとしてビューアに渡すことができます。 このオブジェクトには、サポートされているロケールのリスト、各ロケールのSYMBOL テキスト値、およびデフォルトのロケールが含まれます。

そのようなローカライゼーションオブジェクトの例を以下に示します。

{
"en":{
"FlyoutZoomView.TIP_BUBBLE_OVER":"Mouse over to zoom",
"FlyoutZoomView.TIP_BUBBLE_TAP":"Tap and hold to zoom"
 },
 "fr":{
"FlyoutZoomView.TIP_BUBBLE_OVER":"Passez la souris sur pour zoomer",
"FlyoutZoomView.TIP_BUBBLE_TAP":"Appuyez et maintenez pour agrandir"
},
defaultLocale:"en"
}

上記の例では、ローカライゼーションオブジェクトは2つのロケール("en""fr")を定義し、各ロケールの2つのユーザーインターフェイス要素にローカライゼーションを提供します。

Web ページのコードは、このようなローカライゼーションオブジェクトを、設定オブジェクトのlocalizedTexts フィールドの値としてビューアコンストラクターに渡す必要があります。 別のオプションとして、setLocalizedTexts(localizationInfo) メソッドを呼び出してローカライゼーションオブジェクトを渡すこともできます。

次のシンボルがサポートされています。

シンボル
説明
Container.LABEL
最上位ビューア要素のARIA ラベル。
FlyoutZoomView.ROLE_DESCRIPTION
メインビューコンポーネントのARIA ロールの説明。
FlyoutZoomView.USAGE_HINT
キーボードユーザーのARIA使用ヒント。
FlyoutZoomView.TIP_BUBBLE_OVER
デスクトップシステムの情報メッセージ。
FlyoutZoomView.TIP_BUBBLE_TAP
タッチデバイス向けの情報メッセージ。
ScrollLeftButton.TOOLTIP
左スクロール ボタンのツールヒント。
ScrollRightButton.TOOLTIP
右スクロール ボタンのツールヒント。
ScrollUpButton.TOOLTIP
スクロールアップボタンのツールヒント。
ScrollDownButton.TOOLTIP
スクロールダウンボタンのツールヒント。
recommendation-more-help
dynamic-media-developer-resources-help-aem-viewers-ref