ドキュメントDynamic Media ビューアリファレンスガイド

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

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • 開発者
  • ユーザー

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"
}

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

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

次のシンボルがサポートされています（containerId がビューアコンテナの ID である場合）。

記号
ツールヒント：
Container.LABEL
最上位のビューア要素の ARIA ラベル。
.ROLE_DESCRIPTION
メインビューコンポーネントの ARIA 役割の説明。
.USAGE_HINT
キーボードユーザー向けの ARIA 使用ヒント。
.TOOLTIP
「閉じる」ボタン。
.TOOLTIP
「ズームイン」ボタン。
.TOOLTIP
ズームアウトボタン。
.TOOLTIP
ズームリセットボタン。
.TOOLTIP_SELECTED
全画面表示ボタンが通常の状態。
.TOOLTIP_UNSELECTED
フルスクリーン状態のフルスクリーンボタン。
.TOOLTIP
スクロールアップボタン。
.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
前のページボタン。
.TOOLTIP_SELECTED
サムネールモードの「サムネール」ボタン。
.TOOLTIP_UNSELECTED
通常モードのサムネールボタン。
.TOOLTIP
「閉じる」ボタン。
.TOOLTIP_CLOSE
情報パネルの「閉じる」ボタン。
.TOOLTIP
ソーシャル共有ツール。
.TOOLTIP
メール共有ボタン。
EmailShare.HEADER
メールダイアログヘッダー。
EmailShare.TOOLTIP_HEADER_CLOSE
メールダイアログボックスの右上の「閉じる」ボタン。
EmailShare.INVALID_ADDRESSES
メールアドレスの形式が正しくない場合に表示されるエラーメッセージ。
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 を します
「共有を埋め込む」ボタン。
.HEADER
埋め込みダイアログボックスのヘッダー。
EmbedShare.TOOLTIP_HEADER_CLOSE
埋め込みダイアログボックスの右上の「閉じる」ボタン。
.DESCRIPTION
埋め込みコードテキストの説明。
.EMBED_SIZE
埋め込みサイズ コンボボックスのラベル。
EmbedShare.CANCEL
[ キャンセル ] ボタンのキャプションです。
EmbedShare.TOOLTIP_CANCEL
「キャンセル」ボタン。
EmbedShare.CUSTOM_SIZE を します
埋め込みサイズ コンボボックスの最後の「カスタムサイズ」エントリのテキスト。
.TOOLTIP
リンク共有ボタン。
.HEADER
リンクダイアログボックスのヘッダー。
LinkShare.TOOLTIP_HEADER_CLOSE
リンクダイアログボックスの右上の「閉じる」ボタン。
LinkShare.DESCRIPTION
共有リンクの説明。
LinkShare.CANCEL
[ キャンセル ] ボタンのキャプションです。
LinkShare.TOOLTIP_CANCEL
「キャンセル」ボタン。
LinkShare.ACTION
「すべてを選択」ボタンのキャプション。
.TOOLTIP_ACTION
「すべて選択」ボタンをクリックします。
.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.CANCEL
[ キャンセル ] ボタンのキャプションです。
Print.TOOLTIP_CANCEL
「キャンセル」ボタン。
Print.ACTION
[ 印刷に送信 ] ボタンのキャプション
Print.TOOLTIP_ACTION
「印刷に送信」ボタン。
FavoritesMenu.TOOLTIP
お気に入りメニューボタン。
.TOOLTIP_SELECTED を追加します
お気に入りを編集モードの「お気に入りを追加」ボタン。
AddFavoriteButton.TOOLTIP_UNSELECTED を リックします
通常モードの「お気に入りを追加」ボタン。
.TOOLTIP_SELECTED を削除
お気に入りを編集モードの「お気に入りを削除」ボタン。
RemoveFavoriteButton.TOOLTIP_UNSELECTED を します
通常モードの「お気に入りを削除」ボタン。
.TOOLTIP_SELECTED
お気に入り表示がアクティブな場合は、「すべてのお気に入りを表示」ボタンをクリックします。
.TOOLTIP_UNSELECTED
「お気に入り」ビューが非アクティブの場合は、「すべてのお気に入りを表示」ボタンが表示されます。
FavoritesEffect.TOOLTIP
単一のお気に入りのアイコン。
MediaSet.LABEL_XX[_YY]

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

そのシンボルの名前はテンプレートで、 XX は横向きのゼロベースの拡散インデックスで、オプションの YY は XX のターゲットとなる拡散内のゼロベースのページインデックス す。

最初に読み込まれたアセットにのみ適用されます。 setAsset （） API 呼び出しを使用してアセットが変更された場合は無視されます。

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

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

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

.INFO_RESULTS

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

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

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

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

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

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