Lokalisatie van gebruikersinterface-elementen localization-of-user-interface-elements
Bepaalde inhoud die in de viewer voor draaien wordt weergegeven, is afhankelijk van lokalisatie, inclusief zoomknoppen en een knop voor volledig scherm.
Elke tekstinhoud in de viewer die kan worden gelokaliseerd, wordt vertegenwoordigd door een speciale Viewer SDK-id met de naam SYMBOL. Elk SYMBOL heeft een aan de standaardwaarde gekoppelde tekstwaarde voor de landinstelling Engels ( "en"
) die wordt geleverd bij de viewer buiten de box. Er kunnen ook door de gebruiker gedefinieerde waarden worden ingesteld voor zoveel landinstellingen als nodig zijn.
Wanneer de viewer wordt gestart, wordt de huidige landinstelling gecontroleerd om te zien of er een door de gebruiker gedefinieerde waarde is voor elk ondersteund SYMBOL voor de landinstelling. Als dat het geval is, gebruikt het de user-defined waarde; anders, valt het terug naar de uit-van-de-doos standaardtekst.
Door de gebruiker gedefinieerde lokalisatiegegevens kunnen als JSON-lokalisatieobject worden doorgegeven aan de viewer. Dit object bevat een lijst met ondersteunde landinstellingen, de tekstwaarden SYMBOL voor elke landinstelling en de standaardlandinstelling.
Een voorbeeld van een dergelijk lokalisatieobject is het volgende:
{
"en":{
"CloseButton.TOOLTIP":"Close",
"ZoomInButton.TOOLTIP":"Zoom In"
},
"fr":{
"CloseButton.TOOLTIP":"Fermer",
"ZoomInButton.TOOLTIP":"Agrandir"
},
defaultLocale:"en"
}
In het bovenstaande voorbeeld definieert het lokalisatieobject twee landinstellingen ( "en"
en "fr"
) en biedt het lokalisatie voor twee gebruikersinterface-elementen in elke landinstelling.
De webpaginacode moet het lokalisatieobject doorgeven aan de viewerconstructor als een waarde van het localizedTexts
-veld van het configuratieobject. Een andere optie is het doorgeven van het lokalisatieobject door de methode setLocalizedTexts(localizationInfo)
aan te roepen.
De volgende SYMBOL's worden ondersteund: