國際化UI字串 internationalizing-ui-strings

Java™和JavaScript API可讓您國際化下列資源型別的字串：

如需國際化和本地化程式的概述，請參閱 國際化元件.

在Java™和JSP程式碼中國際化字串 internationalizing-strings-in-java-and-jsp-code

此 com.day.cq.i18n Java™套件可讓您在UI中顯示本地化字串。 此 I18n 類別提供 get 從Adobe Experience Manager (AEM)字典擷取當地語系化字串的方法。 唯一需要的 get method是英文字串。 英文是UI的預設語言。 下列範例會將單字當地語系化 Search：

i18n.get("Search");

識別英文字串與一般國際化架構不同，後者的ID會識別字串，並在執行階段用來參考字串。 使用英文字串常值可提供下列優點：

決定使用者的語言 determining-the-user-s-language

有兩種方法可判斷使用者偏好的語言：

使用者帳戶的language屬性是慣用方法，因為較可靠。 不過，使用者必須登入才能使用此方法。

建立I18n Java™物件 creating-the-i-n-java-object

I18n類別提供兩個建構函式。 如何判斷使用者的偏好語言會決定要使用的建構函式。

若要以使用者帳戶中指定的語言呈現字串，請使用下列建構函式（匯入後） com.day.cq.i18n.I18n)：

I18n i18n = new I18n(slingRequest);

建構函式使用 SlingHTTPRequest 以擷取使用者的語言設定。

若要使用頁面地區設定來決定語言，請先取得請求頁面語言的ResourceBundle：

Locale pageLang = currentPage.getLanguage(false);
ResourceBundle resourceBundle = slingRequest.getResourceBundle(pageLang);
I18n i18n = new I18n(resourceBundle);

國際化字串 internationalizing-a-string

使用 get 方法 I18n 物件以國際化字串。 唯一需要的 get 方法是要國際化的字串。 字串對應至翻譯工具字典中的字串。 get方法會在字典中查詢字串，並傳回目前語言的翻譯。

的第一個引數 get 方法必須符合下列規則：

i18n.get("Enter a search keyword");

使用翻譯提示 using-translation-hints

指定 翻譯提示 識別字典中重複字串的國際化字串。 使用的第二個可選引數 get 提供翻譯提示的方法。 翻譯提示必須與字典中專案的Comment屬性完全相符。

例如，字典包含字串 Request 兩次：一次作為動詞，另一次作為名詞。 下列程式碼包含轉譯提示作為中的引數 get 方法：

i18n.get("Request","A noun, as in a request for a web page");

將變數納入當地語系化句子 including-variables-in-localized-sentences

在本地化字串中加入變數，將內容涵義建置到句子中。 例如，登入Web應用程式後，首頁會顯示訊息「歡迎回來管理員」。 您的收件匣中有兩則訊息。」 頁面內容決定使用者名稱和訊息數。

在字典中中，變數會以字串形式呈現為括弧內的索引。 將變數的值指定為 get 方法。 引數會放置在轉譯提示之後，且索引會與引數的順序相對應：

i18n.get("Welcome back {0}. You have {1} messages.", "user name, number of messages", user.getDisplayName(), numItems);

國際化字串和翻譯提示必須與字典中的字串和註解完全相符。 您可以省略本地化提示，只要提供 null 值做為第二個引數。

使用靜態Get方法 using-the-static-get-method

此 I18N 類別會定義靜態 get 方法，適用於必須當地語系化幾個字串的情況。 除了物件的引數 get 方法，靜態方法需要 SlingHttpRequest 物件或 ResourceBundle 根據您判斷使用者偏好語言的方式，您正在使用的語言：

國際化JavaScript程式碼中的字串 internationalizing-strings-in-javascript-code

JavaScript API可讓您在使用者端上將字串當地語系化。 與 Java™和JSP 程式碼時，JavaScript API可讓您識別要本地化的字串、提供本地化提示，以及在本地化的字串中加入變數。

此 granite.utils 使用者端資料庫資料夾 提供JavaScript API。 若要使用API，請在您的頁面上包含此使用者端程式庫資料夾。 本地化函式使用 Granite.I18n 名稱空間。

顯示當地語系化字串之前，請先使用 Granite.I18n.setLocale 函式。 函式需要地區設定的語言程式碼作為引數：

Granite.I18n.setLocale("fr");

若要呈現當地語系化字串，請使用 Granite.I18n.get 函式：

Granite.I18n.get("string to localize");

下列範例會將「歡迎回來」字串國際化：

Granite.I18n.setLocale("fr");
Granite.I18n.get("string to localize", [variables], "localization hint");

函式引數與Java™ I18n.get方法不同：

以下範例使用JavaScript將「歡迎回來管理員」當地語系化。 您的收件匣中有兩則訊息。」 句子：

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");

從JCR節點國際化字串 internationalizing-strings-from-jcr-nodes

UI字串通常以JCR節點屬性為基礎。 例如， jcr:title 頁面的屬性通常用作 h1 元素。 此 I18n 類別提供 getVar 這些字串的本地化方法。

以下範例JSP指令碼會擷取 jcr:title 屬性，並在頁面上顯示本地化的字串：

<% title = properties.get("jcr:title", String.class);%>
<h1><%=i18n.getVar(title) %></h1>

指定JCR節點的平移提示 specifying-translation-hints-for-jcr-nodes

類似於 Java™ API中的翻譯提示中，您可以提供翻譯提示來區分字典中的重複字串。 提供翻譯提示，作為包含國際化屬性的節點屬性。 hint屬性的名稱是由國際化屬性的名稱加上以下專案所組成： _commentI18n 字尾：

${prop}_commentI18n

例如， cq:page 節點包含正在本地化的jcr：title屬性。 提示會提供為名為jcr：title_commentI18n的屬性的值。

測試國際化涵蓋範圍 testing-internationalization-coverage

測試您是否已將UI中的所有字串國際化。 若要檢視涵蓋哪些字串，請將使用者語言設定為zz_ZZ，然後在網頁瀏覽器中開啟UI。 國際化字串會以下列格式顯示並帶有存根轉譯：

USR_*Default-String*_尠

下圖顯示AEM首頁的存根轉譯：

若要設定使用者的語言，請為使用者帳戶設定偏好設定節點的語言屬性。

使用者的偏好設定節點的路徑如下：

/home/users/<letter>/<hash>/preferences