使用者介面元素的本地化 localization-of-user-interface-elements

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.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屬性值。
recommendation-more-help
b7426f53-aad9-4c00-83fc-664f30f681e8