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

eCatalog ビューアに表示されるコンテンツには、ズームボタン、ページ変更ボタン、サムネールボタン、フルスクリーンボタン、閉じるボタン、スクロールバーボタンなど、ローカリゼーションの対象となるものもあります。

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

次のシンボルがサポートされています(ここで、 containerId はビューアのコンテナの ID)。

記号
ツールチップの表示…
Container.LABEL
トップレベルのビューア要素の ARIA ラベル。
PageView.ROLE_DESCRIPTION
メインビューコンポーネントの ARIA ロールの説明。
PageView.USAGE_HINT
ARIA キーボードユーザー向けの使用ヒント。
CloseButton.TOOLTIP
「閉じる」ボタン。
ZoomInButton.TOOLTIP
ズームインボタン。
ZoomOutButton.TOOLTIP
ズームアウトボタン。
ZoomResetButton.TOOLTIP
ズームのリセットボタン。
FullScreenButton.TOOLTIP_SELECTED
フルスクリーンボタン(通常の状態)
FullScreenButton.TOOLTIP_UNSELECTED
フルスクリーン状態のフルスクリーンボタン。
ScrollUpButton.TOOLTIP
上にスクロールボタン。
ScrollDownButton.TOOLTIP
下にスクロールボタン。
<containerid>_rightButton.PanRightButton.TOOLTIP
次の大きいページボタン。
<containerid>_leftButton.PanLeftButton.TOOLTIP
前の大きいページボタン。
<containerid>_lastPageButton.PanRightButton.TOOLTIP
最後のページボタン。
<containerid>_secondaryLastPageButton.PanRightButton.TOOLTIP
最後のページボタン。
<containerid>_firstPageButton.PanLeftButton.TOOLTIP
最初のページボタン。
<containerid>_secondaryFirstPageButton.PanLeftButton.TOOLTIP
最初のページボタン。
<containerid>_toolBarRightButton.PanRightButton.TOOLTIP
次のページボタン。
<containerid>_toolBarLeftButton.PanLeftButton.TOOLTIP
「前のページ」ボタン
ThumbnailPageButton.TOOLTIP_SELECTED
サムネールモードのサムネールボタン。
ThumbnailPageButton.TOOLTIP_UNSELECTED
通常モードのサムネールボタン。
CloseButton.TOOLTIP
「閉じる」ボタン。
InfoPanelPopup.TOOLTIP_CLOSE
情報パネルの閉じるボタン。
SocialShare.TOOLTIP
ソーシャル共有ツール。
EmailShare.TOOLTIP
電子メール共有ボタン。
EmailShare.HEADER
電子メールダイアログのヘッダー。
EmailShare.TOOLTIP_HEADER_CLOSE
電子メールダイアログボックスの右上の閉じるボタン。
EmailShare.INVALID_ADDRESSSS
E メールアドレスの形式が正しくない場合に表示されるエラーメッセージ。
EmailShare.TO
「宛先」入力フィールドのラベル。
EmailShare.TOOLTIP_ADD
「別の電子メールアドレスを追加」ボタン。
EmailShare.ADD
「別の電子メールアドレスを追加」ボタン。
EmailShare.FROM
入力フィールドから。
EmailShare.MESSAGE
メッセージ入力フィールド。
EmailShare.TOOLTIP_REMOVE
「電子メールアドレスを削除」ボタン。
EmailShare.CANCEL
「キャンセル」ボタンのキャプション。
EmailShare.TOOLTIP_CANCEL
「キャンセル」ボタン。
EmbedShare.ACTION
「すべて選択」ボタンのキャプション。
EmbedShare.TOOLTIP_ACTION
「すべて選択」ボタン。
EmailShare.CLOSE
フォームの送信後にダイアログの下部に表示される閉じるボタンのキャプション。
EmailShare.TOOLTIP_CLOSE
フォームの送信後にダイアログの下部に表示される閉じるボタン。
EmailShare.ACTION
フォーム送信ボタンのキャプション。
EmailShare.TOOLTIP_ACTION
フォーム送信ボタン。
EmailShare.SEND_SUCCESS
電子メールが正常に送信された際に表示される確認メッセージ。
EmailShare.SEND_FAILURE
電子メールが正常に送信されなかった場合に表示されるエラーメッセージ。
EmbedShare.TOOLTIP
埋め込み共有ボタン。
EmbedShare.HEADER
埋め込みダイアログボックスのヘッダー。
EmbedShare.TOOLTIP_HEADER_CLOSE
埋め込みダイアログボックスの右上の閉じるボタン。
EmbedShare.DESCRIPTION
埋め込みコードテキストの説明。
EmbedShare.EMBED_SIZE
埋め込みサイズコンボボックスのラベル。
EmbedShare.CANCEL
「キャンセル」ボタンのキャプション。
EmbedShare.TOOLTIP_CANCEL
「キャンセル」ボタン。
EmbedShare.CUSTOM_SIZE
埋め込みサイズコンボボックスの最後の「カスタムサイズ」エントリのテキスト。
LinkShare.TOOLTIP
リンク共有ボタン。
LinkShare.HEADER
リンクダイアログボックスのヘッダー。
LinkShare.TOOLTIP_HEADER_CLOSE
リンクダイアログボックスの右上の閉じるボタン。
LinkShare.DESCRIPTION
共有リンクの説明。
LinkShare.CANCEL
「キャンセル」ボタンのキャプション。
LinkShare.TOOLTIP_CANCEL
「キャンセル」ボタン。
LinkShare.ACTION
「すべて選択」ボタンのキャプション。
LinkShare.TOOLTIP_ACTION
「すべて選択」ボタン。
FacebookShare.TOOLTIP
Facebookの共有ボタン
TwitterShare.TOOLTIP
Twitter共有ボタン。
Print.TOOLTIP
印刷ボタン。
Print.HEADER
印刷ダイアログのヘッダー。
Print.TOOLTIP_HEADER_CLOSE
印刷ダイアログボックスの右上の閉じるボタン。
Print.PRINT_RANGE
「印刷ページを選択」セクションのラベル。
PRINT.PRINT_RANGE_CURRENT
「現在のページ」ラジオボタンのキャプション。
Print.PRINT_RANGE_FROM
「次から範囲を拡大」ラジオボタンのキャプション。
Print.PRINT_RANGE_TO
「宛先」数値ピッカーのキャプションです。
Print.PRINT_RANGE_ALL
「すべてのページ」ラジオボタンのキャプション。
PRINT.PAGE_HANDLING
「ページ処理」セクションのラベル。
Print.PAGE_HANDLING_ONE
「1 シートあたり 1 ページ」ラジオボタンのキャプション。
Print.PAGE_HANDLING_TWO
「1 シートあたり 2 ページ」ラジオボタンのキャプション。
印刷。キャンセル
「キャンセル」ボタンのキャプション。
PRINT.TOOLTIP_CANCEL
「キャンセル」ボタン。
Print.ACTION
「印刷に送信」ボタンのキャプション
Print.TOOLTIP_ACTION
「印刷に送信」ボタン。
お気に入りメニュー.TOOLTIP
お気に入りメニューボタン。
AddFavoriteButton.TOOLTIP_SELECTED
[ お気に入りの編集 ] モードの [ お気に入りの追加 ] ボタン
AddFavoriteButton.TOOLTIP_UNSELECTED
通常モードの「お気に入りを追加」ボタン。
RemoveFavoriteButton.TOOLTIP_SELECTED
お気に入りの編集モードの「お気に入りを削除」ボタン
RemoveFavoriteButton.TOOLTIP_UNSELECTED
通常モードの「お気に入りを削除」ボタン。
ViewAllFavoriteButton.TOOLTIP_SELECTED
[ お気に入り ] ビューがアクティブな場合は、[ すべてのお気に入りを表示 ] ボタンをクリックします。
ViewAllFavoriteButton.TOOLTIP_UNSELECTED
[ お気に入り ] ビューが非アクティブな場合は、[ すべてのお気に入りを表示 ] ボタンをクリックします。
FavoritesEffect.TOOLTIP
1 つのお気に入りのアイコン。
MediaSet.LABEL_XX[_YY]

