Lokalisierung der Elemente der Benutzeroberfläche

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. Jedes SYMBOL verfügt über einen standardmäßig zugewiesenen Textwert für das englische Gebietsschema ( "en"), das mit dem vordefinierten Viewer bereitgestellt wird. Außerdem können benutzerdefinierte Werte für beliebig viele Gebietsschemas festgelegt werden.

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 auf den vordefinierten Standardtext zurückgegriffen.

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 stellt die Lokalisierung für zwei Benutzeroberflächenelemente in jedem Gebietsschema bereit.

Der Webseitencode sollte dieses 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:

SYMBOL

QuickInfo für ...

Container.LABEL

ARIA-Beschriftung für das Viewer-Element der obersten Ebene.

ZoomView.ROLE_DESCRIPTION

ARIA-Rollenbeschreibung für die Hauptansichtskomponente.

ZoomView.USAGE_HINT

ARIA-Verwendungshinweise für Tastaturbenutzer.

CloseButton.TOOLTIP

Schaltfläche "Schließen".

ZoomInButton.TOOLTIP

Schaltfläche "Vergrößern"

ZoomOutButton.TOOLTIP

Schaltfläche "Verkleinern"

ZoomResetButton.TOOLTIP

Schaltfläche zum Zurücksetzen des Zooms

FullScreenButton.TOOLTIP_SELECTED

Schaltfläche im Vollbildmodus im Normalzustand.

FullScreenButton.TOOLTIP_UNSELECTED

Schaltfläche im Vollbildmodus im Vollbildmodus.

Auf dieser Seite