Lokalisierung von Elementen der Benutzeroberfläche

Letzte Aktualisierung: 31. Dezember 2024
  • Themen:

Erstellt für:

  • Entwickler
  • Benutzende

Bestimmte Inhalte, die der grundlegende Zoom-Viewer anzeigt, unterliegen der Lokalisierung, einschließlich Zoom-Schaltflächen und einer Vollbildschaltfläche.

Jeder Textinhalt im Viewer, der lokalisiert werden kann, wird durch eine spezielle Viewer-SDK-Kennung namens SYMBOL dargestellt. Jedes SYMBOL verfügt über einen standardmäßigen Textwert für das englische Gebietsschema ( "en"), der mit dem standardmäßigen Viewer bereitgestellt wird, und kann auch benutzerdefinierte Werte für beliebig viele Gebietsschemata festlegen.

Beim Starten des Viewers wird das aktuelle Gebietsschema überprüft, um festzustellen, ob für jedes unterstützte SYMBOL im Gebietsschema ein benutzerdefinierter Wert vorhanden ist. Ist dies der Fall, wird der benutzerdefinierte Wert verwendet, andernfalls wird der Standardtext verwendet.

Benutzerdefinierte Lokalisierungsdaten können als JSON-Objekt für die Lokalisierung an den Viewer übergeben werden. Ein solches Objekt enthält die Liste der unterstützten Gebietsschemata, 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 Localization-Objekt zwei Gebietsschemata ("en" und "fr") und stellt die Lokalisierung für zwei Elemente der Benutzeroberfläche in jedem Gebietsschema bereit.

Der Web-Seiten-Code sollte dieses Lokalisierungsobjekt an den Viewer-Konstruktor als Wert localizedTexts Felds des Konfigurationsobjekts übergeben. Eine alternative Option besteht darin, das Lokalisierungsobjekt durch Aufruf setLocalizedTexts(localizationInfo) -Methode zu übergeben.

Die folgenden SYMBOLE werden unterstützt:

SYMBOLQuickInfo für die…
.LABEL-ARIA-Beschriftung für das Viewer-Element der obersten Ebene.
ZoomView.ROLE_DESCRIPTIONARIA-Rollenbeschreibung für die Hauptansichtskomponente.
ZoomView.USAGE_HINTARIA-Nutzungshinweise für Tastaturbenutzer.
closeButton.TOOLTIP-Schließen-Schaltfläche.
ZoomInButton.TOOLTIPSchaltfläche „Vergrößern“.
ZoomOutButton.TOOLTIPSchaltfläche „Verkleinern“.
ZoomResetButton.TOOLTIP-Zurücksetzen-Schaltfläche für Zoom.
fullScreenButton.TOOLTIP_SELECTEDVollbildschaltfläche im normalen Zustand.
fullScreenButton.TOOLTIP_UNSELECTEDVollbildschaltfläche im Vollbildmodus.
Vorherige SeiteUnterstützung der Hilfstechnologien
Nächste SeiteVollbildunterstützung

Experience Manager