世界上最好用的純前端模板(沒有之一)
隨著Ajax技術的普及,純前端模板的使用頻率越來越高。我們需要一個易學、易用、高性能的模板系統來處理日益繁雜的需求變化。
前端模板處理,有90%以上的情況都是在處理html相關字符串,針對這一特性我們設計了一種只包含html和js兩種語法的模板系統AceTemplate。
對于前端開發者,html和js是無需額外的學習成本。
特點
- 易學(只需html和js基礎),易用(最少的輸入)
- 智能(自動識別語法、標識符)
- 擴展便捷
語法
以行為單位,分為兩種html行和js行,自由穿插
判斷是否為html行的規則
◆ 特殊字符開頭;
示例:
- 漢字、#{value}、<div>
◆ Html標記結尾;
示例:
- >、src="1.gif" />
◆ 沒有“雙引號、單引號、分號、逗號,大小括號”,不是else等單行語句;
示例:
- hello world
◆ Html屬性;
示例:
- a="12"、a='ab' b="cd"
◆ 樣式表達式。
示例:
- div.focus{color: #fff;}、#btnAdd span{}
html行負責輸出內容
兩種表達式輸出;#{表達式}和!#{表達式}
#{表達式} 采用html字符串編碼輸出,默認規避xss漏洞
!#{表達式} 采用原文字符串編碼輸出
js行負責邏輯處理
方法
format
格式化輸出
- /**
- * 格式化輸出
- * @param {String|Element} id 模板ID或是模板本身(非標識符將識別為模板本身)
- * @param {Object} data 格式化的數據
- * @param {Object} helper 附加數據(默認為模板對象)
- */
- AceTemplate.format = function(id, data, helper)
register
注冊模板
- /**
- * 注冊模板,如果沒有參數則是注冊所有script標簽模板
- * @param {String} id 模板ID
- * @param {Element|String} target 模板對象或者是模板字符串,如果沒有則默認獲取id對應的DOM對象
- */
- AceTemplate.register = function(id, target)
unregister
注銷模板
- /**
- * 注銷模板
- * @param {String} id 模板ID
- */
- AceTemplate.unregister = function(id)
例子
輸入輸出用例
http://ace-engine.googlecode.com/svn/trunk/examples/ace-template/case.html
調試:http://jsfiddle.net/zswang/hA7Jd/
◆ 集中測試。
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
- <script src="../../scripts/ace-template.js"></script>
- <title>ace template examples</title>
- <style type="text/css">
- #log{
- width: 600px;
- height: 400px;
- }
- </style>
- </head>
- <body>
- <textarea id="log"></textarea>
- <script id="t1" type="text/template">
- if (this["title"])
- {
- #{title}
- }
- else
- {
- <b>無</b>
- }
- </script>
- <script>
- (function() {
- var log = document.getElementById("log");
- var list = [
- {
- input: ["#{this}", "<b>b</b>"],
- output: "<b>b</b>"
- },
- {
- input: ["!#{this}", "<b>b</b>"],
- output: "<b>b</b>"
- },
- {
- input: ["#{title}#{size}", {
- title: "t"
- }],
- output: "t"
- },
- {
- input: ["#{title}#{size + 2}", {
- title: "t"
- }],
- error: true
- },
- {
- input: ["#{1 + 2 + 3 + 4}"],
- output: "10"
- },
- {
- input: ["t1"],
- output: "\t\t\t\t<b>無</b>\n"
- }
- ];
- var message = [];
- for (var i = 0; i < list.length; i++) {
- var item = list[i];
- try {
- var output = AceTemplate.format(item.input[0], item.input[1]);
- if (output == item.output) {
- message.push("√" + i + "輸出結果符合預期。");
- } else {
- message.push("×" + i + "輸出結果不符合預期。-- " + output);
- }
- } catch(ex) {
- if (item.error) {
- message.push("√" + i + "異常符合預期。");
- } else {
- message.push("×" + i + "異常不符合預期。-- " + ex.message);
- }
- }
- }
- log.value = message.join("\n");
- })();
- </script>
- </body>
- </html>
示例普通循環用法
http://ace-engine.googlecode.com/svn/trunk/examples/ace-template/base1.html
調試:http://jsfiddle.net/zswang/S3rwL/
◆ 模板中的this代表數據本身,即format的data參數;
◆ 邏輯部分用js,輸出部分用html,#{表達式}為變量替換。
示例和jquery混用
http://ace-engine.googlecode.com/svn/trunk/examples/ace-template/base2.html 調試:http://jsfiddle.net/zswang/dehd6/
◆ 邏輯部分和輸出部分將編譯成一個完整的js函數塊。
示例默認防止XSS漏洞
http://ace-engine.googlecode.com/svn/trunk/examples/ace-template/secuity1.html
調試:http://jsfiddle.net/zswang/aXKQA/
◆ 輸出表達式默認采用html編碼;
◆ 也可以使用!#{表達式}輸出原文。
示例嵌套模板
http://ace-engine.googlecode.com/svn/trunk/examples/ace-template/nesting1.html
調試:http://jsfiddle.net/zswang/YJWZA/
◆ 模板中helper是一個附加參數,默認指AceTemplate本身;
◆ 采用不編碼輸出另一個模板渲染結果既實現嵌套。
示例遞歸模板
http://ace-engine.googlecode.com/svn/trunk/examples/ace-template/recursion1.html
調試:http://jsfiddle.net/zswang/JcwHg/
模板中可以調用自身遞歸輸出。
示例關鍵詞
http://ace-engine.googlecode.com/svn/trunk/examples/ace-template/keyword.html
調試:http://jsfiddle.net/zswang/fvLX3/
使用html編碼輸出可以這樣:AceTemplate.format("#{this}", text);
通過helper參數,加入keyword方法
作者微博
http://weibo.com/zswang http://weibo.com/zinkey
原文鏈接:http://code.google.com/p/ace-engine/wiki/AceTemplate
【編輯推薦】