mm_tpl 2.4.1 → 2.4.3

package/README.md

@@ -1,167 +1,212 @@
-# mm_tpl
-
-这是超级美眉模板帮助类模块，用于MVC模式下的视图渲染。基于art-template模板引擎，提供了更强大的模板渲染功能。
-
-## 安装
-
-```bash
-npm install mm_tpl
-```
-
-## 基本使用
-
-### 1. 初始化模板引擎
-
-```javascript
-const Tpl = require('mm_tpl');
-const tpl = new Tpl({
-    // 可选配置参数
-    root: process.cwd(),           // 根目录
-    default_dir: "./template/",    // 默认模板目录
-    default_theme: 'default',      // 默认主题
-    extname: ".html",             // 模板文件扩展名
-    cache_root: './cache',        // 缓存目录
-    cache_extname: '.cache.html'  // 缓存文件扩展名
-});
-```
-
-### 2. 基础模板渲染
-
-```javascript
-// 简单变量替换
-const result = tpl.render("<div>${message}</div>", {
-    message: "Hello World"
-});
-
-// 输出: <div>Hello World</div>
-```
-
-### 3. 循环渲染
-
-```javascript
-// 数组循环
-const arrayResult = tpl.render(`
-    <ul>
-        ${loop arr value idx}
-            <li>${idx}: ${value}</li>
-        ${/loop}
-    </ul>
-`, { 
-    arr: [123, 234] 
-});
-
-// 对象循环
-const objectResult = tpl.render(`
-    <dl>
-        ${loop obj value key}
-            <dt>${key}</dt>
-            <dd>${value}</dd>
-        ${/loop}
-    </dl>
-`, { 
-    obj: { name: "张三", age: 25 } 
-});
-```
-
-### 4. 视图渲染
-
-```javascript
-// 设置全局变量
-$.globalBag.siteName = "我的网站";
-
-// 设置视图变量
-tpl.viewBag.title = "首页";
-
-// 渲染视图文件
-const html = tpl.view("./views/index.html", {
-    user: { name: "张三" }
-});
-```
-
-### 5. 缓存机制
-
-```javascript
-// 使用缓存渲染视图
-const html = tpl.view("./views/page", {
-    data: someData
-}, {
-    cache: true,                // 是否使用缓存
-    cache_filename: "./cache"   // 缓存文件名
-});
-
-// 清除指定目录的缓存
-tpl.clear_cache('./views/mall');
-```
-
-### 6. 钩子系统
-
-#### 添加函数钩子
-```javascript
-$.hook.addFunc('list', async function(viewBag, req, type) {
-    // 处理列表逻辑
-    return someData;
-});
-```
-
-#### 添加动作钩子
-```javascript
-$.hook.addAction('header', function(viewBag, param) {
-    return "<header>网站头部</header>";
-}, 1, "headerAction");
-```
-
-#### 添加过滤器钩子
-```javascript
-$.hook.addFilter('content', function(viewBag, content, param) {
-    return content.replace("旧文本", "新文本");
-}, 1, "contentFilter");
-```
-
-#### 使用钩子
-```javascript
-// 运行函数钩子
-await tpl.runFunc('list', {
-    query: { page: 1 }
-}, 'article');
-
-// 在模板中使用动作钩子
-${hook_action('header')}
-
-// 在模板中使用过滤器钩子
-${hook_filter('content', '原始内容')}
-```
-
-## 高级特性
-
-### 1. 主题支持
-```javascript
-// 设置当前主题
-tpl.current_theme = "dark";
-```
-
-### 2. 模板规则
-模块内置支持多种模板规则，包括：
-- nativeRule: 原生语法规则
-- artRule: art-template语法规则
-- htmlRule: HTML注释语法规则
-- jsRule: JavaScript语法规则
-- pyRule: Python风格语法规则
-
-### 3. 错误处理
-```javascript
-const html = tpl.view("./template.html", data);
-if (tpl.error) {
-    console.error("渲染错误:", tpl.error);
-}
-```
-
-## 注意事项
-
-1. 确保模板目录具有正确的读写权限
-2. 使用缓存时注意及时清理过期缓存
-3. 钩子的优先级数值越小，执行顺序越靠前
-4. 建议在生产环境开启模板缓存以提高性能
-
-## 许可证
-
+# mm_tpl
+
+这是超级美眉模板帮助类模块，用于MVC模式下的视图渲染。基于art-template模板引擎，提供了更强大的模板渲染功能。
+
+## 安装
+
+```bash
+npm install mm_tpl
+```
+
+## 基本使用
+
+### 1. 初始化模板引擎
+
+```javascript
+const Tpl = require('mm_tpl');
+const tpl = new Tpl({
+    // 可选配置参数
+    root: process.cwd(),           // 根目录
+    default_dir: "./template/",    // 默认模板目录
+    default_theme: 'default',      // 默认主题
+    extname: ".html",             // 模板文件扩展名
+    cache_root: './cache',        // 缓存目录
+    cache_extname: '.cache.html'  // 缓存文件扩展名
+});
+```
+
+### 2. 基础模板渲染
+
+```javascript
+// 简单变量替换
+const result = tpl.render("<div>${message}</div>", {
+    message: "Hello World"
+});
+
+// 输出: <div>Hello World</div>
+```
+
+### 3. 循环渲染
+
+```javascript
+// 数组循环
+const arrayResult = tpl.render(`
+    <ul>
+        ${loop arr value idx}
+            <li>${idx}: ${value}</li>
+        ${/loop}
+    </ul>
+`, { 
+    arr: [123, 234] 
+});
+
+// 对象循环
+const objectResult = tpl.render(`
+    <dl>
+        ${loop obj value key}
+            <dt>${key}</dt>
+            <dd>${value}</dd>
+        ${/loop}
+    </dl>
+`, { 
+    obj: { name: "张三", age: 25 } 
+});
+
+// 传统for循环
+const forResult = tpl.render(`
+    <ul>
+        <!--[ for(var i = 0; i < arr.length; i++){ ]-->
+            <li>${arr[i]}</li>
+        <!--[ } ]-->
+    </ul>
+`, {
+    arr: [123, 234]
+});
+
+// each循环
+const eachResult = tpl.render(`
+    <ul>
+        ${each arr}
+            <li>${$value}</li>
+        ${/each}
+    </ul>
+`, {
+    arr: [123, 234]
+});
+```
+
+### 4. 视图渲染
+
+```javascript
+// 设置全局变量
+$.globalBag.siteName = "我的网站";
+
+// 设置视图变量
+tpl.viewBag.title = "首页";
+
+// 渲染视图文件
+const html = tpl.view("./views/index.html", {
+    user: { name: "张三" }
+});
+```
+
+### 5. 缓存机制
+
+```javascript
+// 使用缓存渲染视图
+const html = tpl.view("./views/page", {
+    data: someData
+}, {
+    cache: true,                // 是否使用缓存
+    cache_filename: "./cache"   // 缓存文件名
+});
+
+// 清除指定目录的缓存
+tpl.clear_cache('./views/mall');
+```
+
+### 6. 钩子系统
+
+#### 添加函数钩子
+```javascript
+$.hook.addFunc('list', async function(viewBag, req, type) {
+    // 处理列表逻辑
+    var query = req.query;
+    if (query.user_id) {
+        viewBag.user_id = query.user_id;
+    }
+    return someData;
+});
+```
+
+#### 添加动作钩子
+```javascript
+$.hook.addAction('header', function(viewBag, param) {
+    return "<header>网站头部</header>";
+}, 1, "headerAction");
+```
+
+#### 添加过滤器钩子
+```javascript
+$.hook.addFilter('content', function(viewBag, content, param) {
+    return content.replace("旧文本", "新文本");
+}, 1, "contentFilter");
+```
+
+#### 在模板中使用钩子
+```javascript
+// 运行函数钩子
+await tpl.runFunc('list', {
+    query: { page: 1 }
+}, 'article');
+
+// 在模板中使用动作钩子
+${hook_action('header')}
+
+// 在模板中使用过滤器钩子
+${hook_filter('content', '原始内容')}
+```
+
+## 高级特性
+
+### 1. 主题支持
+```javascript
+// 设置当前主题
+tpl.current_theme = "dark";
+```
+
+### 2. 模板规则
+模块内置支持多种模板规则，包括：
+- nativeRule: 原生语法规则
+- artRule: art-template语法规则
+- htmlRule: HTML注释语法规则
+- jsRule: JavaScript语法规则
+- pyRule: Python风格语法规则
+
+### 3. 错误处理
+```javascript
+const html = tpl.view("./template.html", data);
+if (tpl.error) {
+    console.error("渲染错误:", tpl.error);
+}
+```
+
+### 4. 视图背包操作
+```javascript
+// 设置视图变量
+tpl.set({
+    title: "页面标题",
+    keywords: "关键词"
+});
+
+// 获取视图变量
+const title = tpl.get("title");
+
+// 删除视图变量
+tpl.del("title");
+// 或批量删除
+tpl.del(["title", "keywords"]);
+```
+
+## 注意事项
+
+1. 确保模板目录具有正确的读写权限
+2. 使用缓存时注意及时清理过期缓存
+3. 钩子的优先级数值越小，执行顺序越靠前
+4. 建议在生产环境开启模板缓存以提高性能
+5. 模板文件查找顺序：diy > current_theme > default_theme
+6. 使用钩子系统时注意处理异步操作
+
+## 许可证
+
 MIT

