使用者介面元素的本地化

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：

  • $SEARCH_TEXT$ — 使用者輸入的搜尋文字。
  • $HIT_COUNT$ — 找到的搜尋點選總數。
  • $PAGE_COUNT$ — 至少包含一次搜尋點選的目錄頁數。

SearchPanel.THUMBNAIL_LABEL

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

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

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

SearchPanel.LABEL

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

本頁內容