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

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

開發人員
使用者

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