eCatalog Viewer顯示的特定內容必須經過本地化,包括縮放按鈕、頁面變更按鈕、縮圖按鈕、全熒幕按鈕、關閉按鈕和卷軸按鈕。
檢視器中可本地化的每個文字內容,都會以稱為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):
符號 |
工具提示…… |
---|---|
Container.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_ADDRESS |
電子郵件地址格式不正確時顯示的錯誤訊息。 |
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 |
傳送至列印按鈕。 |
Favoritemenu.TOOLTIP |
我的最愛功能表按鈕。 |
AddFavoriteButton.TOOLTIP_SELECTED |
「新增我的最愛」按鈕在編輯我的最愛模式。 |
AddFavoriteButton.TOOLTIP_UNSELECTED |
正常模式中的「新增我的最愛」按鈕。 |
RemoveFavoriteButton.TOOLTIP_SELECTED |
「移除我的最愛」按鈕在編輯我的最愛模式。 |
RemoveFavoriteButton.TOOLTIP_UNSELECTED |
正常模式中的「移除我的最愛」按鈕。 |
ViewAllFavoriteButton.TOOLTIP_SELECTED |
當我的最愛檢視處於作用中狀態時,「檢視所有我的最愛」按鈕。 |
ViewAllFavoriteButton.TOOLTIP_UNSELECTED |
當「我的最愛」檢視非使用中時,「檢視所有我的最愛」按鈕。 |
Favoriteeffect.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 |
搜尋成功完成並傳回至少一個結果時顯示的本地化訊息。 此符號支援下列執行階段取代Token:
|
SearchPanel.THUMBNAIL_LABEL |
搜尋面板的結果縮圖本地化標籤。 此符號支援下列執行階段取代Token:
|
SearchPanel.LABEL |
定義 aria-label 整個搜尋面板的ARIA屬性。 |