Alcuni contenuti visualizzati dal Visualizzatore zoom di base sono soggetti a localizzazione, compresi i pulsanti zoom e un pulsante a schermo intero.
Ogni contenuto testuale nel visualizzatore che può essere localizzato è rappresentato da uno speciale identificatore SDK del visualizzatore denominato SYMBOL. A qualsiasi SYMBOL è associato un valore di testo predefinito per le impostazioni internazionali inglesi ( "en"
) fornita con il visualizzatore preconfigurato e potrebbe anche avere valori definiti dall’utente impostati per tutte le impostazioni internazionali necessarie.
All’avvio del visualizzatore, controlla le impostazioni internazionali correnti per vedere se esiste un valore definito dall’utente per ogni SYMBOL supportato nelle impostazioni internazionali. In caso affermativo, utilizza il valore definito dall’utente; in caso contrario, torna al testo predefinito preconfigurato.
I dati di localizzazione definiti dall'utente possono essere trasmessi al visualizzatore come oggetto JSON di localizzazione. Tale oggetto contiene l'elenco delle impostazioni internazionali supportate, i valori di testo SYMBOL per ciascuna impostazione internazionale e le impostazioni internazionali predefinite.
Un esempio di tale oggetto di localizzazione:
{
"en":{
"CloseButton.TOOLTIP":"Close",
"ZoomInButton.TOOLTIP":"Zoom In"
},
"fr":{
"CloseButton.TOOLTIP":"Fermer",
"ZoomInButton.TOOLTIP":"Agrandir"
},
defaultLocale:"en"
}
Nell’esempio precedente, l’oggetto di localizzazione definisce due impostazioni internazionali ( "en"
e "fr"
) e fornisce la localizzazione di due elementi dell’interfaccia utente in ciascuna impostazione internazionale.
Il codice della pagina web deve trasmettere tale oggetto di localizzazione al costruttore del visualizzatore come valore di localizedTexts
campo dell'oggetto di configurazione. Un'opzione alternativa consiste nel passare l'oggetto di localizzazione chiamando setLocalizedTexts(localizationInfo)
metodo .
Sono supportati i seguenti SYMBOL:
SIMBOLO |
Descrizione comandi per... |
---|---|
Container.LABEL |
Etichetta ARIA per l’elemento visualizzatore di livello principale. |
ZoomView.ROLE_DESCRIPTION |
Descrizione del ruolo ARIA per il componente visualizzazione principale. |
ZoomView.USAGE_HINT |
Suggerimenti per l’utilizzo di ARIA per gli utenti di tastiera. |
CloseButton.TOOLTIP |
Pulsante Chiudi. |
ZoomInButton.TOOLTIP |
Pulsante Zoom in. |
ZoomOutButton.TOOLTIP |
Pulsante Zoom indietro. |
ZoomResetButton.TOOLTIP |
Pulsante di ripristino dello zoom. |
FullScreenButton.TOOLTIP_SELECTED |
Pulsante a schermo intero in stato normale. |
FullScreenButton.TOOLTIP_UNSELECTED |
Pulsante a schermo intero a schermo intero. |