Lokalisierung der Elemente der Benutzeroberfläche localization-of-user-interface-elements
Bestimmte Inhalte, die der Karussell-Viewer anzeigt, können lokalisiert werden. Dieser Inhalt enthält Schaltflächen für die Objektnavigation.
Jeder Textinhalt im Viewer, der lokalisiert werden kann, wird durch die spezielle Viewer-SDK-Kennung SYMBOL dargestellt. Jedes SYMBOL verfügt über einen standardmäßig zugeordneten Textwert für ein englisches Gebietsschema ( "en"
), das mit dem vordefinierten Viewer bereitgestellt wird. Außerdem können benutzerdefinierte Werte für beliebig viele Gebietsschemata festgelegt werden.
Beim Starten des Viewers wird das aktuelle Gebietsschema überprüft, um festzustellen, ob für jedes unterstützte SYMBOL für dieses 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. Dieses 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 ist:
{
"en":{
"PanLeftButton.TOOLTIP":"Left",
"PanRightButton.TOOLTIP":"Right"
},
"fr":{
"PanLeftButton.TOOLTIP":"Gauchiste",
"PanRightButton .TOOLTIP":"Droit"
},
defaultLocale:"en"
}
Im obigen Beispiel definiert das Lokalisierungsobjekt zwei Gebietsschemas ( "en"
und "fr"
) und stellt die Lokalisierung von zwei Benutzeroberflächenelementen in jedem Gebietsschema bereit.
Der Webseitencode sollte das Lokalisierungsobjekt als Wert des Felds localizedTexts
des Konfigurationsobjekts an den Viewer-Konstruktor übergeben. Eine alternative Option besteht darin, das Lokalisierungsobjekt durch Aufruf der Methode setLocalizedTexts(localizationInfo)
weiterzugeben.
Die folgenden SYMBOLs werden unterstützt:
QuickInfo und ARIA-Beschriftung für die Schaltflächen der vorherigen und nächsten Folie.
Akzeptiert zwei Ersetzungstoken: $CURRENT_FRAME$ für den aktuellen Folienindex und $TOTAL_FRAMES$ für die Gesamtzahl der Folien.