Mit Java- und JavaScript-APIs können Sie Zeichenfolgen in folgenden Ressourcen internationalisieren:
Einen Überblick über Internationalisierung und Lokalisierung finden Sie unter Internationalisierung von Komponenten.
Die com.day.cq.i18n
Mit dem Java-Paket können Sie lokalisierte Zeichenfolgen in Ihrer Benutzeroberfläche anzeigen. Die I18n
-Klasse stellt die get
-Methode, die lokalisierte Zeichenfolgen aus dem AEM-Wörterbuch abruft. Der einzige erforderliche Parameter der get
-Methode ist das Literal des Zeichenfolgen in englischer Sprache. Englisch ist die standardmäßige Sprache der UI. Im folgenden Beispiel wird das Wort Search
lokalisiert:
i18n.get("Search");
Die Benennung des englischsprachigen Zeichenfolgen unterscheidet sich von herkömmlichen Internationalisierungs-Frameworks, wo die Zeichenfolge über eine ID benannt wird, mit der die Zeichenfolge zur Laufzeit referenziert wird. Die Verwendung des englischen Zeichenfolgenliterals bietet folgende Vorteile:
Es gibt zwei Möglichkeiten, die vom Benutzer bevorzugte Sprache zu bestimmen:
Die Spracheinstellung des Benutzerkontos ist die bevorzugte Methode, da sie zuverlässiger ist. Allerdings muss der Benutzer dafür angemeldet sein.
Die I18n-Klasse stellt zwei Konstruktoren bereit. Der zu verwendende Konstruktor hängt davon ab, wie Sie die bevorzugte Sprache des Benutzers bestimmen.
Um die Zeichenfolge in der Sprache darzustellen, die im Benutzerkonto angegeben ist, verwenden Sie den folgenden Konstruktor (nachdem Sie com.day.cq.i18n.I18n)
importiert haben):
I18n i18n = new I18n(slingRequest);
Der Konstruktor verwendet SlingHTTPRequest
, um die Spracheinstellung des Benutzers abzurufen.
Um das Gebietsschema der Seite zum Festlegen der Sprache zu verwenden, müssen Sie zunächst das ResourceBundle für die Sprache der angeforderten Seite abrufen:
Locale pageLang = currentPage.getLanguage(false);
ResourceBundle resourceBundle = slingRequest.getResourceBundle(pageLang);
I18n i18n = new I18n(resourceBundle);
Verwenden Sie die get
-Methode I18n
-Objekt, um eine Zeichenfolge zu internationalisieren. Der einzige erforderliche Parameter der get
-Methode ist die Zeichenfolge, die internationalisiert werden soll. Die Zeichenfolge entspricht einer Zeichenfolge in einem Übersetzerwörterbuch. Die get-Methode schlägt die Zeichenfolge im Wörterbuch nach und gibt die Übersetzung in der aktuellen Sprache zurück.
Das erste Argument der get
-Methode muss folgende Regeln einhalten:
String
ist nicht zulässig.i18n.get("Enter a search keyword");
Geben Sie den Übersetzungshinweis der internationalisierten Zeichenfolge an, um zwischen mehrfach vorhandenen Zeichenfolgen im Wörterbuch zu unterscheiden. Verwenden Sie den zweiten optionalen Parameter der get
-Methode, um den Übersetzungshinweis bereitzustellen. Der Übersetzungshinweis muss mit der Kommentareigenschaft des Elements im Wörterbuch genau übereinstimmen.
Beispielsweise enthält das Wörterbuch die Zeichenfolge Request
zweimal: einmal als Verb und einmal als Substantiv. Der folgende Code enthält den Übersetzungshinweis als Argument in der get
-Methode:
i18n.get("Request","A noun, as in a request for a web page");
Sie können Variablen in die lokalisierte Zeichenfolge einfügen, um dem Satz Kontextbedeutung zu geben. Ein Beispiel: Nach der Anmeldung bei einer Webanwendung wird auf der Homepage folgende Nachricht angezeigt: „Willkommen zurück, Administrator. Sie haben zwei Nachrichten in Ihrem Posteingang.“ Der Seitenkontext bestimmt den Benutzernamen und die Anzahl der Nachrichten.
Im Wörterbuch werden die Variablen in Zeichenfolgen als eingeklammerte Indizes dargestellt. Geben Sie die Werte der Variablen als Argumente der Variablen get
-Methode. Die Argumente werden nach dem Übersetzungshinweis platziert und die Indizes entsprechen der Reihenfolge der Argumente:
i18n.get("Welcome back {0}. You have {1} messages.", "user name, number of messages", user.getDisplayName(), numItems);
Die internationalisierte Zeichenfolge und der Übersetzungshinweis müssen genau mit der Zeichenfolge bzw. dem Kommentar im Wörterbuch übereinstimmen. Sie können den Lokalisierungshinweis auslassen, indem Sie einen null
-Wert als zweites Argument angeben.
Die I18N
-Klasse definiert eine statische get
-Methode, die sich zur Lokalisierung einer kleinen Anzahl von Zeichenfolgen eignet. Zusätzlich zu den Parametern der get
-Methode eines Objekts benötigt die statische Methode das Objekt SlingHttpRequest
oder das ResourceBundle
, das Sie verwenden, je nachdem, wie Sie die bevorzugte Sprache des Nutzers bestimmen:
Wenn Sie die Spracheinstellungen des Nutzers verwenden, geben Sie das SlingHttpRequest-Objekt als ersten Parameter an.
I18n.get(slingHttpRequest, "Welcome back {}. You have {} messages.", "user name, number of messages", user.getDisplayName(), numItems);
Wenn Sie die Seitensprache verwenden, geben Sie das ResourceBundle als ersten Parameter an.
I18n.get(resourceBundle,"Welcome back {}. You have {} messages.", "user name, number of messages", user.getDisplayName(), numItems);
Die JavaScript-API ermöglicht es Ihnen, Zeichenfolgen im Client zu lokalisieren. Als Java und JSP -Code, können Sie mit der JavaScript-API zu lokalisierende Zeichenfolgen identifizieren, Lokalisierungshinweise bereitstellen und Variablen in die lokalisierten Zeichenfolgen aufnehmen.
Der granite.utils
-Client-Bibliotheksordner stellt die JavaScript-API bereit. Um die API zu verwenden, fügen Sie diesen Client-Bibliotheksordner in Ihre Seite ein. Lokalisierungsfunktionen verwenden die Granite.I18n
Namespace.
Bevor Sie lokalisierte Zeichenfolgen präsentieren, müssen Sie das Gebietsschema mit der Granite.I18n.setLocale
-Funktion. Diese Funktion erfordert den Sprachcode des Gebietsschemas als Argument:
Granite.I18n.setLocale("fr");
Um eine lokalisierte Zeichenfolge anzuzeigen, verwenden Sie die Granite.I18n.get
Funktion:
Granite.I18n.get("string to localize");
Im folgenden Beispiel wird die Zeichenfolge „Welcome back“ internationalisiert:
Granite.I18n.setLocale("fr");
Granite.I18n.get("string to localize", [variables], "localization hint");
Die Funktionsparameter unterscheiden sich von der Java-I18n.get-Methode:
Das folgende Beispiel verwendet JavaScript, um den Satz „Welcome back Administrator. You have 2 messages in your inbox.“ zu lokalisieren:
Granite.I18n.setLocale("fr");
Granite.I18n.get("Welcome back {0}. You have {1} new messages in your inbox.", [username, numMsg], "user name, number of messages");
UI-Zeichenfolgen basieren häufig auf JCR-Knoteneigenschaften. Die Eigenschaft jcr:title
einer Seite wird beispielsweise häufig als Inhalt des h1
-Elements im Seitencode verwendet. Die I18n
-Klasse stellt die getVar
-Methode zur Lokalisierung dieser Zeichenfolgen.
Das folgende JSP-Skriptbeispiel ruft die jcr:title
-Eigenschaft aus dem Repository ab und zeigt die folgende lokalisierte Zeichenfolge auf der Seite an:
<% title = properties.get("jcr:title", String.class);%>
<h1><%=i18n.getVar(title) %></h1>
Ähnlich wie Übersetzungshinweise in der Java-API können Sie Übersetzungshinweise bereitstellen, um zwischen mehrfach vorhandenen Zeichenfolgen im Wörterbuch zu unterscheiden. Geben Sie den Übersetzungshinweis als Eigenschaft des Knotens an, der die internationalisierte Eigenschaft enthält. Der Name der Eigenschaft hint besteht aus dem Namen der internationalisierten Eigenschaft mit dem _commentI18n
suffix:
${prop}_commentI18n
Ein cq:page
-Knoten enthält beispielsweise die Eigenschaft jcr:title, die lokalisiert wird. Der Hinweis wird als Wert der Eigenschaft mit dem Namen jcr:title_commentI18n angegeben.
Prüfen Sie, ob Sie alle Zeichenfolgen in Ihrer Benutzeroberfläche internationalisiert haben. Um festzustellen, welche Zeichenfolgen abgedeckt sind, setzen Sie die Benutzersprache auf zz_ZZ und öffnen Sie die Benutzeroberfläche im Webbrowser. Die internationalisierten Zeichenfolgen werden mit einer Platzhalterübersetzung im folgenden Format angezeigt:
USR_*Default-String*_尠
Die folgende Abbildung zeigt die Platzhalterübersetzung für die AEM-Homepage:
Um die Sprache für den Benutzer festzuzulegen, konfigurieren Sie die Spracheigenschaft des Präferenzknotens für das Benutzerkonto.
Der Pfad des Präferenzknotens eines Benutzers sieht wie folgt aus:
/home/users/<letter>/<hash>/preferences