用戶介面元素的本地化

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屬性的值。