You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
73 lines
1.8 KiB
73 lines
1.8 KiB
1 year ago
|
# artTemplate 原生 js 模板语法版
|
||
|
|
|
||
|
|
## 使用
|
||
|
|
|
||
|
|
在页面中引用模板引擎：
|
||
|
|
|
||
|
|
<script src="dist/template-native.js"></script>
|
||
|
|
|
||
|
|
[下载](https://raw.github.com/aui/artTemplate/master/dist/template-native.js)
|
||
|
|
|
||
|
|
## 表达式
|
||
|
|
|
||
|
|
``<%`` 与 ``%>`` 符号包裹起来的语句则为模板的逻辑表达式。
|
||
|
|
|
||
|
|
### 输出表达式
|
||
|
|
|
||
|
|
对内容编码输出：
|
||
|
|
|
||
|
|
<%=content%>
|
||
|
|
|
||
|
|
不编码输出：
|
||
|
|
|
||
|
|
<%=#content%>
|
||
|
|
|
||
|
|
编码可以防止数据中含有 HTML 字符串，避免引起 XSS 攻击。
|
||
|
|
|
||
|
|
### 逻辑
|
||
|
|
|
||
|
|
支持使用 js 原生语法
|
||
|
|
|
||
|
|
<h1><%=title%></h1>
|
||
|
|
<ul>
|
||
|
|
<%for(i = 0; i < list.length; i ++) {%>
|
||
|
|
<li>条目内容 <%=i + 1%> ：<%=list[i]%></li>
|
||
|
|
<%}%>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
> 模板不能访问全局对象，公用的方法请参见文档[辅助方法](#辅助方法)章节
|
||
|
|
|
||
|
|
### 模板包含表达式
|
||
|
|
|
||
|
|
用于嵌入子模板。
|
||
|
|
|
||
|
|
<% include('template_name') %>
|
||
|
|
|
||
|
|
子模板默认共享当前数据，亦可以指定数据：
|
||
|
|
|
||
|
|
<% include('template_name', news_list) %>
|
||
|
|
|
||
|
|
## 辅助方法
|
||
|
|
|
||
|
|
使用``template.helper(name, callback)``注册公用辅助方法：
|
||
|
|
|
||
|
|
template.helper('dateFormat', function (date, format) {
|
||
|
|
// ..
|
||
|
|
return value;
|
||
|
|
});
|
||
|
|
|
||
|
|
模板中使用的方式：
|
||
|
|
|
||
|
|
<%=dateFormat(content) %>
|
||
|
|
|
||
|
|
## 演示例子
|
||
|
|
|
||
|
|
* [基本例子](http://aui.github.io/artTemplate/demo/template-native/basic.html)
|
||
|
|
* [不转义HTML](http://aui.github.io/artTemplate/demo/template-native/no-escape.html)
|
||
|
|
* [在javascript中存放模板](http://aui.github.io/artTemplate/demo/template-native/compile.html)
|
||
|
|
* [嵌入子模板(include)](http://aui.github.io/artTemplate/demo/template-native/include.html)
|
||
|
|
* [访问外部公用函数(辅助方法)](http://aui.github.io/artTemplate/demo/template-native/helper.html)
|
||
|
|
|
||
|
|
----------------------------------------------
|
||
|
|
|
||
|
|
本文档针对 artTemplate v3.0.0 编写
|