ローカライズ
Reveal SDK はローカリゼーションの強力なサポートを提供し、多様な世界市場にわたってその多用途性と魅力を強化します。わかりやすく包括的なローカリゼーション フレームワークより、開発者はアプリケーションをさまざまな言語にシームレスに適応させることができます。
現在のローカリゼーション ロケールは、デフォルトではユーザーのブラウザーによって自動的に決定されます。ただし、文字列のローカライズを有効にするには、SDK 自体のロケールを設定する必要があります。この手順では、内部文字列の表示言語をカスタマイズできます。SDK は次のロケールをサポートします: de
、es
、fr
、it
、ja
、ko
、ms
、nl
、pt
、ru
、zh- cn
、zh-tw
。このリストは、$.ig.SupportedLocales
プロパティを調べることで参照できます。
ロケールを設定するには、メソッド $.ig.RevealSdkSettings.overrideLocale
を使用し、前述のリストから目的のロケールをパラメーターとして渡します。ロケールを再度オーバーライドする前に、promise を待つことが重要です。問題を回避するには、必ずこの順序に従ってください。
$.ig.RevealSdkSettings.overrideLocale('ja').then(_ => {
...
})
すべての内部テキストが日本語に変更されるはずです。
その後、可視化のタイトルや列名などの文字列のローカライズを開始する準備が整います。
カスタム翻訳を提供するには、クライアントに $.ig.RevealSdkSettings.localizedStringsProvider
イベントのハンドラーを追加する必要があります。このイベントは RVLocalizationElement
と RVLocalizationContext
を受け取り、ローカライズされた文字列を返す必要があります。
$.ig.RevealSdkSettings.localizedStringsProvider = function (element, context) {
...
return localizedString;
};
ここでは、あらゆる入力文字列に対してローカライズされた文字列 test
を一貫して返すイベント ハンドラーを追加してみます。
$.ig.RevealSdkSettings.localizedStringsProvider = function (element, context) {
return "test";
};
追加後、ダッシュボードは次のように表示されます。
もう少し詳しく見てみましょう。 すべてに対して test
を返すのではなく、視覚化フィールド ラベルに対してのみ test
を返すようにしましょう。
$.ig.RevealSdkSettings.localizedStringsProvider = function (element, context) {
if (element.elementType === $.ig.RVLocalizationElementType.VisualizationFieldLabel) {
return "test";
}
return element.title ?? element.name;
};