Lokalisierung von Elementen der Benutzeroberfläche

Letzte Aktualisierung: 19. Dezember 2024
  • Themen:

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):

SYMBOLQuickInfo für…
.LABEL-ARIA-Beschriftung für das Viewer-Element der obersten Ebene.
PageView.ROLE_DESCRIPTIONARIA-Rollenbeschreibung für die Hauptansichtskomponente.
PageView.USAGE_HINT-ARIA-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.
ScrollUpButton.TOOLTIPScroll up button.
ScrollDownButton.TOOLTIPScroll down button.
<containerId>_rightButton.PanRightButton.TOOLTIP-Große Schaltfläche für nächste Seite.
<containerId>_leftButton.PanLeftButton.TOOLTIPSchaltfläche „Große vorherige Seite“.
<containerId>_lastPageButton.PanRightButton.TOOLTIP-Schaltfläche „Letzte Seite“
<containerId>_secondaryLastPageButton.PanRightButton.TOOLTIP-Schaltfläche „Letzte Seite“
<containerId>_firstPageButton.PanLeftButton.TOOLTIPSchaltfläche „Erste Seite“.
<containerId>_secondaryFirstPageButton.PanLeftButton.TOOLTIP-Schaltfläche „Erste Seite“.
<containerId>_toolBarRightButton.PanRightButton.TOOLTIP-Schaltfläche „Nächste Seite“
<containerId>_toolBarLeftButton.PanLeftButton.TOOLTIPSchaltfläche „Vorherige Seite“.
ThumbnailPageButton.TOOLTIP_SELECTEDSchaltfläche „Miniaturen“ im Miniaturbildmodus.
ThumbnailPageButton.TOOLTIP_UNSELECTEDSchaltfläche „Miniaturansichten“ im normalen Modus.
closeButton.TOOLTIP-Schließen-Schaltfläche.
InfoPanelPopup.TOOLTIP_CLOSESchaltfläche zum Schließen des Infobereichs.
SocialShare.TOOLTIPSocial-Sharing-Tool.
EmailShare.TOOLTIPSchaltfläche „E-Mail-Freigabe“
EmailShare.HEADER-Kopfzeile des E-Mail-Dialogfelds
EmailShare.TOOLTIP_HEADER_CLOSEE-Mail-Dialogfeld rechts oben Schaltfläche zum Schließen.
EmailShare.INVALID_ADDRESSFehlermeldung, wenn die E-Mail-Adresse fehlerhaft ist.
EmailShare.TOBeschriftung für das Eingabefeld „An“.
EmailShare.TOOLTIP_ADDSchaltfläche Weitere E-Mail-Adresse hinzufügen .
EmailShare.ADDSchaltfläche Weitere E-Mail-Adresse hinzufügen .
EmailShare.FROMAus dem Eingabefeld.
EmailShare.MESSAGEEingabefeld für Nachrichten
EmailShare.TOOLTIP_REMOVESchaltfläche E-Mail-Adresse entfernen.
EmailShare. ABBRECHENBeschriftung für die Schaltfläche Abbrechen .
EmailShare.TOOLTIP_CANCELSchaltfläche Abbrechen.
EmbedShare.ACTION-Beschriftung für die Schaltfläche Alle auswählen.
EmbedShare.TOOLTIP_ACTIONAlle auswählen.
EmailShare.CLOSEBeschriftung für die Schaltfläche „Schließen“, die am unteren Rand des Dialogfelds nach der Formularübermittlung angezeigt wird.
EmailShare.TOOLTIP_CLOSESchaltfläche „Schließen“, die unten im Dialogfeld nach der Formularübermittlung angezeigt wird.
EmailShare.ACTIONBeschriftung für die Formularübermittlungsschaltfläche.
EmailShare.TOOLTIP_ACTIONSchaltfläche „Formularübermittlung“.
EmailShare.SEND_SUCCESS-Bestätigungsmeldung, die angezeigt wurde, als die E-Mail erfolgreich gesendet wurde.
EmailShare.SEND_FAILUREFehlermeldung, die angezeigt wird, wenn die E-Mail nicht erfolgreich gesendet wurde.
EmbedShare.TOOLTIPFreigabe-Schaltfläche einbetten.
EmbedShare.HEADER-Dialogfeldkopfzeile einbetten.
EmbedShare.TOOLTIP_HEADER_CLOSEDialogfeld „Einbetten“, Schließen-Schaltfläche oben rechts.
EmbedShare.DESCRIPTIONBeschreibung des Einbettungs-Code-Texts.
EmbedShare.EMBED_SIZEBeschriftung für das Kombinationsfeld „Einbettungsgröße“.
EmbedShare.CANCEL-Beschriftung für die Schaltfläche Abbrechen .
EmbedShare.TOOLTIP_CANCELSchaltfläche Abbrechen.
EmbedShare.CUSTOM_SIZEText 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_CLOSEDialogfeld „Verknüpfung“, Schaltfläche zum Schließen oben rechts.
LinkShare.DESCRIPTIONBeschreibung des Freigabe-Links.
LinkShare.CANCELBeschriftung für die Schaltfläche Abbrechen .
LinkShare.TOOLTIP_CANCELSchaltfläche Abbrechen.
LinkShare.ACTION-Beschriftung für die Schaltfläche Alle auswählen.
LinkShare.TOOLTIP_ACTIONAlle auswählen.
FacebookShare.TOOLTIPFacebook-Freigabeschaltfläche.
TwitterShare.TOOLTIPTwitter Freigabe-Schaltfläche.
Print.TOOLTIP-Schaltfläche „Drucken“.
.HEADER-Kopfzeile des Dialogfelds drucken.
print.TOOLTIP_HEADER_CLOSEDialogfeld „Drucken“, Schaltfläche zum Schließen oben rechts.
print.PRINT_RANGETitel des Abschnitts „Druckseiten auswählen“.
PRINT.PRINT_RANGE_CURRENTBeschriftung für das Optionsfeld „Aktuelle Seiten“.
print.PRINT_RANGE_FROMBeschriftung für das Optionsfeld „Bereich ausdehnen von“.
PRINT.PRINT_RANGE_TOBeschriftung für die numerische Auswahl „An“.
print.PRINT_RANGE_ALLBeschriftung für das Optionsfeld „Alle Seiten“.
PRINT.PAGE_HANDLING-Beschriftung für den Abschnitt „Seitenbearbeitung“.
PRINT.PAGE_HANDLING_ONEBeschriftung für das Optionsfeld „1 Seite pro Blatt“.
PRINT.PAGE_HANDLING_TWOBeschriftung für das Optionsfeld „2 Seiten pro Blatt“.
. ABBRECHENBeschriftung für die Schaltfläche Abbrechen .
print.TOOLTIP_CANCELSchaltfläche Abbrechen.
Print.ACTION-Beschriftung für die Schaltfläche „An Druck senden“
print.TOOLTIP_ACTION-Schaltfläche „An Druck senden“.
FavoritesMenu.TOOLTIPFavoriten-Menüschaltfläche.
AddFavoriteButton.TOOLTIP_SELECTEDSchaltfläche „Favorit hinzufügen“ im Modus „Favoriten bearbeiten“.
AddFavoriteButton.TOOLTIP_UNSELECTEDSchaltfläche „Favorit hinzufügen“ im normalen Modus.
RemoveFavoriteButton.TOOLTIP_SELECTEDSchaltfläche „Favorit entfernen“ im Modus „Favoriten bearbeiten“.
RemoveFavoriteButton.TOOLTIP_UNSELECTEDSchaltfläche „Favorit entfernen“ im normalen Modus.
ViewAllFavoriteButton.TOOLTIP_SELECTEDSchaltfläche „Alle Favoriten anzeigen“, wenn die Favoritenansicht aktiv ist.
ViewAllFavoriteButton.TOOLTIP_UNSELECTEDSchaltfläche „Alle Favoriten anzeigen“, wenn die Favoritenansicht inaktiv ist.
FavoritesEffect.TOOLTIPSymbol 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_SELECTEDHauptsteuerleiste Scrollen Sie nach links.
ScrollLeftRightButton.TOOLTIP_UNSELECTEDHauptsteuerleiste rechts scrollen.

Experience Manager