Lokalisierung von Elementen der Benutzeroberfläche
Erstellt für:
- Entwickler
- Benutzende
Bestimmte Inhalte, die der E-Katalog-Viewer anzeigt, unterliegen der Lokalisierung, einschließlich Zoom-Schaltflächen, Seitenänderungs-Schaltflächen, Miniatur-Schaltflächen, Vollbild-Schaltflächen, Schließen-Schaltflächen und Schaltflächen für Bildlaufleisten.
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 (unter der Annahme, dass containerId die ID des Viewer-Containers ist):
SYMBOL | QuickInfo für… |
---|---|
.LABEL- | ARIA-Beschriftung für das Viewer-Element der obersten Ebene. |
PageView.ROLE_DESCRIPTION | ARIA-Rollenbeschreibung für die Hauptansichtskomponente. |
PageView.USAGE_HINT- | ARIA-Nutzungshinweise für Tastaturbenutzer. |
closeButton.TOOLTIP- | Schließen-Schaltfläche. |
ZoomInButton.TOOLTIP | Schaltfläche „Vergrößern“. |
ZoomOutButton.TOOLTIP | Schaltfläche „Verkleinern“. |
ZoomResetButton.TOOLTIP- | Zurücksetzen-Schaltfläche für Zoom. |
fullScreenButton.TOOLTIP_SELECTED | Vollbildschaltfläche im normalen Zustand. |
fullScreenButton.TOOLTIP_UNSELECTED | Vollbildschaltfläche im Vollbildmodus. |
ScrollUpButton.TOOLTIP | Scroll up button. |
ScrollDownButton.TOOLTIP | Scroll down button. |
<containerId>_rightButton.PanRightButton.TOOLTIP- | Große Schaltfläche für nächste Seite. |
<containerId>_leftButton.PanLeftButton.TOOLTIP | Schaltfläche „Große vorherige Seite“. |
<containerId>_lastPageButton.PanRightButton.TOOLTIP- | Schaltfläche „Letzte Seite“ |
<containerId>_secondaryLastPageButton.PanRightButton.TOOLTIP- | Schaltfläche „Letzte Seite“ |
<containerId>_firstPageButton.PanLeftButton.TOOLTIP | Schaltfläche „Erste Seite“. |
<containerId>_secondaryFirstPageButton.PanLeftButton.TOOLTIP- | Schaltfläche „Erste Seite“. |
<containerId>_toolBarRightButton.PanRightButton.TOOLTIP- | Schaltfläche „Nächste Seite“ |
<containerId>_toolBarLeftButton.PanLeftButton.TOOLTIP | Schaltfläche „Vorherige Seite“. |
ThumbnailPageButton.TOOLTIP_SELECTED | Schaltfläche „Miniaturen“ im Miniaturbildmodus. |
ThumbnailPageButton.TOOLTIP_UNSELECTED | Schaltfläche „Miniaturansichten“ im normalen Modus. |
closeButton.TOOLTIP- | Schließen-Schaltfläche. |
InfoPanelPopup.TOOLTIP_CLOSE | Schaltfläche zum Schließen des Infobereichs. |
SocialShare.TOOLTIP | Social-Sharing-Tool. |
EmailShare.TOOLTIP | Schaltfläche „E-Mail-Freigabe“ |
EmailShare.HEADER- | Kopfzeile des E-Mail-Dialogfelds |
EmailShare.TOOLTIP_HEADER_CLOSE | E-Mail-Dialogfeld rechts oben Schaltfläche zum Schließen. |
EmailShare.INVALID_ADDRESS | Fehlermeldung, wenn die E-Mail-Adresse fehlerhaft ist. |
EmailShare.TO | Beschriftung für das Eingabefeld „An“. |
EmailShare.TOOLTIP_ADD | Schaltfläche Weitere E-Mail-Adresse hinzufügen . |
EmailShare.ADD | Schaltfläche Weitere E-Mail-Adresse hinzufügen . |
EmailShare.FROM | Aus dem Eingabefeld. |
EmailShare.MESSAGE | Eingabefeld für Nachrichten |
EmailShare.TOOLTIP_REMOVE | Schaltfläche E-Mail-Adresse entfernen. |
EmailShare. ABBRECHEN | Beschriftung für die Schaltfläche Abbrechen . |
EmailShare.TOOLTIP_CANCEL | Schaltfläche Abbrechen. |
EmbedShare.ACTION- | Beschriftung für die Schaltfläche Alle auswählen. |
EmbedShare.TOOLTIP_ACTION | Alle auswählen. |
EmailShare.CLOSE | Beschriftung für die Schaltfläche „Schließen“, die am unteren Rand des Dialogfelds nach der Formularübermittlung angezeigt wird. |
EmailShare.TOOLTIP_CLOSE | Schaltfläche „Schließen“, die unten im Dialogfeld nach der Formularübermittlung angezeigt wird. |
EmailShare.ACTION | Beschriftung für die Formularübermittlungsschaltfläche. |
EmailShare.TOOLTIP_ACTION | Schaltfläche „Formularübermittlung“. |
EmailShare.SEND_SUCCESS- | Bestätigungsmeldung, die angezeigt wurde, als die E-Mail erfolgreich gesendet wurde. |
EmailShare.SEND_FAILURE | Fehlermeldung, die angezeigt wird, wenn die E-Mail nicht erfolgreich gesendet wurde. |
EmbedShare.TOOLTIP | Freigabe-Schaltfläche einbetten. |
EmbedShare.HEADER- | Dialogfeldkopfzeile einbetten. |
EmbedShare.TOOLTIP_HEADER_CLOSE | Dialogfeld „Einbetten“, Schließen-Schaltfläche oben rechts. |
EmbedShare.DESCRIPTION | Beschreibung des Einbettungs-Code-Texts. |
EmbedShare.EMBED_SIZE | Beschriftung für das Kombinationsfeld „Einbettungsgröße“. |
EmbedShare.CANCEL- | Beschriftung für die Schaltfläche Abbrechen . |
EmbedShare.TOOLTIP_CANCEL | Schaltfläche Abbrechen. |
EmbedShare.CUSTOM_SIZE | Text für den letzten Eintrag für „Benutzerdefinierte Größe“ im Kombinationsfeld Einbettungsgröße . |
LinkShare.TOOLTIP- | Schaltfläche „Link-Freigabe“. |
LinkShare.HEADER- | Dialogfeld-Kopfzeile verknüpfen. |
LinkShare.TOOLTIP_HEADER_CLOSE | Dialogfeld „Verknüpfung“, Schaltfläche zum Schließen oben rechts. |
LinkShare.DESCRIPTION | Beschreibung des Freigabe-Links. |
LinkShare.CANCEL | Beschriftung für die Schaltfläche Abbrechen . |
LinkShare.TOOLTIP_CANCEL | Schaltfläche Abbrechen. |
LinkShare.ACTION- | Beschriftung für die Schaltfläche Alle auswählen. |
LinkShare.TOOLTIP_ACTION | Alle auswählen. |
FacebookShare.TOOLTIP | Facebook-Freigabeschaltfläche. |
TwitterShare.TOOLTIP | Twitter Freigabe-Schaltfläche. |
Print.TOOLTIP- | Schaltfläche „Drucken“. |
.HEADER- | Kopfzeile des Dialogfelds drucken. |
print.TOOLTIP_HEADER_CLOSE | Dialogfeld „Drucken“, Schaltfläche zum Schließen oben rechts. |
print.PRINT_RANGE | Titel des Abschnitts „Druckseiten auswählen“. |
PRINT.PRINT_RANGE_CURRENT | Beschriftung für das Optionsfeld „Aktuelle Seiten“. |
print.PRINT_RANGE_FROM | Beschriftung für das Optionsfeld „Bereich ausdehnen von“. |
PRINT.PRINT_RANGE_TO | Beschriftung für die numerische Auswahl „An“. |
print.PRINT_RANGE_ALL | Beschriftung für das Optionsfeld „Alle Seiten“. |
PRINT.PAGE_HANDLING- | Beschriftung für den Abschnitt „Seitenbearbeitung“. |
PRINT.PAGE_HANDLING_ONE | Beschriftung für das Optionsfeld „1 Seite pro Blatt“. |
PRINT.PAGE_HANDLING_TWO | Beschriftung für das Optionsfeld „2 Seiten pro Blatt“. |
. ABBRECHEN | Beschriftung für die Schaltfläche Abbrechen . |
print.TOOLTIP_CANCEL | Schaltfläche Abbrechen. |
Print.ACTION- | Beschriftung für die Schaltfläche „An Druck senden“ |
print.TOOLTIP_ACTION- | Schaltfläche „An Druck senden“. |
FavoritesMenu.TOOLTIP | Favoriten-Menüschaltfläche. |
AddFavoriteButton.TOOLTIP_SELECTED | Schaltfläche „Favorit hinzufügen“ im Modus „Favoriten bearbeiten“. |
AddFavoriteButton.TOOLTIP_UNSELECTED | Schaltfläche „Favorit hinzufügen“ im normalen Modus. |
RemoveFavoriteButton.TOOLTIP_SELECTED | Schaltfläche „Favorit entfernen“ im Modus „Favoriten bearbeiten“. |
RemoveFavoriteButton.TOOLTIP_UNSELECTED | Schaltfläche „Favorit entfernen“ im normalen Modus. |
ViewAllFavoriteButton.TOOLTIP_SELECTED | Schaltfläche „Alle Favoriten anzeigen“, wenn die Favoritenansicht aktiv ist. |
ViewAllFavoriteButton.TOOLTIP_UNSELECTED | Schaltfläche „Alle Favoriten anzeigen“, wenn die Favoritenansicht inaktiv ist. |
FavoritesEffect.TOOLTIP | Symbol für einzelne Favoriten. |
MediaSet.LABEL_XX[_YY] |
Seitentitel, die vom Viewer zum Zeitpunkt des Ladens generiert wird. Der Name dieses Symbols ist eine Vorlage, bei der XX ein Spreizindex auf der Querformat-Ausrichtung ist und optional YY ein Seitenindex auf der Basis Null innerhalb des Spreizindex ist, auf den XX abzielt. Gilt nur für das ursprünglich geladene Asset. Wird ignoriert, wenn ein Asset mithilfe des API-Aufrufs setAsset() geändert wird. |
MediaSet.LABEL_DELIM- | Zeichen, das als Trennzeichen für Seitenbeschriftungen verwendet wird, wenn Beschriftungen für linke und rechte Seiten innerhalb eines Spreads definiert sind. |
ScrollLeftRightButton.TOOLTIP_SELECTED | Hauptsteuerleiste Scrollen Sie nach links. |
ScrollLeftRightButton.TOOLTIP_UNSELECTED | Hauptsteuerleiste rechts scrollen. |