読み込み時にビューアによって生成されるページラベル。

このシンボルの名前はテンプレートで、 XX は、横向きの 0 を基準とする見開きインデックスで、オプションです。 YY は、次の条件を満たす見開き内の 0 を基準とするページインデックスです: XX .

最初に読み込まれたアセットにのみ適用され、 setAsset() API 呼び出し。

MediaSet.LABEL_DELIM
見開きの左右のページにラベルを定義する場合に、ページラベル区切り文字として使用する文字。
ScrollLeftRightButton.TOOLTIP_SELECTED
メインコントロールバーの左スクロールボタン。
ScrollLeftRightButton.TOOLTIP_UNSELECTED
メインコントロールバーの右スクロールボタン。
SearchPanel.PLACEHOLDER
ユーザーが検索テキストを入力する前に検索入力ボックス内に表示されるローカライズされたプロンプト。
SearchPanel.INFO_PROMPT
検索パネルを初めて開いたときに表示されるローカライズされたメッセージで、ユーザーに検索の実行を勧めるメッセージ。
SearchPanel.INFO_NO_RESULTS

検索で結果が返されなかった場合に表示されるローカライズされたメッセージ。

このシンボルは、次のランタイム置換トークンをサポートします。 $SEARCH_TEXT$ . コンポーネントは、ユーザーが入力した検索テキストに置き換えます。

SearchPanel.INFO_RESULTS

検索が正常に完了し、少なくとも 1 つの結果が返された場合に表示されるローカライズされたメッセージ。

このシンボルは、次のランタイム置換トークンをサポートします。

  • $SEARCH_TEXT$ — ユーザーが入力した検索テキスト。
  • $HIT_COUNT$ — 見つかった検索ヒットの合計数。
  • $PAGE_COUNT$ — 少なくとも 1 つの検索ヒットを含むカタログページの数。
SearchPanel.THUMBNAIL_LABEL

検索パネルの結果サムネールのローカライズされたラベル。

このシンボルは、次のランタイム置換トークンをサポートします。

  • $PAGE$ — ページ番号。
  • $PAGE_HIT_COUNT$ — ページで見つかった検索結果の数。
SearchPanel.LABEL
次の値を定義: aria-label ARIA 属性(検索パネル全体)
recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8