使用者介面元素的本地化

「轉盤檢視器」顯示的某些內容必須經過本地化。 此內容包含幻燈片導覽按鈕。

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

未選取的播放暫停按鈕狀態。

CAROUSELEVIEWER_TOOLTIP_GOTO

上一張和下一張投影片按鈕的工具提示和ARIA標籤。

接受兩個取代Token: $CURRENT_FRAME$ 目前投影片索引和 $TOTAL_FRAMES$ 以取得投影片總數。

Container.LABEL

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

CarouselView.ROLE_DESCRIPTION

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

CarouselView.USAGE_HINT

鍵盤使用者的ARIA使用提示。

本頁內容