Localizzazione degli elementi dell’interfaccia utente

Alcuni contenuti visualizzati dal Visualizzatore immagini interattivo sono soggetti a localizzazione. Questo contenuto include le descrizioni comandi degli elementi dell’interfaccia utente e un messaggio informativo visualizzato dalla visualizzazione a comparsa al momento del caricamento.

Ogni contenuto testuale nel visualizzatore che può essere localizzato è rappresentato dallo speciale identificatore SDK del visualizzatore denominato SYMBOL. A qualsiasi SYMBOL è associato un valore di testo predefinito per le impostazioni internazionali inglesi ( "en") fornito con il visualizzatore predefinito e possono essere impostati valori definiti dall’utente 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 per tali 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 è il seguente:

{ 
"en":{ 
"Container.LABEL":"Interactive Image Viewer" 
 }, 
 "fr":{ 
"Container.LABEL":"Visionneuse d'images interactive" 
}, 
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 passare l’oggetto di localizzazione al costruttore del visualizzatore, come valore del campo localizedTexts dell’oggetto di configurazione. Un'opzione alternativa consiste nel passare l'oggetto di localizzazione chiamando il metodo setLocalizedTexts(localizationInfo) .

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.

In questa pagina