Localizzazione degli elementi dell’interfaccia utente

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.

In questa pagina