高性能前端 art-template 模板
官網： https://aui.github.io/art-template/zh-cn/index.html
nodejs 服務器端使用
第一步： 引入 art-template 的包
npm install --save art-template
npm install --save express-art-template第二步：項目中設置 express 的應用 art-template 模板引擎
const art_express = require(‘express-art-template‘);
const app = express(); // 創建app對象。
// 設置art的模板引擎
app.engine(‘art‘, art_express);
app.get(‘/user/list‘, (req, res) => {
res.render(‘users/userlist2.art‘, {
title: ‘你好啊！‘,
users: userService.getUsers()
});
}); 核心方法
// 基於模板名渲染模板
template(filename, data);
// 將模板源代碼編譯成函數
template.compile(source, options);
// 將模板源代碼編譯成函數並立刻執行
template.render(source, data, options);瀏覽器端使用
下載：lib/template-web.js（gzip: 6kb）
因為瀏覽器不支持文件系統，所以 template(filename, data) 不支持傳入文件路徑，它內部使用 document.getElementById(filename).innerHTML
<script src="lib/template-web.js"></script>
<script id="tpl-user" type="text/html">
{{if user}}
<h2>{{user.name}}</h2>
{{/if}}
</script>兼容到 IE8 的實例：
<!DOCTYPE HTML>
<html>
<head>
<meta charset="UTF-8">
<title>IE</title>
<!--<script src="https://cdnjs.cloudflare.com/ajax/libs/es5-shim/4.5.7/es5-shim.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/es5-shim/4.5.7/es5-sham.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/json3/3.3.2/json3.min.js"></script>-->
<script src="es5-shim.min.js"></script>
<script src="es5-sham.min.js"></script>
<script src="json3.min.js"></script>
<script src="../../lib/template-web.js"></script>
</head>
<body>
<div id="content"></div>
<script id="test" type="text/html">
{{if isAdmin}}
<h1>{{title}}</h1>
<ul>
{{each list value i}}
<li>索引 {{i + 1}} ：{{value}}</li>
{{/each}}
</ul>
{{/if}}
{{$data}}
</script>
<script>
var data = {
title: ‘基本例子‘,
isAdmin: true,
list: [‘文藝‘, ‘博客‘, ‘攝影‘, ‘電影‘, ‘民謠‘, ‘旅行‘, ‘吉他‘]
};
var html = template(‘test‘, data);
document.getElementById(‘content‘).innerHTML = html;
</script>
</body>
</html> 基本語法
輸出
- 輸出標準語法
{{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‘) %>配合 gulp 自動化預編譯
前端使用art-template的時候非常不方便，不能把模板拆成單獨的模板文件，TmodJS（原名 atc)可以把模板預編譯成 js，直接解放了生產力。 當然如果你用 webpack，自然有對應的 loader。但是我們這次要講的是 gulp。
對應 gulp 的插件：gulp-tmod
安裝 gulp-tmod
$ npm install gulp-tmod --save-dev配置 gulpfile.js 文件
const tmodjs = require(‘gulp-tmod‘);
gulp.task(‘tpl‘, function() {
gulp
.src(‘src/template/**/*.html‘) // 找到所有的html模板
.pipe(
tmodjs({
templateBase: ‘src/template/‘, // 模板根目錄
runtime: ‘tpl.js‘, // 輸出的js文件
compress: false // 是否壓縮
})
)
// 自動生成的模板文件，進行babel轉換，會報錯，此轉換插件已經停更，所以間接改這個bug
// 參考bug：https://github.com/aui/tmodjs/issues/112 主要是this → window
.pipe(replace(‘var String = this.String;‘, ‘var String = window.String;‘))
.pipe(gulp.dest(‘src/js/tmpl/‘));
});使用選項設置：
- output Default: false
We use gulp steam other than tmodjs output, so set it to false prevent tmodjs create files.
- runtime Type: String
Default: template.js
This will be use as a path pass to gulp-util File
- templateBase Default: __dirname
Your template basepath.
- minify Minify is deprecated, we should use gulp-uglify
如果想把不同的模板文件夾生成不同的 js 文件，那麽下面的例子：
const tmodjs = require(‘gulp-tmod‘);
gulp.task(‘tpl‘, function() {
// 拿到所有的路徑
let basePath = path.join(__dirname, ‘src/template‘);
let files = fs.readdirSync(basePath);
files.forEach((val, index) => {
let dirPath = path.join(basePath, val);
let stat = fs.statSync(dirPath);
if (!stat.isDirectory()) {
// 判斷是否是文件夾
return;
}
var fileter = ‘src/template/‘ + val + ‘/**/*.html‘;
console.log(fileter);
gulp
.src(‘src/template/‘ + val + ‘/**/*.html‘)
.pipe(
tmodjs({
templateBase: ‘src/template/‘ + val,
runtime: val + ‘.js‘,
compress: false
})
)
// 自動生成的模板文件，進行babel轉換，會報錯，此轉換插件已經停更，所以間接改這個bug
// 參考bug：https://github.com/aui/tmodjs/issues/112 主要是this → window
.pipe(replace(‘var String = this.String;‘, ‘var String = window.String;‘))
.pipe(gulp.dest(‘src/js/tmpl/‘));
});
});
配合 require.js
/*
* @Author: malun
* @Date: 2018-04-18 01:14:20
* @Last Modified by: malun
* @Last Modified time: 2018-06-11 19:57:24
*/
require([‘template‘, ‘jquery‘, ‘js/tmpl/user‘, ‘js/tmpl/header‘], function(
template,
$,
userTpl,
headTpl
) {
document.getElementById(‘dt‘).innerHTML = headTpl(‘header‘, data);
$.ajax({
url: ‘/api/shoplist‘,
type: ‘GET‘,
success: function(data) {
document.getElementById(‘dt2‘).innerHTML = userTpl(‘footer‘, data);
}
});
});高性能前端 art-template 模板