easy.templatejs
Version:
Small, pure, high-performance JavaScript template engine.
305 lines (287 loc) • 9.71 kB
JavaScript
/**
* EasyTemplate
*
* Version 2.1.1
*
* http://easyproject.cn
* https://github.com/ushelp
*
* Copyright 2012 Ray [ inthinkcolor@gmail.com ]
* Released under the MIT license
*
* [Support AMD, CMD, CommonJS, Node.js]
*
*/
;(function(){
// 启用严格模式
"use strict";
// 自定义局部 undefined 变量
var undefined;
/** Node.js global 检测. */
var freeGlobal = typeof global == 'object' && global && global.Object === Object && global;
/** `self` 变量检测. */
var freeSelf = typeof self == 'object' && self && self.Object === Object && self;
/** 全局对象检测. */
var root = freeGlobal || freeSelf || Function('return this')();
/** `exports` 变量检测. */
var freeExports = typeof exports == 'object' && exports && !exports.nodeType && exports;
/** `module` 变量检测. */
var freeModule = freeExports && typeof module == 'object' && module && !module.nodeType && module;
// 其他变量，函数定义...
var _Et = root.Et,
noMatch = /(.)^/,
escaper = /\\|'|\r|\n|\t|\u2028|\u2029/g,
escapes = {
"'": "'",
"\\": "\\",
"\r": "r",
"\n": "n",
" ": "t",
"\u2028": "u2028",
"\u2029": "u2029"
},
entityMap = {
escape: {
"&": "&",
"<": "<",
">": ">",
'"': """,
"'": "'"
},
unescape: {
"&": "&",
"<": "<",
">": ">",
""": '"',
"'": "'"
}
},
has = function(obj, key) {
return hasOwnProperty.call(obj, key);
},
keys = Object.keys || function(obj) {
if(obj !== Object(obj)) throw new TypeError("Invalid object");
var keys = [];
for(var key in obj)
if(has(obj, key)) keys.push(key);
return keys;
}, // Regexes containing the keys and values listed immediately above.
entityRegexes = {
escape: new RegExp("[" + keys(entityMap.escape).join("") + "]", "g"),
unescape: new RegExp("(" + keys(entityMap.unescape).join("|") + ")", "g")
},
slice = Array.prototype.slice,
defaults = function(obj) {
Et.each(slice.call(arguments, 1), function(source) {
if(source) {
for(var prop in source) {
if(obj[prop] === void 0) obj[prop] = source[prop];
}
}
});
return obj;
},
// 静态编译部分
REMOVE=/\/\*[\w\W]*?\*\/|\/\/[^\n]*\n|\/\/[^\n]*$|"(?:[^"\\]|\\[\w\W])*"|'(?:[^'\\]|\\[\w\W])*'|\s*\.\s*[$\w\.]+/g,
SPLIT= /[^\w$]+/g,
KEYWORDS= new RegExp(["\\b" + "break,case,catch,continue,debugger,default,delete,do,else,false,finally,for,function,if,in,instanceof,new,null,return,switch,this,throw,true,try,typeof,var,void,while,with,abstract,boolean,byte,char,class,const,double,enum,export,extends,final,float,goto,implements,import,int,interface,long,native,package,private,protected,public,short,static,super,synchronized,throws,transient,volatile,arguments,let,yield,undefined".replace(/,/g, '\\b|\\b') + "\\b"].join('|'), 'g'),
NUMBER= /^\d[^,]*|,\d[^,]*/g,
BOUNDARY= /^,+|,+$/g,
SPLIT2= /^$|,+/,
// 返回静态编译的变量列表
getVars=function(code) {
var varArray= code
.replace(REMOVE, '')
.replace(SPLIT, ',')
.replace(KEYWORDS, '')
.replace(NUMBER, '')
.replace(BOUNDARY, '')
.split(SPLIT2);
var n = {},r=[];
for(var i = 0; i < varArray.length; i++)
{
if (!n[varArray[i]] && varArray[i]!="_p" && varArray[i]!="Et" && varArray[i]!="out")
{
n[varArray[i]] = true;
r.push(varArray[i]);
}
}
var vars = "var ";
while(r.length) {
var v = r.shift();
vars += "" + v + '= data.' + v + ',';
}
return vars;
},
cacheTmplSettings;
/*--------------------------------------------------------------------------*/
// Do your work...
// 保存现场
var _Et = root.Et;
// 核心对象
var Et = {
// 模板标签表达式
tmplSettings: {
// 脚本表达式 开始结束标记%{ JS script }%
scriptBegin:"%{",
scriptEnd:"}%",
// 输出表达式开始结束标记 {name}
outBegin:"{",
outEnd:"}",
// 转义输出表达式开始结束标记 {-name}
escapeOutBegin:"{-",
escapeOutEnd:"}"
},
/**
* 将字符串中的特殊字符转义为字符实体，并返回
* @param {text} string 字符串
* @return {String} 转意后的字符串
*/
escape: function(text) {
if(text == null) return "";
return("" + text).replace(entityRegexes["escape"], function(match) {
return entityMap["escape"][match];
});
},
/**
* escape的反向操作函数，将字符串中的字符实体转移为字符，并返回
* @param {text} string 字符串
* @return {String} 转意后的字符串
*/
unescape: function(text) {
if(text == null) return "";
return("" + text).replace(entityRegexes["unescape"], function(match) {
return entityMap["unescape"][match];
});
},
/**
* 遍历集合或对象。
* @param {Object} obj 要遍历的集合或对象
* @param {function} iterator 迭代函数，包括值、索引、集合对象三个参数
* @param {Object} context 将iterator绑定到context上执行，可用来向iteraotr传递一些其他元素
*/
each: function(obj, iterator, context) {
if(obj == null) return;
if(Array.prototype.forEach && obj.forEach === Array.prototype.forEach) {
obj.forEach(iterator, context);
} else if(obj.length === +obj.length) {
for(var i = 0, length = obj.length; i < length; i++) {
if(iterator.call(context, obj[i], i, obj) === breaker) return;
}
} else {
var keys = keys(obj);
for(var i = 0, length = keys.length; i < length; i++) {
if(iterator.call(context, obj[keys[i]], keys[i], obj) === breaker) return;
}
}
},
/**
* 模板引擎编译核心函数
* @param {String} tmplText 模板代码
* @param {Object} data 模板数据；可选
* @param {Et.tmplSettings} settings 引擎动态控制参数；可选
* @return {String|function} 如果 data 不为空，则返回 String 渲染结果；否则，返回一个编译后的 function 渲染函数
*/
template: function(tmplText, data, settings) {
if(settings){
// 临时定义
settings = defaults({}, settings, Et.tmplSettings);
settings={
script: new RegExp(settings.scriptBegin.replace(/(.)/g,"\\$1")+"([\\s\\S]+?)"+settings.scriptEnd.replace(/(.)/g,"\\$1"),"g"),
out: new RegExp(settings.outBegin.replace(/(.)/g,"\\$1")+"([\\s\\S]+?)"+settings.outEnd.replace(/(.)/g,"\\$1"),"g"),
escapeOut: new RegExp(settings.escapeOutBegin.replace(/(.)/g,"\\$1")+"([\\s\\S]+?)"+settings.escapeOutEnd.replace(/(.)/g,"\\$1"),"g"),
};
}else{
// 模板标签
if(!cacheTmplSettings){
cacheTmplSettings={
script: new RegExp(Et.tmplSettings.scriptBegin.replace(/(.)/g,"\\$1")+"([\\s\\S]+?)"+Et.tmplSettings.scriptEnd.replace(/(.)/g,"\\$1"),"g"),
out: new RegExp(Et.tmplSettings.outBegin.replace(/(.)/g,"\\$1")+"([\\s\\S]+?)"+Et.tmplSettings.outEnd.replace(/(.)/g,"\\$1"),"g"),
escapeOut: new RegExp(Et.tmplSettings.escapeOutBegin.replace(/(.)/g,"\\$1")+"([\\s\\S]+?)"+Et.tmplSettings.escapeOutEnd.replace(/(.)/g,"\\$1"),"g"),
};
}
settings=cacheTmplSettings;
}
tmplText = Et.unescape(tmplText);
var render;
var matcher = new RegExp([(settings.escapeOut || noMatch).source, (settings.out || noMatch).source, (settings.script || noMatch).source].join("|") + "|$", "g");
var index = 0;
var source = "_p+='";
tmplText.replace(matcher, function(match, escapeOut, out, script, offset) {
source += tmplText.slice(index, offset).replace(escaper, function(match) {
return "\\" + escapes[match];
});
if(escapeOut) {
source += "'+\n((_t=(" + escapeOut + "))==null?'':Et.escape(_t))+'";
}
if(out) {
//source += "'+((_t=(" + out+ "))==null?'':_t)+'";
// source += "'+" + out + "+'";
source += "'+\n((_t=(" + out+ "))==null?'':_t)+'";
}
if(script) {
source += "';" + script + "\n_p+='";
}
index = offset + match.length;
return match;
});
source += "';";
var vars=getVars(source);
source = "'use strict';" +vars+"_t,_p='',out=function(){_p+=Array.prototype.join.call(arguments, '')};" + source + "return _p";
try {
render = new Function("data", "Et", source);
} catch (e) {
e.source = "function anonymous(data,Et) {" + source + "}";;
throw e;
}
if(data) {
try{
return render(data, Et);
}catch(e){
console.error(e);
}
}
var template = function(data) {
try{
return render(data, Et);
}catch(e){
console.error(e);
}
};
return template;
},
/**
* 排除冲突
* @return {Et} Et 对象
*/
noConflict: function() {
if(root.Et === Et) {
root.Et = _Et;
}
return Et;
}
};
/*--------------------------------------------------------------------------*/
// Export Et
// AMD 和 CMD 兼容，定义模块
if (typeof define == 'function' && (define.amd || define.cmd)) {
// 1. 定义匿名模块
define([], function() {
return Et;
});
// 2. 定义命名模块
// define("Et", [], function() {
// return Et;
// });
}
// CommonJS 兼容（包含NodeJS）
else if(freeModule) {
// Node.js 兼容.
(freeModule.exports = Et).Et = Et;
// 其他 CommonJS 兼容.
freeExports.Et = Et;
} else {
// 非模块应用兼容，导出全局对象
root.Et = Et;
}
}.call(this));