API

template(filename, content)

根据模板名渲染模板。

• 参数：
  • {string} filename
  • {Object,string} content
• 返回值：
  • 如果 content 为 Object，则渲染模板并返回 string
  • 如果 content 为 string，则编译模板并返回 function

var html = template('/welcome.art', {
    value: 'aui'
});

浏览器版本无法加载外部文件，filename 为存放模板的元素 id

示例

编译模板并缓存。

// compile && cache
template('/welcome.art', 'hi, <%=value%>.');

// use
template('/welcome.art', {
    value: 'aui'
});

.compile(source, options)

编译模板并返回一个渲染函数。

• 参数：
  • {string} source
  • {Object} options
• 返回值：{function}

示例

var render = template.compile('hi, <%=value%>.');
var html = render({value: 'aui'});

.render(source, data, options)

编译并返回渲染结果。

• 参数：
  • {string} source
  • {Object} options
• 返回值：{string}

示例

var html = template.render('hi, <%=value%>.', {value: 'aui'});

.defaults

模板引擎默认配置。参考 选项。

• 类型：{Object}

.extension

给 NodeJS require.extensions 注册的模板渲染函数。

• 类型：{Object}

示例

加载 .ejs 模板：

var template = require('art-template');
require.extensions['.ejs'] = template.extension;

var view = require('./index.ejs');
var html = view(data);

.art 默认被注册，可以直接使用：

var template = require('art-template');
var view = require('./index.art');
var html = view(data);

需要注意的是：此功能仅对 NodeJS 生效，如果要在浏览器中使用模板文件渲染功能，请使用 Webpack art-template-loader。