安装
npm install art-template --save复制代码
<script src="https://unpkg.com/art-template@4.13.2/lib/template-web.js"></script>复制代码
在浏览器中实时编译
<script src="lib/template-web.js"></script>
<script id="tpl-user" type="text/html">
{{if user}}
<h2>{{user.name}}</h2>
{{/if}}
</script>复制代码
语法
art-template 支持标准语法与原始语法。
标准语法可以让模板易读写,而原始语法拥有强大的逻辑表达能力。
标准语法支持基本模板语法以及基本 JavaScript 表达式;
原始语法支持任意 JavaScript 语句,这和 EJS 一样。
输出
标准语法
{{value}}
{{data.key}}
{{data['key']}}
{{a ? b : c}}
{{a || b}} {{a + b}}
原始语法
<%= value %>
<%= data.key %>
<%= data['key'] %>
<%= a ? b : c %>
<%= a || b %> <%= a + b %>
模板一级特殊变量可以使用 $data
加下标的方式访问:
{{$data['user list']}}
原文输出
标准语法
{{@ value }}
原始语法
<%- value %>
原文输出语句不会对
HTML
内容进行转义处理,可能存在安全风险,请谨慎使用。
条件
标准语法
{{if value}} ... {{/if}} {{if v1}} ... {{else if v2}} ... {{/if}}
原始语法
<% if (value) { %> ... <% } %> <% if (v1) { %> ... <% } else if (v2) { %> ... <% } %>
循环
标准语法
{{each target}} {{$index}} {{$value}} {{/each}}
原始语法
<% for(var i = 0; i < target.length; i++){ %> <%= i %> <%= target[i] %> <% } %>
target
支持array
与object
的迭代,其默认值为$data
。$value
与$index
可以自定义:{{each target val key}}
。
变量
标准语法
{{set temp = data.sub.content}}
原始语法
<% var temp = data.sub.content; %>
模板继承
标准语法
{{extend './layout.art'}} {{block 'head'}} ... {{/block}}
原始语法
<% extend('./layout.art') %> <% block('head', function(){ %> ... <% }) %>
模板继承允许你构建一个包含你站点共同元素的基本模板“骨架”。范例:
<!--layout.art-->
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>{{block 'title'}}My Site{{/block}}</title>
{{block 'head'}}
<link rel="stylesheet" href="main.css">
{{/block}}
</head>
<body>
{{block 'content'}}{{/block}}
</body>
</html>
复制代码
<!--index.art-->
{{extend './layout.art'}}
{{block 'title'}}{{title}}{{/block}}
{{block 'head'}}
<link rel="stylesheet" href="custom.css">
{{/block}}
{{block 'content'}}
<p>This is just an awesome page.</p>
{{/block}}
复制代码
渲染 index.art 后,将自动应用布局骨架。
子模板
标准语法
{{include './header.art'}} {{include './header.art' data}}
原始语法
<% include('./header.art') %> <% include('./header.art', data) %>
data
数默认值为$data
;标准语法不支持声明object
与array
,只支持引用变量,而原始语法不受限制。- art-template 内建 HTML 压缩器,请避免书写 HTML 非正常闭合的子模板,
否则开启压缩后标签可能会被意外“优化。
过滤器
注册过滤器
template.defaults.imports.dateFormat = function(date, format){/*[code..]*/};
template.defaults.imports.timestamp = function(value){return value * 1000}; 复制代码
过滤器函数第一个参数接受目标值。
标准语法
{{date | timestamp | dateFormat 'yyyy-MM-dd hh:mm:ss'}}
{{value | filter}} 过滤器语法类似管道操作符,它的上一个输出作为下一个输入。
原始语法
<%= $imports.dateFormat($imports.timestamp(date), 'yyyy-MM-dd hh:mm:ss') %>复制代码
官方文档
http://aui.github.io/art-template/zh-cn/
接下来说下个人对基本用法的理解用法
这是一个公司网站的导航栏
<script type="text/html" id="tpl-head">
<ul class="navbar-nav">
<%for(var i = 0;i < data.length;i++){%>
<li class="nav-item" id="nav_{{data[i]['id']}}">
<a href="{{data[i]['url']}}" class="nav-link">{{data[i]['title']}}</a>
</li>
<%}%>
</ul>
</script>
复制代码
var html = template('tpl-
head', json);
$('.head').html(html);
因为这个前端引擎具有标准语法
和 原始语法
所以我将逻辑部分用原始语法而数据使用标准语法方便阅读 。