新聞中心
在設(shè)計(jì)網(wǎng)站時(shí),一個(gè)重要的考慮是國(guó)際化。世界上每個(gè)地區(qū)和國(guó)家對(duì)于文本、消息、數(shù)字和日期應(yīng)該如何出現(xiàn)有不同的期望。特定應(yīng)用程序的每個(gè)用戶期望所有文本和消息以熟悉的格式顯示。JavaScript有一個(gè)很好的國(guó)際化解決方案稱為jQuery.i18n。jQuery i18n用于MediaWiki和許多其他國(guó)際網(wǎng)站的本地化。

JQuery I18n的特性
-
保持代碼與i18n內(nèi)容分離。此功能保持代碼的模塊化,并允許開發(fā)人員加載他們需要的i18n功能。
-
使用JSON格式。
-
允許不刷新網(wǎng)頁(yè)而更改語(yǔ)言。
-
處理復(fù)數(shù)形式不使用附加消息。規(guī)則處理使用Unicode Consortium的通用區(qū)域設(shè)置數(shù)據(jù)存儲(chǔ)庫(kù)(Common Locale Data Repository,CLDR)完成。
-
通過傳遞性別值來根據(jù)性別更正句子。
-
支持語(yǔ)法形式。
JQuery I18n目錄
使用jQuery i18n格式化目錄的常規(guī)方法是對(duì)存儲(chǔ)在此目錄中的每種語(yǔ)言代碼都有一個(gè)JSON文件的i18n文件夾。Figure 1中顯示了一個(gè)示例目錄。
Figure 1.每種語(yǔ)言代碼的JSON文件的目錄。
JQuery I18n消息文件格式
jQuery i18n使用JSON文件,這允許用戶以輕量級(jí)格式存儲(chǔ)信息以進(jìn)行數(shù)據(jù)交換。 JSON文件非常有益,因?yàn)椋?/p>
-
它們?cè)试S翻譯人員輕松地訪問要翻譯的文本。如果需要發(fā)送JSON文件用于翻譯服務(wù),這將非常有用。
-
它們阻止對(duì)數(shù)據(jù)庫(kù)的直接訪問。
JSON文件由一系列名稱-值對(duì)或值的有序列表組成。在用于國(guó)際化的JSON文件中,消息鍵-消息對(duì)包含所有語(yǔ)言對(duì)的名稱和值。每個(gè)鍵都是小寫字母,使用“ – ”分隔單詞,并與所選語(yǔ)言中的值相關(guān)聯(lián)。JSON文件可以包含@metadata,存儲(chǔ)關(guān)于文件的非消息信息,例如版權(quán)和作者信息。通常為每種語(yǔ)言類型創(chuàng)建單獨(dú)的JSON文件;然而,所有的翻譯也可以放在一個(gè)單一的文件中。單獨(dú)JSON文件的優(yōu)點(diǎn)是文件不那么復(fù)雜。但是,單個(gè)JSON文件有助于確保在嵌入多語(yǔ)言數(shù)據(jù)時(shí)字段不會(huì)重復(fù)。下面提供了一個(gè)包含單一語(yǔ)言和@metadata的JSON文件示例:
- {
- "@metadata": {
- "author": "Colleen",
- "description": "An example JSON file",
- "last-updated": "2016-09-21",
- "message-documentation": "qqq"
- },
- "greeting": "Hello",
- "bye": "Goodbye"
- }
下面提供了一個(gè)包含多種語(yǔ)言和@metadata的JSON文件示例:
- {
- "@metadata": {
- "author": "Fred",
- "description": "An example JSON file",
- "last-updated": "2016-09-21",
- "message-documentation": "qqq",
- "arrayGroups": {
- "label": {
- "en": "label_en",
- "fr": "label_fr"
- }
- }
- },
- "en": {
- "greeting": “Hello”,
- "bye": "Goodbye"
- }
- "fr": {
- "greeting": “Bonjour”,
- "bye": "Au revoir"
- }
- }
用法
jquery.i18n的一些使用方法如下表所示。
|
使用區(qū)域 |
說明 |
|
切換區(qū)域設(shè)置 |
可以使用locale選項(xiàng)獲取網(wǎng)頁(yè)的區(qū)域設(shè)置: $.i18n( { locale: ‘fr’ // Locale is French } ); 在插件初始化后切換到另一個(gè)區(qū)域設(shè)置: $.i18n ().locale = ‘ml’; |
|
消息加載 |
可以為特定區(qū)域設(shè)置或多個(gè)區(qū)域設(shè)置加載消息。 $.i18n().load( { } ); |
|
數(shù)據(jù)API |
本地化消息可以不使用JavaScript顯示。 |
|
消息格式 – 占位符 |
這些參數(shù)在消息中通過$1,$2,$3表示,語(yǔ)法為{{PLURAL:$1|pluralform1|pluralform2|…}} ,并由運(yùn)行時(shí)替換。 |
|
消息格式 – 復(fù)數(shù) |
在英語(yǔ)中,只有兩個(gè)復(fù)數(shù)形式,但在許多其他語(yǔ)言中,有兩個(gè)以上的復(fù)數(shù)形式。 |
|
消息格式 – 性別 |
{{GENDER…}}語(yǔ)法使用占位符的性別,動(dòng)態(tài)更改語(yǔ)法。 |
翻譯
有幾種方法來翻譯一個(gè)jquery.i18n應(yīng)用程序:
-
編輯JSON文件。這適用于語(yǔ)言數(shù)量有限的小型應(yīng)用程序。
-
有一個(gè)應(yīng)用程序的翻譯界面。此選項(xiàng)適用于具有許多翻譯器的專有或?qū)S脩?yīng)用程序。
JQuery.I18n.Properties
jQuery.i18n.properties是一個(gè)用于國(guó)際化的jQuery插件。與Java類似,jquery i18n使用資源軟件集(’.properties’文件)。資源軟件集用于存儲(chǔ)特定于區(qū)域的信息,例如文本消息。它們?cè)试S輕松訪問特定于區(qū)域的信息并通過添加額外的資源軟件集來輕松添加區(qū)域。 ‘.properties’文件包含特定于區(qū)域的鍵-值對(duì),并根據(jù)語(yǔ)言和國(guó)家/地區(qū)代碼解析這些文件。
使用Jquery.I18n.Properties
jquery.i18n.properties.js插件可以從https://github.com/jquery-i18n-properties/jquery-i18n-properties下載。插件應(yīng)包含在HTML頁(yè)面的
部分中。你使用的jquery的版本應(yīng)如下所示在源文件中指定。JQuery.I18n.Properties的特性
-
像Java i18n一樣工作。使用資源軟件集(’.properties’文件)進(jìn)行翻譯。使用ISO-639作為語(yǔ)言代碼,使用ISO-3166作為國(guó)家代碼。
-
如果未指定語(yǔ)言,則使用默認(rèn)瀏覽器語(yǔ)言。始終首先使用資源軟件集中的默認(rèn)語(yǔ)言。接下來加載用戶指定的語(yǔ)言。
-
資源軟件集字符串允許占位符替換,并且支持鍵中的命名空間。
語(yǔ)言控制
為了使代碼更有效率,減少404錯(cuò)誤,應(yīng)使用languages.json文件。languages.json文件定義了可以使用的語(yǔ)言和屬性文件。languages.json應(yīng)該放置在與語(yǔ)言屬性文件相同的目錄中。languages.json文件的示例如下:
- {
- "languages": [
- "en_GB",
- "es_ES",
- "pt_BR",
- "sv_SE"
- ]
- }
使用JQuery.I18n.Properties的示例
要使用jquery.i18n.properties.js創(chuàng)建HTML頁(yè)面,***步是創(chuàng)建一個(gè)目錄,其中包含JavaScript文件和屬性文件所需的文件夾。對(duì)于這個(gè)例子,我們將使用Figure 2中的目錄。
Figure 2.使用屬性文件的目錄。
接下來,創(chuàng)建HTML代碼。HTML包含允許用戶選擇語(yǔ)言的下拉菜單。下拉列表下面的消息根據(jù)所選語(yǔ)言進(jìn)行本地化。
Internationalization Example Using jQuery.i18n.properties
- Language:
Thank you for reading this example
Your Selected Language is: en
定義.Properties文件
jquery.i18n.properties.js插件使用.properties文件作為翻譯文本。在此示例中使用三個(gè)屬性文件:(1)Messages.properties,(2)Messages_fr.properties以及(3)Messages_tr.properties。每個(gè)屬性文件中的文本如下所示:
- Messages.properties
- lWelcome = Thank you for reading this example
- lSelLang = Your Selected Language is: {0}
- Messages_fr.properties
- lWelcome = Merci d'avoir lu cet exemple
- lSelLang = Votre langue sélectionnée est : {0}
- Messages_tr.properties
- lWelcome = Bu ?rnek okumak i?in te?ekkür ederiz
- lSelLang = Sizin Se?ili Dil ge?erli: {0}
從.Properties加載本地化字符串
要從屬性文件加載消息,請(qǐng)將jquery.i18n.properties.js文件保存在js文件夾中。下面的jquery.i18n.properties.js代碼是顯示如何加載屬性文件的簡(jiǎn)單示例。
選項(xiàng)
|
選項(xiàng) |
說明 |
備注 |
|
name |
表示資源軟件集的文件名或文件名的一部分。 |
可選字符串或String [] |
|
language |
ISO-639語(yǔ)言代碼(’en’,’fr’)以及可選的ISO-3166國(guó)家代碼(’en_US’,’pt_BR’)。如果未指定,將使用瀏覽器報(bào)告的默認(rèn)語(yǔ)言。 |
可選字符串 |
|
path |
包含要加載的“.properties”文件的目錄路徑。 |
可選字符串 |
|
mode |
將資源軟件集密鑰作為JavaScript vars / 作為映射functions OR使用的選項(xiàng)。 |
可選字符串 |
|
cache |
軟件集通過瀏覽器緩存或強(qiáng)制重新加載。默認(rèn)為強(qiáng)制重新加載。 |
可選布爾值 |
|
encoding |
對(duì)軟件集編碼的類型。屬性文件資源軟件集以ISO-8859-1格式指定。默認(rèn)為UTF-8格式。 |
可選字符串 |
|
callback |
當(dāng)腳本執(zhí)行完成時(shí)調(diào)用回調(diào)函數(shù)。 |
可選function() |
譯文鏈接:http://www.codeceo.com/article/jquery-u18n-web-dev.html
英文原文:What Every Developer Should Know About JQuery I18n
翻譯作者:碼農(nóng)網(wǎng) – 小峰
網(wǎng)頁(yè)名稱:每個(gè)Web開發(fā)者應(yīng)該知道的jQueryi18n知識(shí)
當(dāng)前URL:http://m.5511xx.com/article/dhjoosj.html


咨詢
建站咨詢
