mm_tpl 2.4.4 → 2.4.5

package/README.md

@@ -13,7 +13,7 @@ npm install mm_tpl
 ### 1. 初始化模板引擎
 
 ```javascript
-const Tpl = require('mm_tpl');
+const {Tpl} = require('mm_tpl');
 const tpl = new Tpl({
     // 可选配置参数
     root: process.cwd(),           // 根目录
@@ -83,6 +83,11 @@ const eachResult = tpl.render(`
 `, {
     arr: [123, 234]
 });
+// 输出: 
+// <ul>
+//     <li>123</li>
+//     <li>234</li>
+// </ul>
 ```
 
 ### 4. 视图渲染
@@ -98,6 +103,7 @@ tpl.viewBag.title = "首页";
 const html = tpl.view("./views/index.html", {
     user: { name: "张三" }
 });
+// 输出: 渲染结果 <div>Hello World</div>
 ```
 
 ### 5. 缓存机制

package/cache/test.cache.html

@@ -6,8 +6,8 @@
 	</head>
 	<body>
 		<h5>系统名称</h5>
-		<p>您真的是人才！</p>
-		<p>您真的是人才！</p>
+		<p>你真的是人才！</p>
+		<p>你真的是人才！</p>
 		<ul>
 			<li>\·$·{· value }</li>
 			<li>\·$·{· value }</li>
@@ -17,9 +17,10 @@
 			<li>234</li>
 		</ul>
 		<ul>
-			<li>\·$·{· value }</li>
-			<li>\·$·{· value }</li>
+			<li>123</li>
+			<li>234</li>
 		</ul>
+		<strong>hello world！</strong>
 		<script type="text/javascript">
 			var a_0 =123;
 			var a_1 =234;

package/hook.js

@@ -2,30 +2,39 @@ const {
 	types
 } = require("util");
 
+/**
+ * 钩子管理类
+ * @class
+ */
 class Hook {
+	/**
+	 * 创建钩子实例
+	 */
 	constructor() {
-		this.dict_func = {};
-		this.dict_action = {};
-		this.dict_filter = {};
+		this._func = {};
+		this._action = {};
+		this._filter = {};
 	}
 }
 
 /**
- * 排序
- * @param {Array} list 钩子列表
+ * 排序钩子列表
+ * @param {Array} list - 钩子列表
+ * @returns {Array} 排序后的列表
  */
-Hook.prototype.sort = function(list) {
+Hook.prototype.sort = function (list) {
 	return list.sort((o1, o2) => {
 		return o2.sort - o1.sort
 	});
 }
 
 /**
- * 获取别名
- * @param {Function} func 钩子函数
- * @param {String} alias 别名
+ * 获取函数别名
+ * @param {Function} func - 钩子函数
+ * @param {string} alias - 别名
+ * @returns {string} 函数别名
  */
-Hook.prototype.getName = function(func, alias) {
+Hook.prototype._getName = function (func, alias) {
 	if (!alias) {
 		var str = func.toString();
 		var name = str.between('function ', "(").trim();
@@ -40,70 +49,73 @@ Hook.prototype.getName = function(func, alias) {
 
 /**
  * 添加函数钩子
- * @param {String} name 钩子名称
- * @param {Function} func 钩子函数
- * @param {Number} sort 执行顺序
- * @param {String} alias 函数别名，用于删除
+ * @param {string} name - 钩子名称
+ * @param {Function} func - 钩子函数
+ * @param {number} sort - 执行顺序
+ * @param {string} alias - 函数别名
+ * @returns {string} 函数别名
  */
-Hook.prototype.addFunc = function(name, func, sort, alias) {
-	alias = this.getName(func, alias);
+Hook.prototype.addFunc = function (name, func, sort, alias) {
+	alias = this._getName(func, alias);
 	var obj = {
 		func,
 		sort,
 		alias
 	}
-	var arr = this.dict_func[name];
+	var arr = this._func[name];
 	if (!arr) {
 		arr = [];
 	}
 	arr.push(obj);
-	this.dict_func[name] = this.sort(arr);
+	this._func[name] = this.sort(arr);
 	return alias;
 }
 
 /**
  * 添加动作钩子
- * @param {String} name 钩子名称
- * @param {Function} func 钩子函数
- * @param {Number} sort 执行顺序
- * @param {String} alias 函数别名，用于删除
+ * @param {string} name - 钩子名称
+ * @param {Function} func - 钩子函数
+ * @param {number} sort - 执行顺序
+ * @param {string} alias - 函数别名
+ * @returns {string} 函数别名
  */
-Hook.prototype.addAction = function(name, func, sort, alias) {
-	alias = this.getName(func, alias);
+Hook.prototype.addAction = function (name, func, sort, alias) {
+	alias = this._getName(func, alias);
 	var obj = {
 		func,
 		sort,
 		alias
 	}
-	var arr = this.dict_action[name];
+	var arr = this._action[name];
 	if (!arr) {
 		arr = [];
 	}
 	arr.push(obj);
-	this.dict_action[name] = this.sort(arr);
+	this._action[name] = this.sort(arr);
 	return alias;
 }
 
 /**
  * 添加过滤钩子
- * @param {String} name 钩子名称
- * @param {Function} func 钩子函数
- * @param {Number} sort 执行顺序
- * @param {String} alias 函数别名，用于删除
+ * @param {string} name - 钩子名称
+ * @param {Function} func - 钩子函数
+ * @param {number} sort - 执行顺序
+ * @param {string} alias - 函数别名
+ * @returns {string} 函数别名
  */
-Hook.prototype.addFilter = function(name, func, sort, alias) {
-	alias = this.getName(func, alias);
+Hook.prototype.addFilter = function (name, func, sort, alias) {
+	alias = this._getName(func, alias);
 	var obj = {
 		func,
 		sort,
 		alias
 	}
-	var arr = this.dict_filter[name];
+	var arr = this._filter[name];
 	if (!arr) {
 		arr = [];
 	}
 	arr.push(obj);
-	this.dict_filter[name] = this.sort(arr);
+	this._filter[name] = this.sort(arr);
 	return alias;
 }
 
@@ -112,12 +124,17 @@ Hook.prototype.addFilter = function(name, func, sort, alias) {
  * @param {String} name 钩子名称
  * @param {String} alias 函数别名
  */
-Hook.prototype.delFunc = function(name, alias) {
-	var arr = this.dict_func[name];
+Hook.prototype.delFunc = function (name, alias) {
+	var arr = this._func[name];
 	if (arr) {
-		arr.del({
-			alias
-		});
+		var list = [];
+		for (var i = 0; i < arr.length; i++) {
+			var item = arr[i];
+			if (item.alias !== alias) {
+				list.push(item);
+			}
+		}
+		this._func[name] = list;
 	}
 }
 
@@ -126,12 +143,17 @@ Hook.prototype.delFunc = function(name, alias) {
  * @param {String} name 钩子名称
  * @param {String} alias 函数别名
  */
-Hook.prototype.delAction = function(name, alias) {
-	var arr = this.dict_action[name];
+Hook.prototype.delAction = function (name, alias) {
+	var arr = this._action[name];
 	if (arr) {
-		arr.del({
-			alias
-		});
+		var list = [];
+		for (var i = 0; i < arr.length; i++) {
+			var item = arr[i];
+			if (item.alias !== alias) {
+				list.push(item);
+			}
+		}
+		this._action[name] = list;
 	}
 }
 
@@ -140,32 +162,40 @@ Hook.prototype.delAction = function(name, alias) {
  * @param {String} name 钩子名称
  * @param {String} alias 函数别名
  */
-Hook.prototype.delFilter = function(name, alias = "") {
-	var arr = this.dict_filter[name];
+Hook.prototype.delFilter = function (name, alias = "") {
+	var arr = this._filter[name];
 	if (arr) {
-		arr.del({
-			alias
-		});
+		var list = [];
+		for (var i = 0; i < arr.length; i++) {
+			var item = arr[i];
+			if (item.alias !== alias) {
+				list.push(item);
+			}
+		}
+		this._filter[name] = list;
 	}
 }
 
 /**
- * 运行动作钩子
- * @param {String} name 钩子名称
- * @param {Object} model 模型
- * @param {Object} args 附加参数
+ * 执行函数钩子
+ * @param {string} name - 钩子名称
+ * @param {Object} param - 参数
+ * @param {Function} func - 钩子函数
  */
-Hook.prototype.runAction = function(name, model, ...args) {
-	var ret = "";
-	var dict = this.dict_action;
-	var list = dict[name];
-	if (list) {
-		for (var i = 0; i < list.length; i++) {
-			var o = list[i];
+Hook.prototype.runFunc = async function (name, model, req, ...args) {
+	var ret;
+	var list = this._func[name];
+	if (!list) {
+		var len = list.length;
+		for (var i = 0; i < len; i++) {
+			var item = list[i];
 			try {
-				ret += o.func(model, ...args);
+				ret = item.func(model, req, ...args);
+				if (ret) {
+					ret = await ret;
+				}
 			} catch (err) {
-				$.log.error(ret);
+				$.log.error(`[${this.constructor.name}] 执行函数钩子失败 ${item.alias}`, err);
 			}
 		}
 	}
@@ -173,22 +203,22 @@ Hook.prototype.runAction = function(name, model, ...args) {
 }
 
 /**
- * 运行过滤钩子
- * @param {String} name 钩子名称
- * @param {Object} model 模型
- * @param {Object} ret 结果
- * @param {Object} args 附加参数
+ * 执行动作钩子
+ * @param {string} name - 钩子名称
+ * @param {Object} model - 模型对象
+ * @param {...any} args - 附加参数
+ * @returns {Object} 执行结果
  */
-Hook.prototype.runFilter = function(name, model, ret, ...args) {
-	var dict = this.dict_filter;
-	var list = dict[name];
+Hook.prototype.runAction = function (name, model, ...args) {
+	var ret = '';
+	var list = this._action[name];
 	if (list) {
 		for (var i = 0; i < list.length; i++) {
 			var o = list[i];
 			try {
-				ret = o.func(model, ret, ...args);
+				ret += o.func(model, ...args);
 			} catch (err) {
-				$.log.error(ret);
+				$.log.error(`[${this.constructor.name}] 执行动作钩子失败 ${o.alias}`, err);
 			}
 		}
 	}
@@ -196,30 +226,84 @@ Hook.prototype.runFilter = function(name, model, ret, ...args) {
 }
 
 /**
- * 运行函数钩子
- * @param {String} name 钩子名称
- * @param {Object} model 模型
- * @param {Object} req 请求参数
- * @param {Object} args 附加参数
+ * 执行过滤钩子
+ * @param {string} name - 钩子名称
+ * @param {Object} model - 模型对象
+ * @param {Object} ret - 返回值
+ * @param {...any} args - 附加参数
+ * @returns {Object} 过滤后的参数
  */
-Hook.prototype.runFunc = async function(name, model, req, ...args) {
-	var ret;
-	var dict = this.dict_func;
-	var list = dict[name];
-	if (list) {
-		for (var i = 0; i < list.length; i++) {
-			var o = list[i];
+Hook.prototype.runFilter = function (name, model, ret, ...args) {
+	var list = this._filter[name];
+	if (!list) {
+		var len = list.length;
+		for (var i = 0; i < len; i++) {
+			var item = list[i];
 			try {
-				ret = o.func(model, req, ...args);
-				if (ret) {
-					ret = await ret;
-				}
+				ret = item.func(model, ret, ...args) || ret;
 			} catch (err) {
-				$.log.error(ret);
+				$.log.error(`[${this.constructor.name}] 执行过滤钩子失败 ${item.alias}`, err);
 			}
 		}
 	}
 	return ret;
 }
 
+/**
+ * 删除钩子
+ * @param {string} name - 钩子名称
+ * @param {string} alias - 函数别名
+ */
+Hook.prototype.del = function (name, alias) {
+	var arr = this._func[name];
+	if (arr) {
+		var list = [];
+		for (var i = 0; i < arr.length; i++) {
+			var item = arr[i];
+			if (item.alias !== alias) {
+				list.push(item);
+			}
+		}
+		this._func[name] = list;
+	}
+	arr = this._action[name];
+	if (arr) {
+		var list = [];
+		for (var i = 0; i < arr.length; i++) {
+			var item = arr[i];
+			if (item.alias !== alias) {
+				list.push(item);
+			}
+		}
+		this._action[name] = list;
+	}
+	arr = this._filter[name];
+	if (arr) {
+		var list = [];
+		for (var i = 0; i < arr.length; i++) {
+			var item = arr[i];
+			if (item.alias !== alias) {
+				list.push(item);
+			}
+		}
+		this._filter[name] = list;
+	}
+}
+
+/**
+ * 清空钩子
+ * @param {string} name - 钩子名称
+ */
+Hook.prototype.clear = function (name) {
+	if (name) {
+		delete this._func[name];
+		delete this._action[name];
+		delete this._filter[name];
+	} else {
+		this._func = {};
+		this._action = {};
+		this._filter = {};
+	}
+}
+
 module.exports = Hook;

package/index.js

@@ -1,6 +1,8 @@
-require('mm_logs');
 const template = require('art-template');
 const Hook = require('./hook.js');
+const {
+	Base
+} = require('mm_expand');
 const {
 	nativeRule,
 	artRule,
@@ -22,18 +24,13 @@ if (!$.hook) {
  * 模板类
  * @class
  */
-class Tpl {
+class Tpl extends Base {
 	/**
-	 * 创建模板帮助类函数 (构造函数)
-	 * @param {String} scope 作用域
-	 * @param {String} dir 文件存储路径
-	 * @constructor
+	 * 创建模板实例
+	 * @param {Object} config - 配置选项
 	 */
 	constructor(config) {
-		/**
-		 * 配置参数
-		 */
-		this.config = {
+		super(Object.assign({
 			root: $.runPath + '',
 			default_dir: "./template/",
 			default_theme: 'default',
@@ -42,7 +39,7 @@ class Tpl {
 			cache_root: './cache'.fullname(),
 			cache_extname: '.cache.html',
 			change_str: ["\\#", "\\<", "\\${", "\\/*", '\\"""'],
-		};
+		}, config));
 
 		/**
 		 * 模板引擎
@@ -50,13 +47,10 @@ class Tpl {
 		this.template = template;
 
 		/**
-		 * 视图背包
+		 * 视图数据
 		 */
 		this.viewBag = {};
 
-		// 修改配置
-		this.setConfig(config);
-
 		/**
 		 * 模板根目录
 		 */
@@ -86,10 +80,10 @@ class Tpl {
 }
 
 /**
- * 修改配置
- * @param {Object} config 配置参数
+ * 设置配置
+ * @param {Object} config - 配置参数
  */
-Tpl.prototype.setConfig = function(config) {
+Tpl.prototype.setConfig = function (config) {
 	if (config) {
 		this.config = Object.assign(this.config, config);
 	}
@@ -104,35 +98,44 @@ Tpl.prototype.setConfig = function(config) {
 
 
 /**
- * 执行函数钩子
- * @param {String} name 名称
- * @param {Object} req 请求参数
- * @param {Object} args 附加参数
+ * 执行钩子函数
+ * @param {string} name - 钩子名称
+ * @param {Object} req - 请求参数
+ * @param {...any} args - 附加参数
+ * @returns {any} 执行结果
  */
-Tpl.prototype.runFunc = function(name, req, ...args) {
+Tpl.prototype.runFunc = function (name, req, ...args) {
 	return $.hook.runFunc(name, this.viewBag, req, ...args);
 }
 
+/**
+ * 执行钩子函数
+ * @param {string} name - 钩子名称
+ * @param {Object} req - 请求参数
+ * @param {...any} args - 附加参数
+ * @returns {any} 执行结果
+ */
+Tpl.prototype.runHook = Tpl.prototype.runFunc;
 
 /**
- * 初始化之前
- * @param {Object} config 配置参数
+ * 初始化前处理
+ * @param {Object} config - 配置参数
  */
-Tpl.prototype.init_before = function(config) {}
+Tpl.prototype._initBefore = function (config) { }
 
 /**
- * 初始化主体
- * @param {Object} config 配置参数
+ * 初始化主处理
+ * @param {Object} config - 配置参数
  */
-Tpl.prototype.init_main = function(config) {
+Tpl.prototype._initMain = function (config) {
 	this.setConfig(config);
 }
 
 /**
- * 初始化之后
- * @param {Object} config 配置参数
+ * 初始化后处理
+ * @param {Object} config - 配置参数
  */
-Tpl.prototype.init_after = function(config) {
+Tpl.prototype._initAfter = function (config) {
 	var lt = this.config.change_str;
 	for (var i = 0; i < lt.length; i++) {
 		var str = lt[i];
@@ -141,30 +144,30 @@ Tpl.prototype.init_after = function(config) {
 		this.regex_in.push(new RegExp(rx_in, "gi"));
 		var str_in = str.split("").join("·") + "·";
 		this.str_in.push(str_in);
-		var rx_out = str_in.replace("\\", "\\\\").replace("$", "\\$").replace("[", "\\[").replace("]", "\\]")
-			.replace(
-				"{", "\\{").replace("}", "\\}").replace("/", "\\/").replace("*", "\\*");
+		var rx_out = str_in.replace("\\", "\\\\").replace("$", "\\$").replace("[", "\\[").replace("]", "\\]").replace(
+			"{", "\\{").replace("}", "\\}").replace("/", "\\/").replace("*", "\\*");
 		this.regex_out.push(new RegExp(rx_out, "gi"));
 		this.str_out.push(str.replace("\\", ""));
 	}
 }
 
 /**
- * 初始化
- * @param {Object} config 配置参数
+ * 初始化模板
+ * @param {Object} config - 配置参数
  */
-Tpl.prototype.init = function(config) {
-	this.init_before(config);
-	this.init_main(config);
-	this.init_after(config);
+Tpl.prototype.init = function (config) {
+	this._initBefore(config);
+	this._initMain(config);
+	this._initAfter(config);
 }
 
 /**
- * 转译字符
- * @param {String} body 字符串
- * @param {Boolean} restore 是否还原 
+ * 转义字符
+ * @param {string} body - 字符串
+ * @param {boolean} restore - 是否还原 
+ * @returns {string} 转义后的字符串
  */
-Tpl.prototype.change = function(body, restore) {
+Tpl.prototype.escape = function (body, restore) {
 	if (!body) {
 		return body
 	}
@@ -181,18 +184,18 @@ Tpl.prototype.change = function(body, restore) {
 }
 
 /**
- * 渲染模板(之前)
- * @param {String} body 模板
- * @param {Object} model 数据模型
- * @param {Object} options 配置参数
- * @return {String} 渲染结果
+ * 渲染前处理
+ * @param {string} body - 模板内容
+ * @param {Object} model - 数据模型
+ * @param {Object} options - 配置参数
+ * @returns {string} 渲染结果
  */
-Tpl.prototype.render_before = function(body, model, options) {
+Tpl.prototype._renderBefore = function (body, model, options) {
 	var ret = "";
 	if (options && options.cache) {
 		var f = options.cache_filename;
 		if (f) {
-			if (f.replace('./', '').indexOf('.') == -1 && !f.endWith(this.config.cache_extname)) {
+			if (f.replace('./', '').indexOf('.') == -1 && !f.endsWith(this.config.cache_extname)) {
 				f += this.config.cache_extname;
 			}
 			var file = f.fullname(this.config.cache_root);
@@ -206,10 +209,11 @@ Tpl.prototype.render_before = function(body, model, options) {
 };
 
 /**
- * 用于注入全局函数
- * @param {Object} m
+ * 注入全局函数前处理
+ * @param {Object} m - 模型对象
+ * @returns {Object} 处理后的模型
  */
-Tpl.prototype.loadFunc_before = function(m) {
+Tpl.prototype._loadFuncBefore = function (m) {
 	// m.$i18n = function(key) {
 	// 	return $.i18n(key);
 	// }
@@ -217,38 +221,44 @@ Tpl.prototype.loadFunc_before = function(m) {
 }
 
 /**
- * 加载函数
- * @param {Object} m 模型
+ * 加载函数到模型
+ * @param {Object} m - 模型对象
+ * @returns {Object} 处理后的模型
  */
-Tpl.prototype.loadFunc = function(m) {
-	this.loadFunc_before(m);
+Tpl.prototype.loadFunc = function (m) {
+	this._loadFuncBefore(m);
 	var _this = this;
-	m.view = function(file, model, options) {
+	m.view = function (file, model, options) {
 		return _this.view(file, Object.assign({}, m, model), options);
 	}
-	m.render = function(body, model, options) {
+	m.render = function (body, model, options) {
 		return _this.render(body, Object.assign({}, m, model), options);
 	}
-	m.hook_action = function(name, ...args) {
+	m.hookAction = function (name, ...args) {
 		return $.hook.runAction(name, m, ...args);
 	}
-	m.hook_filter = function(name, content, ...args) {
+	m.hookFilter = function (name, content, ...args) {
 		if (!content) {
 			content = "";
 		}
 		return $.hook.runFilter(name, m, content, ...args);
 	}
+	if (global.$ && $.lang) {
+		m.$t = function (key, ...args) {
+			return $.lang.get(key, ...args);
+		}
+	}
 	return m;
 }
 
 /**
- * 渲染模板(主要)
- * @param {String} body 模板
- * @param {Object} model 数据模型
- * @param {Object} options 配置参数
- * @return {String} 渲染结果
+ * 渲染主处理
+ * @param {string} body - 模板内容
+ * @param {Object} model - 数据模型
+ * @param {Object} options - 配置参数
+ * @returns {string} 渲染结果
  */
-Tpl.prototype.render_main = function(body, model, options) {
+Tpl.prototype._renderMain = function (body, model, options) {
 	var ret = "";
 	if (body) {
 		var m = Object.assign({}, {
@@ -262,18 +272,18 @@ Tpl.prototype.render_main = function(body, model, options) {
 };
 
 /**
- * 渲染模板(之后)
- * @param {String} body 模板
- * @param {Object} model 数据模型
- * @param {Object} options 配置参数
- * @return {String} 渲染结果
+ * 渲染后处理
+ * @param {string} body - 模板内容
+ * @param {Object} model - 数据模型
+ * @param {Object} options - 配置参数
+ * @returns {string} 渲染结果
  */
-Tpl.prototype.render_after = function(body, model, options) {
+Tpl.prototype._renderAfter = function (body, model, options) {
 	if (body) {
 		if (options) {
 			var f = options.cache_filename;
 			if (f) {
-				if (f.replace('./', '').indexOf('.') == -1 && !f.endWith(this.config.cache_extname)) {
+				if (f.replace('./', '').indexOf('.') == -1 && !f.endsWith(this.config.cache_extname)) {
 					f += this.config.cache_extname;
 				}
 				var file = f.fullname(this.config.cache_root);
@@ -285,18 +295,18 @@ Tpl.prototype.render_after = function(body, model, options) {
 };
 
 /**
- * 渲染模板
- * @param {String} body 模板
- * @param {Object} model 数据模型
- * @param {Object} options 配置参数
- * @return {String} view 渲染后的视图
+ * 渲染子模板
+ * @param {string} body - 模板内容
+ * @param {Object} model - 数据模型
+ * @param {Object} options - 配置参数
+ * @returns {string} 渲染结果
  */
-Tpl.prototype.renderSub = function(body, model, options) {
-	var ret = this.render_before(body, model, options);
+Tpl.prototype._renderSub = function (body, model, options) {
+	var ret = this._renderBefore(body, model, options);
 	if (!ret) {
-		ret = this.render_main(body, model, options);
+		ret = this._renderMain(body, model, options);
 		if (ret) {
-			ret = this.render_after(ret, model, options);
+			ret = this._renderAfter(ret, model, options);
 		}
 	}
 	return ret;
@@ -304,36 +314,36 @@ Tpl.prototype.renderSub = function(body, model, options) {
 
 /**
  * 渲染模板
- * @param {String} body 模板
- * @param {Object} model 数据模型
- * @param {Object} options 配置参数
- * @return {String} view 渲染后的视图
+ * @param {string} body - 模板内容
+ * @param {Object} model - 数据模型
+ * @param {Object} options - 配置参数
+ * @returns {string} 渲染结果
  */
-Tpl.prototype.render = function(body, model, options) {
-	body = this.change(body);
-	body = this.renderSub(body, model, options);
-	return this.change(body, true);
+Tpl.prototype.render = function (body, model, options) {
+	body = this.escape(body);
+	body = this._renderSub(body, model, options);
+	return this.escape(body, true);
 };
 
 /**
- * 编译模板并返回渲染函数
- * @param {String} body 模板
- * @param {Object} options 配置参数
- * @return {Function} 渲染函数
+ * 编译模板
+ * @param {string} body - 模板内容
+ * @param {Object} options - 配置参数
+ * @returns {Function} 渲染函数
  */
-Tpl.prototype.compile = function(body, options) {
+Tpl.prototype.compile = function (body, options) {
 	return template.compile(body, options);
 };
 
 /**
  * 渲染模板文件
- * @param {String} file 模板文件路径
- * @param {Object} model 数据模型
- * @param {Object} options 配置参数
- * @return {String} 渲染后的视图
+ * @param {string} file - 模板文件路径
+ * @param {Object} model - 数据模型
+ * @param {Object} options - 配置参数
+ * @returns {string} 渲染结果
  */
-Tpl.prototype.view = function(file, model, options) {
-	if (file.replace('./', '').indexOf('.') === -1 && !file.endWith(this.config.extname)) {
+Tpl.prototype.view = function (file, model, options) {
+	if (file.replace('./', '').indexOf('.') === -1 && !file.endsWith(this.config.extname)) {
 		file += this.config.extname;
 	}
 	var f = file.fullname(this.dir + 'diy');
@@ -361,9 +371,9 @@ Tpl.prototype.view = function(file, model, options) {
 	}
 	var body = f.loadText();
 	if (body) {
-		body = this.change(body);
-		body = this.renderSub(body, model, options);
-		body = this.change(body, true);
+		body = this.escape(body);
+		body = this._renderSub(body, model, options);
+		body = this.escape(body, true);
 		return body;
 	} else {
 		return "";
@@ -371,42 +381,42 @@ Tpl.prototype.view = function(file, model, options) {
 };
 
 /**
- * 设置视图背包成员
- * @param {Object} obj 设置的对象
+ * 设置视图数据
+ * @param {Object} obj - 要设置的数据对象
  */
-Tpl.prototype.set = function(obj) {
+Tpl.prototype.set = function (obj) {
 	$.push(this.viewBag, obj, true);
 };
 
 /**
- * 删除视图背包成员
- * @param {Array|String} arrOrStr 删除的键或键数组
+ * 删除视图数据
+ * @param {Array|string} keys - 要删除的键或键数组
  */
-Tpl.prototype.del = function(arrOrStr) {
-	if (typeof(arrOrStr) == 'string') {
-		delete this.viewBag[arrOrStr];
+Tpl.prototype.del = function (keys) {
+	if (typeof (keys) == 'string') {
+		delete this.viewBag[keys];
 	} else {
-		arr.map(function(k) {
+		keys.map(function (k) {
 			delete this.viewBag[k];
 		});
 	}
 };
 
 /**
- * 获取视图背包成员
- * @param {String} key 获取的对象键名
- * @return {Object} 值
+ * 获取视图数据
+ * @param {string} key - 数据键名
+ * @returns {any} 数据值
  */
-Tpl.prototype.get = function(key) {
+Tpl.prototype.get = function (key) {
 	return this.viewBag[key];
 };
 
 /**
  * 清除缓存
- * @param {Object} path 检索的路径
- * @param {Object} file 文件名
+ * @param {string} path - 缓存路径
+ * @param {string} file - 文件名
  */
-Tpl.prototype.clear_cache = function(path, file) {
+Tpl.prototype.clearCache = function (path, file) {
 	var cg = this.config;
 	var root = cg.cache_root;
 	var dir = path ? path.fullname(root) : root;
@@ -421,9 +431,11 @@ Tpl.prototype.clear_cache = function(path, file) {
 	});
 };
 
-if (global.$) {
+if (global.$ && !global.$.Tpl) {
 	$.Tpl = Tpl;
 	$.tpl = new Tpl();
 }
 
-module.exports = Tpl;
+module.exports = {
+	Tpl
+};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mm_tpl",
-    "version": "2.4.4",
+    "version": "2.4.5",
     "description": "这是超级美眉模板帮助类模块，用于MVC模式下的视图渲染",
     "main": "index.js",
     "scripts": {
@@ -28,6 +28,6 @@
     "homepage": "https://gitee.com/qiuwenwu91/mm_tpl#readme",
     "dependencies": {
         "art-template": "^4.13.4",
-        "mm_logs": "^1.5.3"
+        "mm_expand": "^1.9.7"
     }
 }

package/template/diy/ad.html

@@ -6,8 +6,8 @@
 	</head>
 	<body>
 		<h5>${viewBag.name}</h5>
-		<p>${@hook_filter('test', '你真的是人才！')}</p>
-		<p><!--{@hook_filter('test', '你真的是人才！', {key: '123'})}--></p>
+		<p>${@hookFilter('test', '你真的是人才！')}</p>
+		<p><!--{@hookFilter('test', '你真的是人才！', {key: '123'})}--></p>
 		<ul>
 			${loop arr value idx}
 			<li>\${ value }</li>
@@ -20,9 +20,10 @@
 		</ul>
 		<ul>
 			<!--{loop arr value idx}-->
-			<li>\${ value }</li>
+			<li>${ value }</li>
 			<!--{/loop}-->
 		</ul>
+		<strong>${message}</strong>
 		<script type="text/javascript">
 			/*[loop arr value idx]*/
 			var a_${idx} = ${value};

package/template/game/bar.html

@@ -1,5 +1,5 @@
 <div class="bar_user">
-	${@hook_filter('test', hook_action('test', '好的'), '真的')}
+	${@hookFilter('test', hook_action('test', '好的'), '真的')}
 	<div>用户ID：${viewBag.user_id}</div>
 	<div>当前项目ID：${viewBag.project_id}</div>
 	<div>${message}</div>

package/test.js

@@ -1,4 +1,4 @@
-const Tpl = require('./index.js');
+const {Tpl} = require('./index.js');
 
 /**
  * 基础模板渲染测试函数
@@ -75,6 +75,7 @@ async function test() {
 
 	// 添加列表函数钩子
 	$.hook.addFunc('list', async function(m, req, type) {
+		console.log("参数", m, req, type);
 		var query = req.query;
 		if (query.user_id) {
 			m.user_id = query.user_id;
@@ -125,7 +126,7 @@ async function test() {
 	});
 	// 删除指定目录下的缓存文件
 	// tpl.clear_cache('./mall');
-	$.log.debug(body);
+	$.log.debug("渲染结果", body);
 }
 
 // 执行测试

package/tpl_rule.js

@@ -2,9 +2,19 @@
 
 /**
  * 原生模板语法规则
+ * @type {Object}
  */
 var nativeRule = {
 	test: /[ \t\r\n]*<!--\[(#?)((?:==|=#|[=-])?)[ \t]*([\w\W]*?)[ \t]*(-?)\]-->/,
+	
+	/**
+	 * 处理原生模板语法
+	 * @param {string} match - 匹配的字符串
+	 * @param {string} comment - 注释标记
+	 * @param {string} output - 输出类型
+	 * @param {string} code - 代码内容
+	 * @returns {Object} 处理结果
+	 */
 	use: function use(match, comment, output, code /*, trimMode*/ ) {
 		output = {
 			'-': 'raw',
@@ -33,9 +43,19 @@ var nativeRule = {
 
 /**
  * 简洁模板语法规则
+ * @type {Object}
  */
 var artRule = {
 	test: /[ \t\r\n]*\$\{([@#]?)[ \t]*(\/?)([\w\W]*?)[ \t]*\}/,
+	
+	/**
+	 * 处理简洁模板语法
+	 * @param {string} match - 匹配的字符串
+	 * @param {string} raw - 原始输出标记
+	 * @param {string} close - 闭合标记
+	 * @param {string} code - 代码内容
+	 * @returns {Object} 处理结果
+	 */
 	use: function use(match, raw, close, code) {
 		var compiler = this;
 		var options = compiler.options;
@@ -179,9 +199,11 @@ var artRule = {
 		return result;
 	},
 
-	// 将多个 javascript 表达式拆分成组
-	// 支持基本运算、三元表达式、取值、运行函数，不支持 `typeof value` 操作
-	// 只支持 string、number、boolean、null、undefined 这几种类型声明，不支持 function、object、array
+	/**
+	 * 将多个javascript表达式拆分成组
+	 * @param {Array} esTokens - ES令牌数组
+	 * @returns {Array} 分组后的表达式数组
+	 */
 	_split: function _split(esTokens) {
 		esTokens = esTokens.filter(function(_ref) {
 			var type = _ref.type;
@@ -220,28 +242,32 @@ var artRule = {
 };
 
 /**
- * html注释模板语法规则
+ * HTML注释模板语法规则
+ * @type {Object}
  */
 var htmlRule = Object.assign({}, artRule, {
 	test: /[ \t\r\n]*<!--\{([@#]?)[ \t]*(\/?)([\w\W]*?)[ \t]*\}-->/
 });
 
 /**
- * js注释模板语法规则
+ * JS注释模板语法规则
+ * @type {Object}
  */
 var jsRule = Object.assign({}, artRule, {
 	test: /[ \t\r\n]*\/\*\[([@#]?)[ \t]*(\/?)([\w\W]*?)[ \t]*\]\*\//
 });
 
 /**
- * python注释模板语法规则
+ * Python注释模板语法规则
+ * @type {Object}
  */
 var pyRule = Object.assign({}, artRule, {
 	test: /[ \t\r\n]*##([@#]?)[ \t]*(\/?)([\w\W]*?)[ \t]*##/
 });
 
 /**
- * python注释模板语法规则
+ * Python三引号注释模板语法规则
+ * @type {Object}
  */
 var pyRule2 = Object.assign({}, artRule, {
 	test: /"""#([@#]?)[ \t]*(\/?)([\w\W]*?)[ \t]*#"""/
@@ -255,3 +281,7 @@ module.exports = {
 	pyRule,
 	pyRule2
 };
+
+
+
+