ユーザーインターフェイス要素のローカリゼーション

最終更新日： 2024年7月22日
  • トピック：

作成対象：

  • 開発者
  • ユーザー

Flyout ビューアに表示される特定のコンテンツは、ローカライゼーションの影響を受けます。 このコンテンツには、ロード時にフライアウト ズーム ビューによって表示されるユーザ インタフェース要素のツール ヒントと情報メッセージが含まれます。

ローカライズ可能なビューア内のすべてのテキストコンテンツは、SYMBOL と呼ばれる特別な Viewer SDK 識別子で表されます。 どの 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"
}

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

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

次の記号がサポートされています。

記号説明
Container.LABEL最上位のビューア要素の ARIA ラベル。
.ROLE_DESCRIPTIONメインビューコンポーネントの ARIA 役割の説明。
FlyoutZoomView.USAGE_HINTキーボードユーザー向けの ARIA 使用ヒント。
FlyoutZoomView.TIP_BUBBLE_OVERデスクトップシステムの情報メッセージ。
FlyoutZoomView.TIP_BUBBLE_TAPタッチデバイスの情報メッセージ。
.TOOLTIP左スクロール ボタンのツールヒント。
.TOOLTIP右スクロール ボタンのツールヒント。
.TOOLTIPスクロールアップボタンのツールヒント。
.TOOLTIP下スクロール ボタンのツールヒント。
前のページ支援テクノロジーのサポート
次のページビューア SDK 名前空間

Experience Manager