「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 |
已本地化的訊息,會在搜尋成功完成時顯示,並至少傳回一個結果。 此符號支援下列執行階段取代代號:
|
SearchPanel.THUMBNAIL_LABEL |
搜索面板的結果縮圖的本地化標籤。 此符號支援下列執行階段取代代號:
|
SearchPanel.LABEL |
定義整個搜索面板的 aria-label ARIA屬性的值。 |