用戶介面元素本地化

彈出檢視器顯示的某些內容可能會受到本地化規範。 此內容包括用戶介面元素工具提示和資訊消息,這些消息由載入時彈出縮放視圖顯示。

檢視器中可本地化的每個文字內容,都會以稱為SYMBOL的特殊檢視器SDK識別碼表示。 任何SYMBOL都具有英語地區( "en")隨現成可用的檢視器提供。 也可以根據需要設定用戶定義的值。

當查看器啟動時,它將檢查當前區域設定,以查看該區域設定的每個支援的SYMBOL是否有用戶定義的值。 若有,則使用使用者定義的值;否則,會回復為現成預設文字。

使用者定義的本地化資料可以以本地化JSON物件的形式傳遞至檢視器。 此類對象包含支援的語言環境清單、每個語言環境的SYMBOL文本值以及預設語言環境。

以下是此類本地化物件的範例:

{
"en":{
"FlyoutZoomView.TIP_BUBBLE_OVER":"Mouse over to zoom",
"FlyoutZoomView.TIP_BUBBLE_TAP":"Tap and hold to zoom"
 },
 "fr":{
"FlyoutZoomView.TIP_BUBBLE_OVER":"Passez la souris sur pour zoomer",
"FlyoutZoomView.TIP_BUBBLE_TAP":"Appuyez et maintenez pour agrandir"
},
defaultLocale:"en"
}

在上例中,本地化物件定義兩個地區設定( "en""fr"),並提供每個地區設定中兩個使用者介面元素的本地化。

網頁程式碼應將本地化物件傳遞至檢視器建構函式,作為 localizedTexts 配置對象的欄位。 替代選項是呼叫 setLocalizedTexts(localizationInfo) 方法。

支援下列SYMBOL:

符號

說明

容器.LABEL

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

FlyoutZoomView.ROLE_DESCRIPTION

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

FlyoutZoomView.USAGE_HINT

鍵盤用戶的ARIA使用提示。

FlyoutZoomView.TIP_BUBBLE_OVER

案頭系統的資訊消息。

FlyoutZoomView.TIP_BUBBLE_TAP

觸控裝置的資訊訊息。

ScrollLeftButton.TOOLTIP

向左滾動按鈕的工具提示。

ScrollRightButton.TOOLTIP

滾動右鍵的工具提示。

ScrollUpButton.TOOLTIP

向上捲動按鈕的工具提示。

ScrollDownButton.TOOLTIP

向下捲動按鈕的工具提示。

本頁內容