在瀏覽器端處理「不同地區的格式」一直是件麻煩事:同一個數字,這個國家用逗號分位,那個國家用點;同一個日期,先月後日或先日後月,結論可能差到天遠。jQuery 國際化插件的原型版就是為了解這件事而出現的。
稍早我們談過微軟如何向 jQuery 貢獻程式碼,其中第一批成果包含 jQuery Templates 與 Data Linkage 的支援。這次釋出的則是第三個原型:國際化插件,涵蓋超過 350 種地區的文化資訊,從蘇格蘭蓋爾語、弗里斯蘭語、匈牙利語、日語到加拿大英語都在其中,並以開源形式發布。
專案位置:https://github.com/nje/jquery-glob
最直接的例子是貨幣符號。同一個價格,在美國顯示 $,在德國顯示 €,在日本顯示 ¥——這些差異若靠手寫 if-else 堆,專案一大就無法維護。

日期更棘手。除了順序不同,月份與星期的名稱也需要翻譯,插件會一併處理:

值得注意的是上圖中的阿拉伯語日期,年份顯示為 1431——因為插件已依伊斯蘭曆(回曆)換算過了。
有些差異細微到出乎意料。標記為 te-IN 的文化(印度東部泰盧固語)在數字分組上是「先三位、之後每兩位」,所以一百萬會寫成 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,因為每個都附了最小化版與原始版。命名規則很直白:jquery.glob.en-AU.js 對應澳洲英語,jquery.glob.zh-CHS.js 對應簡體中文。
假設要做一個德文網站,希望頁面上所有價格、日期、數量都依德國習慣呈現。HTML 大致如下,span 標籤標出了需要格式化的位置:

要啟用插件,需引入三支腳本:jQuery 本體、國際化插件、以及該文化的資訊檔:

接著就能在客戶端格式化各個值:

插件為 jQuery 新增了幾個函式。preferCulture() 用來設定後續呼叫的預設文化,接受一個語言標記並採用最接近的結果;format() 才是真正做格式化的,第二個參數是格式字串——傳 "c" 表示貨幣樣式,傳 "D" 表示長日期。完整的格式字串清單在 GitHub 的 README 裡。
打開頁面,一切會依德國習慣呈現:歐元符號、德語的月份與星期名稱,小數分隔符是點而非逗號。
對應範例檔:3_GermanSite.htm。
把文化寫死顯然不夠彈性。比較好的做法是放一個下拉框列出所有 350 種文化,選完就重排整頁:


這裡有個關鍵設計:所有含日期的 span 都帶一個 data-date 屬性。data-* 是 HTML5 的新特性,但在舊瀏覽器上也能正常使用,等於把「原始資料」與「顯示格式」乾淨地分開——資料寫一次,格式隨文化變。
要一次列出所有文化,需要載入 jquery.glob.all.js:

不過請注意:這支檔案即使最小化後仍有 367 KB。除非你的確需要一次支援全部文化,否則強烈建議只載入用得到的那幾支。
取得文化清單用 $.cultures 屬性:

最後把每個 span 的 data-date 取出、用 parseDate() 轉成 JavaScript 日期物件,再交給 format() 輸出:

對應範例檔:4_SelectCulture.htm。
既然 jquery.glob.all.js 太大,更好的策略是「用到才載」。下拉框只列少數幾種語言:

使用者切換時,先判斷該語言的腳本是否已載入;若沒有,用 jQuery 的 $.getScript() 動態抓下來:

腳本載入完成後呼叫 globalizePage() 完成格式化。這個做法的好處很明確:只載入需要的檔案,而且只載入一次。
對應範例檔:5_Dynamic.htm。
多數網站靠瀏覽器設定判斷語言。使用者在瀏覽器中設定的偏好語言,會隨每次請求放在 HTTP 標頭的 Accept-Language 欄位裡。
以 IE 為例,設定路徑是:工具 → Internet 選項 → 一般 → 外觀中的「語言」按鈕 → 新增,然後把最常用的排在最上面。

可以設定多個,順序會反映在標頭裡,例如:
Accept-Language: fr-FR, id-ID;q=0.7, en-US;q=0.3
麻煩的是,客戶端 JavaScript 讀不到 Accept-Language。IE 與 Firefox 都提供了一些語言相關屬性,可透過 window.navigator 存取,例如 navigator.browserLanguage、navigator.language,但這些反映的是作業系統或瀏覽器版本的語言,並不等於使用者設定的偏好。
唯一可靠的方式是寫一小段伺服器端程式。以下 ASP.NET 頁面把伺服器的 Request.UserLanguages 丟給客戶端變數,之後前端就能自由使用:

前提當然是:頁面必須包含對應的文化資訊檔。若偏好語言是 fr-FR,就得引入 jquery.glob.fr-FR.js 或 jquery.glob.all.js,否則無從取得資訊。
若找不到精確對應,$.preferCulture() 會退一階採用中立文化(例如用 jquery.glob.fr.js 取代 fr-FR);若連中立文化也沒有,則回退到預設的英語。
對應範例檔:6_AcceptLanguages.aspx。
這個插件的目標之一,是讓各種 jQuery 小工具能輕鬆適應不同文化。團隊因此做了一個整合版的 DatePicker,讓它在渲染日曆時直接借用國際化插件的資料:

可以看到星期與月份的名稱都換成了印尼語。整合版可從 GitHub 下載,對應範例檔是 7_DatePicker.htm。
這是團隊發布的第三個插件。他們特別感謝社群對先前 jQuery Templates 與 Data Linkage 原型給出的回饋與設計建議,也感謝 jQuery 與 jQuery UI 團隊在開發過程中的協助。
把文化格式這種「瑣碎但到處都會踩到」的問題收攏成一個統一的 API,價值就在這裡:你不再需要為每個地區寫一套判斷,只要換一個語言標記。