用戶介面元素本地化

「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

「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

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

此符號支援下列執行階段取代代號： $SEARCH_TEXT$ 。 元件會以使用者輸入的搜尋文字來取代元件。

SearchPanel.INFO_RESULTS

已本地化的訊息，會在搜尋成功完成時顯示，並至少傳回一個結果。

此符號支援下列執行階段取代代號：

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

SearchPanel.THUMBNAIL_LABEL

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

此符號支援下列執行階段取代代號：

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

SearchPanel.LABEL

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

本頁內容