Lokalisierung der Elemente der Benutzeroberfläche localization-of-user-interface-elements
Bestimmte Inhalte, die der einfache Zoom-Viewer anzeigt, können lokalisiert werden, einschließlich Zoom-Schaltflächen und einer Vollbildschaltfläche.
Jeder Textinhalt im Viewer, der lokalisiert werden kann, wird durch eine spezielle Viewer-SDK-ID namens SYMBOL dargestellt. Jede SYMBOL hat einen standardmäßigen Textwert für das englische Gebietsschema ( "en"
), die mit dem vordefinierten Viewer bereitgestellt werden, und möglicherweise auch benutzerdefinierte Werte für beliebig viele Gebietsschemas festgelegt sind.
Beim Starten des Viewers wird das aktuelle Gebietsschema überprüft, um festzustellen, ob für jede unterstützte SYMBOL im Gebietsschema ein benutzerdefinierter Wert vorhanden ist. Ist dies der Fall, wird der benutzerdefinierte Wert verwendet. Andernfalls wird der vordefinierte Standardtext verwendet.
Benutzerdefinierte Lokalisierungsdaten können als lokalisiertes JSON-Objekt an den Viewer übergeben werden. Ein solches Objekt enthält die Liste der unterstützten Gebietsschemas, die SYMBOL-Textwerte für jedes Gebietsschema und das Standardgebietsschema.
Ein Beispiel für ein solches Lokalisierungsobjekt:
{
"en":{
"CloseButton.TOOLTIP":"Close",
"ZoomInButton.TOOLTIP":"Zoom In"
},
"fr":{
"CloseButton.TOOLTIP":"Fermer",
"ZoomInButton.TOOLTIP":"Agrandir"
},
defaultLocale:"en"
}
Im obigen Beispiel definiert das Lokalisierungsobjekt zwei Gebietsschemata ( "en"
und "fr"
) und bietet Lokalisierung für zwei Elemente der Benutzeroberfläche in jedem Gebietsschema.
Der Webseitencode sollte dieses Lokalisierungsobjekt an den Viewer-Konstruktor als Wert von localizedTexts
-Feld des Konfigurationsobjekts. Eine alternative Option besteht darin, das Lokalisierungsobjekt durch Aufruf von setLocalizedTexts(localizationInfo)
-Methode.
Die folgenden SYMBOLs werden unterstützt: