前端模版引擎artTemplate的语法使用

责编:menVScode 2017-07-15 22:57 阅读(636)

        art-template 同时支持两种模板语法。标准语法可以让模板更容易读写;原始语法具有强大的逻辑处理能力。下面这两种分别做使用说明:

        1. 标准(简洁)语法版:

{{if user}}
  <h2>{{user.name}}</h2>
{{/if}}

        2. 原生语法版:原始语法兼容 EJSUnderscoreLoDash 模板。

<% if (user) { %>
  <h2><%= user.name %></h2>
<% } %>

        下载地址 https://raw.githubusercontent.com/aui/art-template/master/lib/template-web.js,约6kb大小。


语法介绍

        art-template 支持标准语法与原始语法。标准语法可以让模板易读写,而原始语法拥有强大的逻辑表达能力。标准语法支持基本模板语法以及基本 JavaScript 表达式;原始语法支持任意 JavaScript 语句,这和 EJS 一样。

        1、输出

//标准语法
{{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']}}

        2、原文输出

//标准语法
{{@value}}

//原始语法
<%- value %>

        原文输出语句不会对 HTML 内容进行转义处理,可能存在安全风险,请谨慎使用。

        3、条件

//标准语法
{{if value}} ... {{/if}}
{{if v1}} ... {{else if v2}} ... {{/if}}

//原始语法
<% if (value) { %> ... <% } %>
<% if (v1) { %> ... <% } else if (v2) { %> ... <% } %>

        4、循环

//标准语法
{{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}}。

        5、变量

//标准语法
{{set temp = data.sub.content}}

//原始语法
<% var temp = data.sub.content; %>

        6、模板继承

//标准语法
{{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 后,将自动应用布局骨架。

        7、子模板

//标准语法
{{include './header.art'}}
{{include './header.art' data}}

//原始语法
<% include('./header.art') %>
<% include('./header.art', data) %>

        data 数默认值为 $data;标准语法不支持声明 object 与 array,只支持引用变量,而原始语法不受限制。

        art-template 内建 HTML 压缩器,请避免书写 HTML 非正常闭合的子模板,否则开启压缩后标签可能会被意外“优化。

        8、过滤器

        注册过滤器

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') %>


修改界定符

// 原始语法的界定符规则
template.defaults.rules[0].test = /<%(#?)((?:==|=#|[=-])?)[ \t]*([\w\W]*?)[ \t]*(-?)%>/;

// 标准语法的界定符规则
template.defaults.rules[1].test = /{{([@#]?)[ \t]*(\/?)([\w\W]*?)[ \t]*}}/;

它们是一个正则表达式,你可以只修改界定符部分。例如修改 <% %> 为 <? ?>

var rule = template.defaults.rules[0];
rule.test = new RegExp(rule.test.source.replace('<%', '<\\\?').replace('%>', '\\\?>'));

artTemplate具体的文档:https://aui.github.io/art-template/docs/index.html

前端交流群: MVC前端网(menvscode.com)-qq交流群:551903636

邮箱快速注册

忘记密码