ユーザーインターフェイス要素のローカライズ localization-of-user-interface-elements
基本ズームビューアに表示される特定のコンテンツは、ズームボタンや全画面ボタンなど、ローカライゼーションの対象となります。
ローカライズ可能なビューア内のすべてのテキストコンテンツは、SYMBOLと呼ばれる特別なビューアSDK IDで表されます。 任意の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) メソッドを呼び出してローカライゼーションオブジェクトを渡すこともできます。
次のシンボルがサポートされています。