DIV CSS 佈局教程網

Avalon 自訂過濾器:中文長字串截斷與關鍵字元遮蔽
編輯:關於JavaScript     

關於 AvalonJS

Avalon 是一個輕量的 MVVM 框架,最早於 2012 年 9 月發布,目的是解決「同一份商業邏輯卻要維護多種視圖呈現」的問題。這個問題固然能用前端模板加 jQuery 事件代理硬做,但業務膨脹後程式碼會被各種選擇器與回呼塞滿,難以維護。要徹底分離業務與邏輯,就得依賴架構。

作者最初嘗試 MVC(backbone),卻發現程式碼不減反增;後來接觸微軟的 WPF,其優雅的 MVVM 架構正好切中需求。MVVM 把前端程式碼切成兩塊:視圖透過綁定處理(Angular 稱之為指令),業務邏輯集中在 VM 物件。開發者只需操作 VM 的資料,視圖便會自動同步。

JS 中對應的機制是 Object.defineProperty,它把屬性轉為 getter/setter,攔截這兩個方法即可透過 Pub/Sub 模式更新視圖。IE9+ 可安全使用,更舊的 IE 則以 VBScript 補足。專案名稱取自 WPF 最初的開發代號 avalon。

題外話

近來接手一個採用 Avalon 的專案。對已熟悉 AngularJS 的人來說,Avalon 難免顯得「太輕量」;網上為它背書的理由不外乎國產、體積小、逃離 DOM 操作、上手快、相容 IE6,而劣勢一欄寫著「知名度較低」——這說明有點無奈。

一方面它被拿來與 jQuery 對比,批評選擇器與 DOM 操作繁瑣;另一方面 Avalon 的 Ajax 與動畫仍得倚賴其他元件,實務上常又與 jQuery 並用。至於效能與版本相容性,Avalon 也曾出現「三個分支互不兼容,建議直接用 2.0」這類提醒。

平心而論,Avalon 是個不錯的框架,持續在吸收其他 MVVM 的優點,2.0 版就新增了四個陣列過濾器。以下分享兩個簡單實用的自訂過濾器,同樣的概念也能遷移到 Angular。

過濾器一:遮蔽關鍵字元

有些頁面需要在呈現時遮住部分資訊(但若真的要求安全性,仍應由後端處理,前端遮蔽只是視覺效果)。

/**
 * 遮蔽字串中的關鍵 code,預設遮蔽字元為 '*'
 * 例:手機號 189****0000 → {{str|hide_code(3,4,'*')}}
 * @param str     原始字串
 * @param pos     開始位置
 * @param length  要替換的字元個數
 * @param newChar 替換字元
 */
avalon.filters.hide_code = function (str, pos, length, newChar) {
  pos = pos || 0;
  length = length || 0;
  newChar = newChar || '*';

  if (pos < 0 || length <= 0 || pos + length > str.length) {
    return str;
  }

  var repStr = "";
  for (var i = 0; i < length; i++) {
    repStr += newChar;
  }
  return str.slice(0, pos) + repStr + str.slice(pos + length, str.length);
};

過濾器二:中文佔兩字元的長字串截斷

Avalon 內建的 truncate 把中英文都當作一個字元,對中文介面來說容易造成一行塞太多字。以下版本改為「中文 2、英文 1」計算寬度。

/**
 * 以字元寬度截斷長字串,中文佔兩字元
 * 用法:{{str|truncatex(20,'...')}}
 * @param str         原始字串
 * @param length      新字串長度(以英文半形為 1 計算,含結尾符號)
 * @param truncation  結尾符號
 */
avalon.filters.truncatex = function (str, length, truncation) {
  var chinese_pattern = /[\u4E00-\u9FA5]|[\uFE30-\uFFA0]/gi;
  str = str || " ";
  length = length || 30;
  truncation = typeof truncation === "string" ? truncation : "...";

  var chineseIn = function (s) {
    return chinese_pattern.exec(s) ? true : false;
  };

  // 把每個中文字元換成兩個字元後,量測實際寬度
  var calcSize = function (source) {
    return source.replace(chinese_pattern, "aa").length;
  };

  var recursion = function (source, len) {
    if (calcSize(source) <= len || !chineseIn(source)) {
      return source;
    }
    return recursion(source.slice(0, source.length - 1), len);
  };

  var sliceLength = length - truncation.length;
  return calcSize(str) > length
    ? recursion(str.slice(0, sliceLength), sliceLength) + truncation
    : String(str);
};

使用要點

  • 兩個過濾器都是掛在 avalon.filters 上的純函式,因此也能單獨抽成工具函式在模板之外呼叫。
  • hide_code 已對超出範圍的參數做了防呆,避免回傳 undefined。
  • truncatex 採遞迴逐字縮短,字串很長時可改為迴圈以避免呼叫堆疊過深。
  • 若要在 Angular 中使用,把函式包進 app.filter('name', ...) 即可,邏輯完全通用。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved