Lokalisierung der Elemente der Benutzeroberfläche

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äßigen zugeordneten Textwert für ein englisches Gebietsschema ( "en"), das mit dem vordefinierten Viewer bereitgestellt wird, und kann auch benutzerdefinierte Werte für beliebig viele Gebietsschemas enthalten.

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

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 Gebietsschemata ( "en" und "fr") und stellt die Lokalisierung für zwei Benutzeroberflächenelemente 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:

SYMBOL

QuickInfo für ...

PlayPauseButton.TOOLTIP_SELECTED

Status der ausgewählten Wiedergabe-Pause-Schaltfläche

PlayPauseButton.TOOLTIP_UNSELECTED

Status der Schaltfläche "Pause abspielen" deaktiviert.

CAROUSELVIEWER_TOOLTIP_GOTO

QuickInfo und ARIA-Beschriftung für die Schaltflächen der vorherigen und nächsten Folie.

Akzeptiert zwei Ersatz-Token: $CURRENT_FRAME$ für den aktuellen Folienindex und $TOTAL_FRAMES$ für die Gesamtzahl der Folien.

Container.LABEL

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

CarouselView.ROLE_DESCRIPTION

ARIA-Rollenbeschreibung für die Hauptansichtskomponente.

CarouselView.USAGE_HINT

ARIA-Verwendungshinweise für Tastaturbenutzer.

Auf dieser Seite