Node 使用模板引擎art-template

我们开始通过前端浏览器发送ajax请求获取服务器数据的，前端获取数据后进行遍历展示；

缺点就是发送多次请求、不利于搜索引擎查找。

那么如何改善呢？

可以修改为后端渲染数据，如 使用模板引擎art-template

art-template一些资源

#npm 地址
https://www.npmjs.com/package/art-template
#github 地址
https://github.com/aui/art-template
#官方文档(经常被墙，可以看看下面这个)
https://aui.github.io/art-template/zh-cn/index.html
#看云文档资料
https://www.kancloud.cn/lanju/art-template

介绍

art-template 是一个简约、超快的模板引擎。

它采用作用域预声明的技术来优化模板渲染速度，从而获得接近 JavaScript 极限的运行性能，并且同时支持 NodeJS 和浏览器。

特性

  1. 拥有接近 JavaScript 渲染极限的的性能
  2. 调试友好：语法、运行时错误日志精确到模板所在行；支持在模板文件上打断点（Webpack Loader）
  3. 支持 Express、Koa、Webpack
  4. 支持模板继承与子模板
  5. 浏览器版本仅 6KB 大小

安装

Npm

npm install art-template --save

image-20201005142735672

如上路表示安装完成

浏览器版本直接去下载即可

语法

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] %>
<% } %>
  1. target 支持 array 与 object 的迭代，其默认值为 $data。
  2. $value 与 $index 可以自定义：{% raw %}{{each target val key}}{% endraw %}。

变量

标准语法

{{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) %>
  1. data 数默认值为 $data；标准语法不支持声明 object 与 array，只支持引用变量，而原始语法不受限制。
  2. 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'}}

{% raw %}{{value | filter}}{% endraw %} 过滤器语法类似管道操作符，它的上一个输出作为下一个输入。

原始语法

<%= $imports.dateFormat($imports.timestamp(date), 'yyyy-MM-dd hh:mm:ss') %>

如果想修改 {% raw %}{{{% endraw %}``{% raw %}}}{% endraw %} 与 <%``%>，请参考 解析规则

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。

使用

简单Demo

art-test.html

<body>
<h1>你好</h1>
<h2>{{data[0].name}}</h2>
</body>

test.js

//引入art-template模块
var template = require('art-template');
//设置 模板根目录 到当前路径。如果 filename 字段不是本地路径，则在 root 查找模板
template.defaults.root = './';
//根据模板名渲染模板
var html = template('./art-test.html',{data:[{name:123,age:345},{a:678,b:987}]});
console.log(html);

运行结果

image-20201005143544823

posted @ 2020-10-05 14:44  makalo  阅读(1049)  评论(0)  编辑  收藏  举报