在几天前的一篇文章中,我介绍了JavaScript的模块化加载框架SeaJS。目前SeaJS支持js和css的模块化加载。在实际应用中,可能会遇到需要加载html页面模板文件的场景,例如我接触的某些应用使用Template Toolkit(以下简称TT)写页面模板,然后由js载入TT模板后渲染输出,在这种纯JavaScript渲染的Web架构中,需要将tt文件(或其它格式html模板文件)作为模块载入。
实现这一点的基本的方法是将tt文件内容看做一个长字符串,然后封装为纯Json格式的模块:
由于JavaScript不支持类似于php heredoc那样的长字符串写法,所以手工做这种转换会比较纠结,而且还要处理特殊字符转义、html压缩等繁琐事情,当模板文件比较多时全手工实现费时费力还容易出错。所以我写了一个小工具temod,temod可以将html或tt等页面模板文件编译成符合CommonJS规范的module,这样任何实现了CommonJS规范的模块加载框架(如SeaJS)就可以将编译好的文件作为普通模板加载进来。
Temod目前托管在GitHub上,访问地址是:https://github.com/ericzy/temod
Temod使用简介
获取temod
获取temod有两种方式,一是通过Git获取整个temod git repository:
或者也可以通过这个地址直接下载temod.js脚本:https://raw.github.com/ericzy/temod/master/bin/temod.js。例如在linux下可以通过wget获取:
运行temod
Temod程序只有一个temod.js,这个脚本使用NodeJS写成,不需要任何安装,直接使用NodeJS执行即可:
node temod.js path/to/template/directory [option]
node temod.js path/to/template/directory [option] |
temod.js的第一个参数为必须参数,是模板文件所在目录,可选参数option有如下几个:
--compress=on|off ―― 是否开启html代码压缩。如果设为on,则temod会将整个模板文件压缩成一个不换行字符串;如果设为off,则会将模板文件中每一行转为一个字符串,这些字符串组成数组,通过join输出页面,保持所有html代码格式。一般来说,前者节省带宽,而后者传给客户端的html源代码可读性更好。默认开启压缩。
--encoding=utf-8 ―― 模板文件和输出文件的编码,默认为utf-8。
--ext=htm,html,tt,tpl,… ―― 模板文件扩展名。这个选项指定了所有模板文件的扩展名,如果文件在模板文件目录里但不包含指定的扩展名,则不会被编译。多个扩展名之间用英文逗号隔开。默认为htm,html,tt,tpl。
temod会自动遍历指定的模板目录,生成一个与其结构一致的目录,名称为原目录名加“_build”,其中包含了所有编译好的文件,文件名为源文件名加“.js”。
Temod使用示例
下面给一个temod的使用示例。
如上图所示,其中bin下放着temod.js,例子放在example下。example目录内部如下:
刚开始没有template_build,这是一个编译生成的目录。其中template下放有一个模板文件content.tt:
< p >This is a Temod Sample.</ p > |
现在到bin目录下运行如下命令:
node temod.js ../example/template
node temod.js ../example/template |
这会在example下生成template_build目录,里面有个content.tt.js文件,内容如下:
然后我们在js下写一个init.js模块,在这个模块中加载这个模板并做一些渲染操作:
define( function (require, exports, module) { |
var tpl = require( '../template_build/content.tt' ); |
document.body.innerHTML = tpl.html; |
最后在index.html中将init作为入口模块:
< title >Temod Sample</ title > |
< script src = "./js/sea.js" data-main = "./js/init" ></ script > |
访问index.html,则可看到如下效果:
如果不了解SeaJS,请看这篇文章:http://www.cnblogs.com/leoo2sk/archive/2011/06/27/write-javascript-with-seajs.html。
需要这个例子的完整代码可以访问https://github.com/ericzy/temod/tree/master/example。