Alcuni contenuti visualizzati in Basic Zoom Viewer (Visualizzatore zoom di base) sono soggetti alla localizzazione, inclusi i pulsanti di zoom e un pulsante a schermo intero.
Ogni contenuto testuale nel visualizzatore che può essere localizzato è rappresentato da uno speciale identificatore SDK del visualizzatore chiamato SYMBOL. Qualsiasi simbolo ha un valore di testo associato di default per la lingua inglese ( "en"
) fornito con il visualizzatore predefinito e può anche avere valori definiti dall’utente impostati per tutte le impostazioni internazionali necessarie.
All'avvio, il visualizzatore controlla le impostazioni locali correnti per verificare se è presente un valore definito dall'utente per ciascun SIMBOLO supportato nelle impostazioni locali. In caso affermativo, viene utilizzato il valore definito dall’utente; in caso contrario, viene utilizzato il testo predefinito.
I dati di localizzazione definiti dall’utente possono essere trasmessi al visualizzatore come oggetto JSON di localizzazione. Tale oggetto contiene l'elenco delle impostazioni locali supportate, i valori di testo SYMBOL per ciascuna impostazione locale e le impostazioni locali 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 per due elementi dell’interfaccia utente in ciascuna lingua.
Il codice della pagina web deve trasmettere tale oggetto di localizzazione al costruttore del visualizzatore come valore di localizedTexts
dell'oggetto di configurazione. In alternativa, è possibile passare l’oggetto di localizzazione chiamando setLocalizedTexts(localizationInfo)
metodo.
Sono supportati i seguenti SIMBOLI:
SIMBOLO |
Descrizione comando per... |
---|---|
Container.LABEL |
Etichetta ARIA per l’elemento visualizzatore di primo livello. |
ZoomView.ROLE_DESCRIPTION |
Descrizione del ruolo ARIA del componente della vista principale. |
ZoomView.USAGE_HINT |
Suggerimenti per l’utilizzo di ARIA per gli utenti che utilizzano la tastiera. |
CloseButton.TOOLTIP |
Pulsante Chiudi. |
ZoomInButton.TOOLTIP |
Pulsante Zoom in. |
ZoomOutButton.TOOLTIP |
Pulsante Zoom out. |
ZoomResetButton.TOOLTIP |
Pulsante di ripristino zoom. |
FullScreenButton.TOOLTIP_SELECTED |
pulsante a schermo intero in stato normale. |
FullScreenButton.TOOLTIP_UNSELECTED |
pulsante di visualizzazione a schermo intero. |