package/cache/test.cache.html

@@ -0,0 +1,29 @@
+<!DOCTYPE html>
+<html>
+	<head>
+		<meta charset="utf-8">
+		<title>超级美眉Art模板引擎</title>
+	</head>
+	<body>
+		<h5>系统名称</h5>
+		<p>您真的是人才！</p>
+		<p>您真的是人才！</p>
+		<ul>
+			<li>\·$·{· value }</li>
+			<li>\·$·{· value }</li>
+		</ul>
+		<ul>
+			<li>123</li>
+			<li>234</li>
+		</ul>
+		<ul>
+			<li>\·$·{· value }</li>
+			<li>\·$·{· value }</li>
+		</ul>
+		<script type="text/javascript">
+			var a_0 =123;
+			var a_1 =234;
+		</script>系统名称计算
+		123123'priceNIHAO'#计算
+	</body>
+</html>

package/index.js

@@ -205,11 +205,23 @@ Tpl.prototype.render_before = function(body, model, options) {
 	return ret;
 };
 
+/**
+ * 用于注入全局函数
+ * @param {Object} m
+ */
+Tpl.prototype.loadFunc_before = function(m) {
+	// m.$i18n = function(key) {
+	// 	return $.i18n(key);
+	// }
+	return m;
+}
+
 /**
  * 加载函数
  * @param {Object} m 模型
  */
 Tpl.prototype.loadFunc = function(m) {
+	this.loadFunc_before(m);
 	var _this = this;
 	m.view = function(file, model, options) {
 		return _this.view(file, Object.assign({}, m, model), options);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mm_tpl",
-    "version": "2.4.1",
+    "version": "2.4.3",
     "description": "这是超级美眉模板帮助类模块，用于MVC模式下的视图渲染",
     "main": "index.js",
     "scripts": {
@@ -9,7 +9,7 @@
     },
     "repository": {
         "type": "git",
-        "url": "git+https://github.com/qiuwenwu/mm_tpl.git"
+        "url": "git+https://gitee.com/qiuwenwu91/mm_tpl.git"
     },
     "keywords": [
         "mvc",
@@ -23,11 +23,11 @@
     "author": "邱文武",
     "license": "ISC",
     "bugs": {
-        "url": "https://github.com/qiuwenwu/mm_tpl/issues"
+        "url": "https://gitee.com/qiuwenwu91/mm_tpl/issues"
     },
-    "homepage": "https://github.com/qiuwenwu/mm_tpl#readme",
+    "homepage": "https://gitee.com/qiuwenwu91/mm_tpl#readme",
     "dependencies": {
-        "art-template": "^4.13.2",
-        "mm_expand": "^1.7.9"
+        "art-template": "^4.13.4",
+        "mm_expand": "^1.8.3"
     }
 }

package/template/defualt/test.html

@@ -0,0 +1,36 @@
+<!DOCTYPE html>
+<html>
+	<head>
+		<meta charset="utf-8">
+		<title>${globalBag.name}</title>
+	</head>
+	<body>
+		<h5>${viewBag.name}</h5>
+		<ul>
+			${loop arr value idx}
+			<li>${ value }</li>
+			${/loop}
+		</ul>
+		<ul>
+			<!--[ for(var i = 0; i < arr.length; i++) { ]-->
+			<li>${ arr[i] }</li>
+			<!--[ } ]-->
+		</ul>
+		<ul>
+			<!--{loop arr value idx}-->
+			<li>${ value }</li>
+			<!--{/loop}-->
+		</ul>
+		<script type="text/javascript">
+			/*[loop arr value idx]*/
+			var a_${idx} = ${value};
+			/*[/loop]*/
+		</script>
+		${viewBag.name}
+		## "计算" ##
+		123123'"""#
+		"price" + "NIHAO"
+		#"""'
+		## "#计算" ##
+	</body>
+</html>

package/test.js

@@ -91,7 +91,7 @@ async function test() {
 	}, 2);
 
 	$.hook.addAction('test', function(m, param) {
-		return "<div>你好！</div>";
+		return "<div>你好！}</div>";
 	}, 1, "测试动作1");
 
 	// 添加过滤器钩子