專案沒有引入 Vue、Angular 這類前端框架,又需要多語系,該怎麼辦?如果後端用的是 Thymeleaf,可以搭配 jquery.localize 這個小插件,用一份 JSON 語言包驅動畫面上的文字,同時把使用者的語言選擇記在 Cookie 裡。
在 HTML 標籤上以 data-localize 標記一個 key,頁面載入時由 JavaScript 讀取對應語系的 JSON 檔,把 key 換成真正的文字。切換語系時只要重新載入並指定語言即可,不需要維護兩套模板。
<!DOCTYPE>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Language</title>
<!-- 三個檔案:jquery.localize.js 負責本地化,
language_cookie.js 負責記住使用者選擇 -->
<script src="jquery.js" type="text/javascript" charset="utf-8"></script>
<script src="jquery.localize.js" type="text/javascript" charset="utf-8"></script>
<script src="language_cookie.js" type="text/javascript" charset="utf-8"></script>
</head>
<body>
<div class="top_lan">
<select id="ddlSomoveLanguage" onchange="chgLang();">
<option value="">LAGUAGE</option>
<option value="ja">日本</option>
<option value="en">ENGLISH</option>
</select>
</div>
<div id="prod_navright">
<ul>
<li><a data-localize="hpt.management" href="hospitality_management_ja.html">MANAGEMENT</a></li>
<li><a data-localize="hpt.support" href="hospitality_support_ja.html">SUPPORT</a></li>
<li><a data-localize="hpt.tutorial" href="hospitality_tutorial_ja.html">TUTORIAL</a></li>
<li><a data-localize="hpt.features" href="hospitality_features_ja.html">FEATURES</a></li>
</ul>
</div>
</body>
</html>
檔名格式為 text-{語言}.json,放在 lang 目錄下。
// text-en.json
{
"hpt": {
"features": "FEATURES",
"tutorial": "TUTORIAL",
"support": "SUPPORT",
"management": "MANAGEMENT"
}
}
text-ja.json 結構完全相同,只是把值換成日文。key 支援巢狀結構,用點分隔即可對應到 data-localize="hpt.management"。
var name = "somoveLanguage";
function chgLang() {
var value = $("#ddlSomoveLanguage").children('option:selected').val();
SetCookie(name, value);
location.reload();
}
function SetCookie(name, value) {
var Days = 30;
var exp = new Date();
exp.setTime(exp.getTime() + Days * 24 * 60 * 60 * 1000);
document.cookie = name + "=" + escape(value) + ";expires=" + exp.toGMTString();
}
function getCookie(name) {
var arr = document.cookie.match(new RegExp("(^| )" + name + "=([^;]*)(;|$)"));
if (arr != null) return unescape(arr[2]);
return null;
}
$(function() {
var uulanguage = (navigator.language || navigator.browserLanguage).toLowerCase();
// 先依瀏覽器語言給一個預設值
if (uulanguage.indexOf("en") > -1) {
$("[data-localize]").localize("text", { pathPrefix: "lang", language: "en" });
} else if (uulanguage.indexOf("ja") > -1) {
$("[data-localize]").localize("text", { pathPrefix: "lang", language: "ja" });
} else {
$("[data-localize]").localize("text", { pathPrefix: "lang", language: "en" });
}
// 若 Cookie 有記錄,以使用者的選擇為準
if (getCookie(name) != "") {
if (getCookie(name) == "ja") {
$("[data-localize]").localize("text", { pathPrefix: "lang", language: "ja" });
}
if (getCookie(name) == "en") {
$("[data-localize]").localize("text", { pathPrefix: "lang", language: "en" });
}
}
});
必須透過伺服器存取。localize 底層使用 XMLHttpRequest 讀取 JSON,直接用 file:// 開啟 HTML 會被瀏覽器的同源政策擋下,拿不到語言包。一定要透過 HTTP 服務開啟頁面。
避免重複渲染。上面這段程式碼在預設語言與 Cookie 語言不一致時,會先渲染一次再渲染第二次,使用者可能看到文字閃一下。實務上建議先判斷最終語言,只呼叫一次 localize()。
另外,Cookie 是明文存放的,只適合保存語系代碼這類無敏感性的偏好設定,不要拿來放任何身分或授權資訊。