用戶介面元素的本地化

eCatalog檢視器顯示的某些內容會受當地語系化限制，包括縮放按鈕、頁面變更按鈕、縮圖按鈕、全螢幕按鈕、關閉按鈕和捲軸按鈕。

檢視器中可本地化的每個文字內容，都會以稱為SYMBOL的特殊檢視器SDK識別碼來表示。 任何SYMBOL都有隨附於現成可用檢視器的英文地區設定("en")的預設相關文字值，也可視需要設定使用者定義的值。

當檢視器啟動時，會檢查目前的地區設定，以查看地區設定中每個支援的SYMBOL是否有使用者定義的值。 若有，則使用使用者定義的值；否則，它會回到預設的預設文字。

使用者定義的本地化資料可以作為本地化JSON物件傳遞至檢視器。 此類對象包含支援的語言環境清單、每個語言環境的SYMBOL文本值以及預設語言環境。

此類本地化對象的示例：

{ 
"en":{ 
"CloseButton.TOOLTIP":"Close", 
"ZoomInButton.TOOLTIP":"Zoom In" 
 }, 
 "fr":{ 
"CloseButton.TOOLTIP":"Fermer", 
"ZoomInButton.TOOLTIP":"Agrandir" 
}, 
defaultLocale:"en" 
}

在上述範例中，本地化物件會定義兩個地區設定（"en"和"fr"），並為每個地區設定中的兩個使用者介面元素提供本地化。

網頁代碼應將此類本地化對象作為配置對象的localizedTexts欄位的值傳遞給查看器建構子。 另一個選項是通過調用setLocalizedTexts(localizationInfo)方法來傳遞本地化對象。

支援下列SYMBOL（假設containerId是檢視器容器的ID）:

符號

工具提示……

容器。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_ADDRESSS

電子郵件地址錯誤時顯示的錯誤消息。

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頁」選項按鈕的標題。

PRINT.PAGE_HANDLING_TWO

「每頁2頁」選項按鈕的標題。

PRINT.CANCEL

「取消」按鈕的標題。

PRINT.TOOLTIP_CANCEL

取消按鈕。

Print.ACTION

「傳送至列印」按鈕的標題

Print.TOOLTIP_ACTION

傳送至列印按鈕。

FavoritesMenu.TOOLTIP

「我的最愛」功能表按鈕。

AddFavoriteButton.TOOLTIP_SELECTED

「新增我的最愛」按鈕（在編輯我的最愛模式中）。

AddFavoriteButton.TOOLTIP_UNSELECTED

「新增我的最愛」按鈕。

RemoveFavoriteButton.TOOLTIP_SELECTED

「移除我的最愛」按鈕（在編輯我的最愛模式中）。

RemoveFavoriteButton.TOOLTIP_UNSELECTED

「移除我的最愛」按鈕。

ViewAllFavoriteButton.TOOLTIP_SELECTED

當「我的最愛」檢視處於作用中時，「檢視所有我的最愛」按鈕。

ViewAllFavoriteButton.TOOLTIP_UNSELECTED

當「我的最愛」檢視處於非作用中時，「檢視所有我的最愛」按鈕。

FavoritesEffect.TOOLTIP

單一最愛的圖示。

MediaSet.LABEL_XX[_YY]

檢視器在載入時產生的頁面標籤。

該符號的名稱是模板，其中 XX 是橫向零基的跨頁索引，可選 YY 是 XX 所定位跨頁中的零基頁索引。

僅適用於初始載入的資產；若使用 setAsset() API呼叫變更資產，則忽略該資產。

MediaSet.LABEL_DELIM

在跨頁中為左頁和右頁定義標籤時，用作頁面標籤分隔符的字元。

ScrollLeftRightButton.TOOLTIP_SELECTED

主控條向左滾動按鈕。

ScrollLeftRightButton.TOOLTIP_UNSELECTED

主控條向右滾動按鈕。

SearchPanel.PLACEHOLDER

在用戶開始輸入搜索文本之前，本地化提示顯示在搜索輸入框中。

SearchPanel.INFO_PROMPT

首次開啟搜尋面板時顯示的本地化訊息，建議使用者執行搜尋。

SearchPanel.INFO_NO_RESULTS

當搜尋未傳回任何結果時顯示的本地化訊息。

此符號支援下列執行時期取代Token: $SEARCH_TEXT$ 。 元件會以使用者輸入的搜尋文字來取代它。

SearchPanel.INFO_RESULTS

成功完成搜尋並返回至少一個結果時顯示的本地化訊息。

此符號支援下列執行時期取代Token:

  • $SEARCH_TEXT$ -用戶輸入的搜索文本。
  • $HIT_COUNT$ -找到的搜尋點擊總數。
  • $PAGE_COUNT$ -包含至少一次搜尋點擊的目錄頁數。

SearchPanel.THUMBNAIL_LABEL

搜尋面板結果縮圖的本地化標籤。

此符號支援下列執行時期取代Token:

  • $PAGE$ -頁碼。
  • $PAGE_HIT_COUNT$ -頁面上找到的搜尋結果數。

SearchPanel.LABEL

為整個搜索面板定義 aria-label ARIA屬性的值。

本頁內容