DIV CSS 佈局教程網

三步驟讓網站支援簡體繁體切換:純 JavaScript 實作教學
編輯:關於JavaScript     

不少網站為了照顧不同地區使用者的閱讀習慣,會提供簡體/繁體兩種字型的切換。像 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"));
  }
})();

為什麼不用 innerHTML

很多人的第一直覺是把 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

如果不想自己維護字表,可以直接用現成的腳本,三個步驟就能搞定:

第一步,下載簡繁字體切換所需的 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 產生的內容也存在被忽略的風險。

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