「基本縮放檢視器」顯示的某些內容會受本地化限制,包括縮放按鈕和全螢幕按鈕。
檢視器中可本地化的每個文字內容,都會以稱為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標籤。 |
ZoomView.ROLE_DESCRIPTION |
主視圖元件的ARIA角色說明。 |
ZoomView.USAGE_HINT |
ARIA使用提示給鍵盤使用者。 |
CloseButton.TOOLTIP |
關閉按鈕。 |
ZoomInButton.TOOLTIP |
放大按鈕。 |
ZoomOutButton.TOOLTIP |
縮小按鈕。 |
ZoomResetButton.TOOLTIP |
縮放重設按鈕。 |
FullScreenButton.TOOLTIP_SELECTED |
全螢幕按鈕處於正常狀態。 |
FullScreenButton.TOOLTIP_UNSELECTED |
全螢幕按鈕,全螢幕狀態。 |