DIV CSS 佈局教程網

純 jQuery + Thymeleaf 實現中英文(多語)頁面切換
編輯:JQuery入門技巧     

專案沒有引入 Vue、Angular 這類前端框架,又需要多語系,該怎麼辦?如果後端用的是 Thymeleaf,可以搭配 jquery.localize 這個小插件,用一份 JSON 語言包驅動畫面上的文字,同時把使用者的語言選擇記在 Cookie 裡。

思路

在 HTML 標籤上以 data-localize 標記一個 key,頁面載入時由 JavaScript 讀取對應語系的 JSON 檔,把 key 換成真正的文字。切換語系時只要重新載入並指定語言即可,不需要維護兩套模板。

一、HTML

<!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"。

三、language_cookie.js

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 是明文存放的,只適合保存語系代碼這類無敏感性的偏好設定,不要拿來放任何身分或授權資訊。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved