jQuery 國際化插件能讓你在 JavaScript 代碼中輕松處理不同文化之間的數字、貨幣和日期格式,例如正確顯示某個國家的貨幣符號。
上個月,我寫過一篇關於微軟如何向 jQuery 貢獻代碼的文章,也談到了第一批貢獻代碼中的部分功能:jQuery 模板與數據鏈接支持。今天,我們發布了一個全新的 jQuery 國際化插件原型,你可以在 JavaScript 程序中引用它來添加國際化功能。該插件涵蓋超過 350 種文化的國際化信息,從蘇格蘭蓋爾語、佛裡斯蘭語、匈牙利語、日語到加拿大英語等,並將以開源形式發布。
你可以從我們的 Github 代碼庫下載插件原型版本:
https://github.com/nje/jquery-glob
理解國際化
jQuery 國際化插件能讓你在 JavaScript 中輕松處理不同文化之間的數字、貨幣和日期格式。例如,你可以用它正確顯示一個國家的貨幣符號:

你也可以用它編排日期格式,讓日期和月份以正確的順序顯示,名稱也能得到正確翻譯:

請注意上圖阿拉伯的日期格式中年份顯示為 1431,這是因為年份已按回歷方式轉換過了。
有些文化差異明顯,例如使用不同貨幣或不同月份名稱;另一些差異則細微而出人意料。例如在語言標記為 "te-IN" 的文化中(印度東部泰盧固語),數字先按 3 位分組,然後再每 2 位分組,因此一百萬(1000000)會寫成 "10,00,000";而有些文化根本不對數字分組。這些細微差異都能被插件自動處理。
要得到正確的日期可能需要技巧:不同文化採用不同歷法,比如公歷和回歷;同一種文化也可能採用多個歷法,比如日本同時採用公歷和以天皇年號推算的紀年歷。插件提供了函數,能在這些歷法間相互轉換。
使用語言標記
插件依據 RFC 4646 和 RFC 5646 標準裡定義的語言標記來識別文化(參見 https://tools.ietf.org/html/rfc5646)。語言標記通常由連字符將多個子標簽組合而成,比如:
en-AU 英文(澳大利亞)
en-BZ 英文(伯利茲)
en-CA 英文(加拿大)
Id 印度尼西亞文
zh-CHS 中文(簡體)— 標記不再使用
Zu 祖魯文
請注意單一語言(如英語)可以有多個語言標記。同為英語國家,加拿大採用的數字、貨幣和日期格式就不同於澳大利亞或美國。你可以用語言子標簽查找工具獲取某文化的語言標記:https://rishida.net/utils/subtags/。
插件裡一個叫 globinfo 的文件夾包含了這 350 種文化的信息,實際上有 700 多個文件,因為每個文件都有最小化與原始兩個版本。比如在 globinfo 文件夾,jQuery.glob.en-AU.js 對應英文(澳大利亞),jQuery.glob.id.js 對應印度尼西亞文,jQuery.glob.zh-CHS 對應簡體中文。
示例:指定某種文化
假設你要創建一個德文網站,並希望在客戶端 JavaScript 裡按德語習慣顯示所有日期、貨幣符號和數字。頁面源碼也許類似下面的 HTML:

注意上面的 span 標簽,它們標識了所有需要用國際化插件格式化的區域:商品價格、上架日期與庫存量。
要在網頁裡使用該插件,需要添加三個 JavaScript 文件:jQuery 庫、jQuery 國際化插件,以及指定文化的信息文件:

上例中,我把含德語文化的 jQuery.glob.de-DE.js 靜態加入網頁,"de-DE" 是表示在德國使用的德語的語言標記。
引入必要腳本後,就可以用下面的客戶端 JavaScript 代碼調用插件來顯示價格、上架日期與庫存量:

該插件為 jQuery 添加了一些新函數——包括 preferCulture() 和 format()。你可以通過 preferCulture() 設置其他函數調用時的默認文化,它接受一個語言標記作為參數,並使用最接近該標記的文化。$.format() 則真正用來編排貨幣、日期和數字格式,其第二個參數是格式分類符,例如傳入 "c" 表示按貨幣樣式編排。

當我們在瀏覽器打開這個頁面時,所有內容都按德語習慣正確顯示:貨幣採用歐元符號,日期採用德語的日期和月份名稱,數字分隔符用的是點號(.)而非逗號(,)。你可以通過運行示例下載中的 3_GermanSite.htm 了解上述方法。
示例:用戶動態選擇區域設置
在前面的例子中,我們顯式指定使用德語文化(通過引用 jQuery.glob.de-DE.js)。現在來看看動態設置文化的例子。
假設我們想在頁面上加一個包含所有 350 種文化的下拉框,當用戶選擇某個文化後,頁面上所有日期都按該文化習慣顯示。所有含日期的 span 標簽都有一個 data-date 屬性(data-* 是 HTML5 新功能,在老瀏覽器上也可用),當用戶選擇文化後,代碼會格式化 data-date 中保存的日期。
為了顯示所有可能的文化,我們要加入一個叫 jQuery.glob.all.js 的文件,它包含插件支持的全部 350 多種文化的國際化信息,即使最小化後仍有 367k 字節。由於文件很大,除非你的確需要一次性使用所有文化,否則建議只添加用到的文化對應的 JS 文件。
下一步,用 $.cultures 屬性獲取所有支持的文化名稱並添加到下拉框。最後,再寫幾行代碼把每個 span 裡 data-date 的日期抓出來並格式化。插件裡的 parseDate() 函數把字符串日期轉換成 JavaScript 日期,format() 則用來編排格式,"D" 這個格式分類符表示使用長日期格式。用戶選擇 350 種語言之一時,內容都會被正確國際化(可運行 4_SelectCulture.htm 了解)。
示例:動態加載國際化文件
上一節說過,應盡量避免引用 jQuery.glob.all.js,因為它太大了。相反,你可以動態加載所需的國際化信息。下面的代碼會在用戶從下拉框選擇新語言後執行:先判斷選中語言對應的國際化腳本是否已加載,若沒有,則用 jQuery 的 $.getScript() 動態加載。加載完成後會調用 globalizePage() 函數完成國際化。這種方式的好處是只加載用到的文件,而且只加載一次(可運行 5_Dynamic.htm 了解)。
示例:自動檢測用戶常用語言
大多數網站通過檢測用戶瀏覽器設置來得到其常用語言,再據此國際化內容。用戶可在瀏覽器中設置常用語言,這樣的設置會包含在請求 HTTP 消息頭的 Accept-Language 字段中。以 IE 為例:工具 → Internet 選項 → 常規標簽 → 外觀裡點擊「語言」按鈕 → 添加新語言,並把最常用的語言放在列表最頂端。

你可以在這個對話框中設置多門常用語言,順序會體現在 Accept-Language 字段中,如:Accept-Language:fr-FR,id-ID;q=0.7,en-US;q=0.3。
奇怪的是,用戶無法通過客戶端 JavaScript 得到 Accept-Language 的內容。IE 和 Firefox 雖支持一些語言相關屬性(如 window.navigator.browserLanguage 和 window.navigator.language),但這些屬性通常指操作系統語言或瀏覽器語言版本,而非用戶設置的常用語言。得到用戶語言偏好的唯一可靠方法是編寫服務器代碼。例如,下面的 ASP.NET 頁面利用服務器的 Request.UserLanguages 屬性,把用戶語言偏好賦給客戶端 JavaScript 的 acceptLanguage 變量。

為使這段代碼正常工作,頁面中必須包含與 acceptLanguage 對應的文化信息。若沒有對應腳本,$.preferCulture() 會引用中立(neutral)文化信息(如用 jQuery.glob.fr.js 而非 jQuery.glob.fr-FR.js);若中立文化也不可用,則回滾到默認文化(英語)。可參考示例下載中的 6_AcceptLanguages.aspx。
示例:讓 jQuery UI DatePicker 實現國際化
國際化插件的目的之一,就是讓適應各種文化的 jQuery 小工具開發變得更簡單。我們希望確保該插件能與現有 jQuery UI 插件(如 DatePicker)共存並正常工作。為此,我們創建了 DatePicker 的整合版本,讓它在渲染日歷時利用本插件提供國際化支持。下圖演示了把國際化插件與整合後的 DatePicker 一起加入頁面並選擇印度尼西亞語的效果——一周中每天的名稱以印尼語縮寫顯示,月份名稱也以印尼語顯示。

你可以從我們的 github 網站下載整合版 jQuery UI DatePicker,也可使用示例下載中 7_DatePicker.htm 所用的版本。
總結
很高興能為 jQuery 社區持續貢獻,這個國際化插件已是我們發布的第三個插件了。感謝大家對年初發布的 jQuery 模板與數據鏈接原型提供的寶貴反饋與設計建議,也感謝 jQuery 和 jQuery UI 團隊在創建這些插件時提供的幫助。希望這能對您有所幫助。
原文:https://blog.joycode.com/scottgu/archive/2010/06/25/116006.joy