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:
|
SearchPanel.THUMBNAIL_LABEL |
搜尋面板結果縮圖的本地化標籤。 此符號支援下列執行時期取代Token:
|
SearchPanel.LABEL |
為整個搜索面板定義 aria-label ARIA屬性的值。 |