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

フライアウトビューアで表示されるコンテンツには、ローカライゼーションの対象となるものもあります。 このようなコンテンツには、ユーザインターフェイス要素のツールチップや、読み込み時にフライアウトズーム表示によって表示される情報メッセージなどがあります。

ローカライズ可能なビューア内のテキストコンテンツは、すべてSYMBOLと呼ばれる特別なビューアSDK識別子で表されます。 すべてのシンボルには、標準搭載のビューアに付属の英語ロケール("en")に対するデフォルトの関連テキスト値があり、また、必要な数のロケールに対してユーザ定義値を設定できます。

ビューアの開始は、現在のロケールをチェックして、そのロケールでサポートされている各シンボルに対してユーザ定義値があるかどうかを確認します。 存在する場合は、ユーザー定義の値が使用されます。それ以外の場合は、そのまま使用できるデフォルトのテキストに戻ります。

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

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

{ 
"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)メソッドを呼び出してローカライゼーションオブジェクトを渡すこともできます。

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

シンボル

説明

コンテナ.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

下スクロールボタンに関するツールチップ。

このページ

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free