用戶介面元素本地化

「回轉檢視器」顯示的某些內容可能會受到本地化的影響,包括縮放按鈕和全螢幕按鈕。

檢視器中可本地化的每個文字內容,都會以稱為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:

符號

工具提示……

容器.LABEL

頂層檢視器元素的ARIA標籤。

回轉視圖。角色_描述

主要檢視元件的ARIA角色說明。

回轉視圖.USAGE_HINT

鍵盤用戶的ARIA使用提示。

CloseButton.TOOLTIP

關閉按鈕。

ZoomInButton.TOOLTIP

放大按鈕。

ZoomOutButton.TOOLTIP

縮小按鈕。

ZoomResetButton.TOOLTIP

縮放重設按鈕。

FullScreenButton.TOOLTIP_SELECTED

全螢幕按鈕處於正常狀態。

FullScreenButton.TOOLTIP_UNSELECTED

全螢幕狀態的全螢幕按鈕。

PanLeftButton.TOOLTIP

左轉按鈕。

PanRightButton.TOOLTIP

右轉按鈕。

本頁內容