Lokalisatie van gebruikersinterface-elementen localization-of-user-interface-elements
Bepaalde inhoud die in de Basic Zoom Viewer wordt weergegeven, is afhankelijk van een 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 en kan ook door de gebruiker gedefinieerde waarden hebben ingesteld voor zoveel landinstellingen als nodig.
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 in 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. Een dergelijk object bevat een lijst met ondersteunde landinstellingen, SYMBOL-tekstwaarden voor elke landinstelling en de standaardlandinstelling.
Een voorbeeld van een dergelijk lokalisatieobject:
{
"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 code van de webpagina moet een dergelijk lokalisatieobject doorgeven aan de viewerconstructor als een waarde van het localizedTexts -veld van het configuratieobject. Een andere optie is om het lokalisatieobject door te geven door de methode setLocalizedTexts(localizationInfo) aan te roepen.
De volgende SYMBOL's worden ondersteund: