Basic Zoom 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:
符號 |
工具提示…… |
---|---|
Container.LABEL |
頂層檢視器元素的ARIA標籤。 |
ZoomView.ROLE_DESCRIPTION |
主要檢視元件的ARIA角色說明。 |
ZoomView.USAGE_HINT |
鍵盤使用者的ARIA使用提示。 |
CloseButton.TOOLTIP |
關閉按鈕。 |
ZoomInButton.TOOLTIP |
放大顯示按鈕。 |
ZoomOutButton.TOOLTIP |
縮小顯示按鈕。 |
ZoomResetButton.TOOLTIP |
縮放重設按鈕。 |
FullScreenButton.TOOLTIP_SELECTED |
正常狀態下的全熒幕按鈕。 |
FullScreenButton.TOOLTIP_UNSELECTED |
全熒幕狀態的全熒幕按鈕。 |