公共指令以及方法的介绍说明
【必读】
所谓模板指令和方法就是用于辅助获取数据的一些标签,在动态生成静态页展示的时候可以动态通过标签获取后台数据进行html 静态化的时候
渲染,那么有的标签是可以全局通用的,而有的标签是需要传递参数来获取的,全局通用的标签好理解,即可以在模板任何地方调用都能获取数据,
而参数指令就需要用参数来接受了,那么既然有参数就用作用域这一说,所谓作用域可以理解为 在生成静态页的时候系统后台代码会自动存入一些信息,比如在生成内容页的时候会把文章的内容数据在后台系统自动设置,那么模板就可以获取到 比如内容的 标题,但是在生成栏目列表页的时候,作用域内是没有栏目的标题,而是栏目的名称,也就是说每个执行的方法都会携带一些系统内置的数据,这些数据在不同的方法中携带,我们称之为作用域。
1.1日期格式化
format
举例说明:${format(gmtCreate,'yyyy-MM-dd HH:mm')}
标签名称 |
标签写法 |
作用域 |
日期格式化 |
${format(var1,var2)} |
全局 |
变量值 |
是否必填 |
默认值 |
说明 |
var1 |
必填 |
Null |
当前作用域变量 |
var2 |
非必填 |
yyyy-MM-dd |
遵循 java 日期格式化 |
1.2字符串截取
sub
举例说明:${sub(content.description!,15)} | ${sub(content.description!,15,‘…’)}
标签名称 |
标签写法 |
作用域 |
字符串截取 |
${sub(var1,var2,var3)} |
全局 |
变量值 |
是否必填 |
默认值 |
说明 |
var1 |
必填 |
Null |
当前作用域任意变量 |
var2 |
非必填 |
10 |
截取的个数 |
var3 |
非必填 |
… |
截取后省略符号 |
1.3导入页面片段
import
举例说明:<#include import('business_ps')/> 用于引入页面片段的部分
标签名称 |
标签写法 |
作用域 |
模板片段导入 |
<#include import(var1)/> |
全局 |
变量值 |
是否必填 |
默认值 |
说明 |
var1 |
必填 |
Null |
模板片段的编码 |
1.4清除HTML 标签
clearHtml
举例说明:${ clearHtml (content.description!,‘br’)} 清除指定HTML标签,不包括内容
标签名称 |
标签写法 |
作用域 |
内容标签清除 |
${ clearHtml (var1,var2)} |
全局 |
变量值 |
是否必填 |
默认值 |
说明 |
var1 |
必填 |
Null |
变量/常量内容 |
var2 |
非必填 |
指定 html 标签 |
为空时清除所有,只保留内容 |
1.5全局默认变量
内置全局变量获取
举例说明:${dt} | ${domain} | ${tmpcode}
标签名称 |
标签写法 |
作用域 |
站点全局域名 |
${dt} | ${domain} | ${tmpcode}
|
全局 |
变量值 |
是否必填 |
默认值 |
说明 |
${dt} |
非必填 |
当前默认网站的域名+默认模板的code |
如:http:www.xx.com/jxhx |
${domain} |
非必填 |
当前默认网站的域名 |
如:http:www.xx.com |
${tmpcode} |
非必填 |
当前默认模板的编码 |
如:/jxhx |