輪播檢視器顯示的某些內容會受本地化規範。 此內容包括幻燈片導航按鈕。
檢視器中可本地化的每個文字內容,都會以稱為SYMBOL的特殊檢視器SDK識別碼表示。 任何SYMBOL都具有隨現成可用查看器提供的英語語言環境("en"
)的預設關聯文本值,並且還可以根據需要設定任意數量的語言環境的用戶定義值。
當查看器啟動時,它將檢查當前區域設定,以查看此區域設定的每個支援的SYMBOL是否有用戶定義的值。 若有,則使用使用者定義的值;否則,會回復為現成預設文字。
使用者定義的本地化資料可以以本地化JSON物件的形式傳遞至檢視器。 此類對象包含支援的語言環境清單、每個語言環境的SYMBOL文本值以及預設語言環境。
以下是此類本地化物件的範例:
{
"en":{
"PanLeftButton.TOOLTIP":"Left",
"PanRightButton.TOOLTIP":"Right"
},
"fr":{
"PanLeftButton.TOOLTIP":"Gauchiste",
"PanRightButton .TOOLTIP":"Droit"
},
defaultLocale:"en"
}
在上例中,本地化對象定義了兩個區域設定("en"
和"fr"
),並為每個區域設定中的兩個用戶介面元素提供本地化。
網頁代碼應將本地化對象作為配置對象的localizedTexts
欄位的值傳遞給查看器建構子。 替代選項是呼叫setLocalizedTexts(localizationInfo)
方法以傳遞本地化物件。
支援下列SYMBOL:
符號 |
工具提示…… |
---|---|
PlayPauseButton.TOOLTIP_SELECTED |
已選擇播放暫停按鈕狀態。 |
PlayPauseButton.TOOLTIP_UNSELECTED |
未選擇的播放暫停按鈕狀態。 |
CAROUSELVIEWER_TOOLTIP_GOTO |
前一個和下一個幻燈片按鈕的工具提示和ARIA標籤。 接受兩個取代代號: $CURRENT_FRAME$ 表示當前幻燈片索引, $TOTAL_FRAMES$ 表示幻燈片總數。 |
容器.LABEL |
頂層檢視器元素的ARIA標籤。 |
輪播檢視.ROLE_DESCRIPTION |
主要檢視元件的ARIA角色說明。 |
CarouselView.USAGE_HINT |
鍵盤用戶的ARIA使用提示。 |