fork the grunt plugin grunt-tmodjs and support java freemark template
npm install grunt-freemodfork the grunt plugin grunt-tmodjs and support java freemark template
前端模板预编译工具 tmodjs 的grunt自动化插件。
定义语法完全兼容tmod,区别仅在支持一些freemark的简易语法，如：
``
1. <#if vm.errorCode?? && vm.errorCode != "" >
......
<#else>
......
2. <#switch vm.errorCode>
<#case 'HOTEL_LONGCUI_LOGIN'>
......
<#break>
<#case 'HOTEL_PARAMETER_INVALID'>
......
<#break>
<#default>
......
3. <#list vm.invoiceMailingAddress as addr>
......
4. <#setting number_format="0.########"> (设置freemaker自身参数的)
如果你没有用过 Grunt , 可以先看一下 新手入门 指南, 里面有讲解怎么创建一个 Gruntfile 和如何使用grunt插件.
顺路推荐 : 中文版的grunt社区
安装插件:
shell
npm install grunt-freemod --save-dev
`安装完插件后要在gruntfile里面加上这句代码,载入这个插件:
js
grunt.loadNpmTasks('grunt-freemod');
`$3
## src
* 类型：
| Array模版文件
## dest
* 类型：
输出路径。
## options
支持tmodjs的配置，还新增如下字段：
#### options.base
* 类型：
指定模板的根目录，以便缩短编译后的模板id访问路径。
示例：
tmod: {
template: {
src: './tpl/src/*/.html',
dest: './dist/template.js',
options: {
base: './tpl/src'
}
}
}
以某个模板为例，默认情况调用模板的路径将可能会很长：
template('./tpl/src/home/main', data)
使用
后可以省略模板目录调用模板 template('home/main', data)
## 示例
### 基本
`
module.exports = function(grunt){ grunt.initConfig({
tmod: {
template: {
src: './tpl/*/.html',
dest: './dist/template.js',
options: {
combo: true
}
}
}
});
grunt.loadNpmTasks('grunt-freemod');
grunt.registerTask('default', ['tmod']);
};
### 监控模板修改即时编译
> 原tmodjs有配备的watch功能,在grunt中统一使用watch插件来实现,所以取消了grunt-tmodjs中的watch参数.具体设置方法可以参照下面带watch的配置示例,也可以参考grunt-contrib-watch官网的说明.
先安装watch插件
shell
npm install grunt-contrib-watch --save-dev
`
module.exports = function(grunt){ grunt.initConfig({
tmod: {
template: {
src: './tpl/*/.html',
dest: './dist/template.js',
options: {
combo: true
}
}
},
watch: {
template: {
files: '<%=tmod.template.src%>',
tasks: ['tmod'],
options: {
spawn: false
}
}
}
});
grunt.loadNpmTasks('grunt-freemod');
grunt.loadNpmTasks('grunt-contrib-watch');
grunt.registerTask('default', ['tmod', 'watch']);
};
### 使用调试模式编译
运行grunt任务的时候加上
参数即可： grunt --debug
Release History
v 0.2.0 遵循标准的 grunt 路径配置规范，同时支持编译错误显示。注意：不兼容历史版本 14-04-30
v 0.1.6 修复dest的路径问题 , 原本
dest属性是放在files属性里 , 0.1.6版本后建议将 dest 属性放在 option 中, 如本篇 readMe 的代码所示.
如果有多个模版文件目录需要配置,建议使用多个任务的方式来配置,不建议在src`中放入路径数组. 13-12-08v 0.1.5 修复不支持多任务的bug 13-11-14
v 0.1.4 去除掉打包的tmodjs改为依赖,将内置tmod依赖改为0.0.2版本 13-11-11
v 0.1.3 第二个版本,配合npm修改版本号,加上参数识别功能 13-11-10
v 0.0.1 第一个版本 13-10-23
The MIT license.