不少網站為了照顧不同地區使用者的閱讀習慣,會提供簡體/繁體兩種字型的切換。像 Hexo 的作者來自台灣,但官網同時提供了繁體中文版與簡體中文版,照顧了習慣簡體讀寫的大陸使用者;反過來說,我們也可以用同樣的手法提供繁體版,服務使用繁體字的台灣、香港讀者。
傳統做法是在伺服器端轉換,靠控制項或過濾器處理文字。本文介紹的方案完全在前端完成,不需要伺服器介入,也不必重新載入頁面。

前提條件是頁面採用 Unicode(UTF-8)編碼。Unicode 本身已經涵蓋繁體字元,所以我們不必處理 GB2312 與 BIG5 的編碼轉換,只需要做字元對字元的替換。
做法其實非常樸素:準備兩個等長且順序對應的字串,一個放簡體字、一個放繁體字。轉換時把文字裡的每個字拿去其中一張表查索引,再用同一個索引去另一張表取字即可。
;(function () {
// 兩表長度必須完全相同、位置嚴格對應(此處節錄示意,實作需帶入完整對照表)
var 簡化中文 = '啊阿埃挨哎唉哀皚癌藹矮艾礙愛隘鞍氨安俺按暗岸胺案……(完整對照表)……做作坐座';
var 正體中文 = '啊阿埃挨哎唉哀皚癌藹矮艾礙愛隘鞍氨安俺按暗岸胺案……(完整對照表)……做作坐座';
function translateText(text, isBig5) {
var str = [], _char, charIndex, result;
for (var i = 0, j = text.length; i < j; i++) {
_char = text.charAt(i);
charIndex = isBig5 ? 簡化中文.indexOf(_char) : 正體中文.indexOf(_char);
result = isBig5 ? 正體中文.charAt(charIndex) : 簡化中文.charAt(charIndex);
str.push(charIndex != -1 ? result : _char);
}
return str.join('');
}
var traditionalized = translateText.bind(null, true),
simplized = translateText.bind(null, false);
/**
* 遞迴走訪 DOM,逐層轉換文字節點
* @param {HTMLElement} el 從 document.body 開始
*/
function translate(el, coverntFn) {
el = el.childNodes;
var node;
for (var i = 0, j = el.length; i < j; i++) {
node = el.item(i);
if (("||BR|HR|TEXTAREA|").indexOf("|" + node.tagName + "|") > 0) continue;
if (node.title) {
node.title = coverntFn(node.title);
} else if (node.alt) {
node.alt = coverntFn(node.alt);
} else if (node.tagName == "INPUT" && node.value != ""
&& node.type != "text" && node.type != "hidden") {
node.value = coverntFn(node.value);
} else if (node.nodeType == 3) {
node.data = coverntFn(node.data);
} else {
arguments.callee(node, coverntFn);
}
}
}
/**
* 預設語言:true 為正體中文,false 為簡體中文
* 服務端可讀 Request.ServerVariables("http_accept_language")
*/
function getClientLanguage() {
var s = navigator.userLanguage || navigator.language;
switch (s.toLowerCase()) {
case 'zh-cn': return false;
case 'zh-tw': return true;
default: return null;
}
}
var cookieName = 'ChineseType';
window.toChinese = function (el) {
el.addCls('selected');
document.querySelector(".simpleChinese").removeCls('selected');
translate(document.body, traditionalized);
Cookie.set(cookieName, true);
};
window.toSimpleChinese = function (el) {
el.addCls('selected');
document.querySelector(".Chinese").removeCls('selected');
translate(document.body, simplized);
Cookie.set(cookieName, false);
};
var Cookie = {
set: function (name, val) {
var exp = new Date();
exp.setDate(exp.getDate() + 600 * 1000);
document.cookie = name + "=" + escape(val) + ";expires=" + exp.toGMTString();
},
del: function (name) {
document.cookie = name + "=;expires=" + (new Date(0)).toGMTString();
},
get: function (name) {
var m = document.cookie.match(new RegExp("(^| )" + name + "=([^;]*)(;|$)"));
return m != null ? unescape(m[2]) : null;
}
};
var value = Cookie.get(cookieName);
if ((value == null && getClientLanguage()) || value == 'true') {
window.toChinese(document.querySelector(".Chinese"));
}
})();
很多人的第一直覺是把 el.innerHTML 取出來轉換後寫回去,但其實大可不必,而且遞迴的時候很不好處理。仔細想想,我們真正要改的只有文字:DOM 可以用 node.nodeType == 3 判斷文字節點,而 node.data 是可讀可寫的屬性,直接設定它就能完成轉換。節點的 title、alt、value 也是同樣道理。
另外,if (("||BR|HR|TEXTAREA|").indexOf("|" + node.tagName + "|") > 0) continue; 這行是排除特定標籤的技巧:在待排除清單與比對字串兩側都補上 |,可以避免「HR」誤比中「THR」這種子字串問題,思路相當巧妙,值得借鑑。textarea 被排除是刻意的——使用者輸入的內容不該被自動改寫。
用 onclick 直接呼叫 window.toChinese(el) 或 window.toSimpleChinese(el) 即可,傳入的元素本身,用來切換按鈕的高亮狀態。
至於語言偵測,瀏覽器提供了 navigator.userLanguage || navigator.language(服務端對應 http_accept_language 標頭)。程式用 Cookie 保存使用者的明確選擇,並讓它的優先級高於自動偵測——這個順序是正確的:偵測只能提供預設值,使用者的手動選擇必須被尊重。
如果不想自己維護字表,可以直接用現成的腳本,三個步驟就能搞定:
第一步,下載簡繁字體切換所需的 tw_cn.js,上傳到自己的網站空間。
第二步,修改模板,在你想要顯示切換按鈕的位置加上這行(放進 header.php 或 sidebar.php 通常是合理選擇):
<a id="translateLink" href="javascript:translatePage();">繁體</a>
第三步,在 footer.php 加入初始化程式,記得把 cookieDomain 改成自己的網址:
<script type="text/javascript" src="https://www.arao.me/js/tw_cn.js"></script> <script type="text/javascript"> var defaultEncoding = 2; // 網站預設字體:1-繁體,2-簡體 var translateDelay = 0; // 延遲時間,預設 0 var cookieDomain = "https://www.arao.me/"; // Cookie 網域,務必改成自己的 var msgToTraditionalChinese = "繁體"; var msgToSimplifiedChinese = "簡體"; var translateButtonId = "translateLink"; translateInitilization(); </script>
這就基本完成了簡繁切換功能。無論是 Hexo、Jekyll、Octopress 等靜態部落格,還是 WordPress、Typecho、emlog、Z-Blog 等動態系統,都能套用;按鈕的文字與樣式可依個人喜好自行調整。
自己實作的好處是完全掌控、沒有外部依賴,也適合當作理解 DOM 走訪與字元編碼的練習;缺點是字表要自己維護,而且機械式一對一替換對「乾/幹/乾」、「著/着」、「里/裡」這類一簡對多繁的字無能為力,可能產生語意錯誤。使用成熟字庫(如 OpenCC)或現成腳本則在準確度上更有保障。
無論採用哪一種,都建議把前端轉換定位為「閱讀輔助」,正式內容仍應以單一語言版本為主——因為搜尋引擎對同一頁面的兩個語言版本收錄效果有限,而依賴 JavaScript 產生的內容也存在被忽略的風險。