模板函数-内置函数
plus/minus/times/divide
| 函数 | 说明 | 格式 | 示例 | 备注 |
|---|---|---|---|---|
plus |
加 | .value1 | plus .value2 |
``2 | plus 3=> 5 |
minus |
减 | .value1 | minus .value2 |
``2 | minus 3=> 1 |
times |
乘 | .value1 | times .value2 |
``2 | times 3=> 6 |
divide |
除 | .value1 | divide .value2 |
``2 | divide 3=> 1.5 |
text
`.value | text`
将value变量值去掉HTML标签,仅显示文字内容(并且去掉script标签)。 示例:
`"<div>测试</div>"|text`
// 输出: 测试
htmlencode/encode/html
`.value | htmlencode`
`.value | encode`
`.value | html`
将value变量值进行html转义。 示例:
`"<div>测试</div>"|html`
// 输出: <div>测试</div>
htmldecode/decode
`.value | htmldecode`
`.value | decode`
将value变量值进行html反转义。 示例:
`"<div>测试</div>" | htmldecode`
// 输出: <div>测试</div>
urlencode/url
`.url | url`
将url变量值进行url转义。 示例:
`"https://goframe.org" | url`
// 输出: https%3A%2F%2Fgoframe.org
urldecode
`.url | urldecode`
将url变量值进行url反转义。 示例:
`"https%3A%2F%2Fgoframe.org"|urldecode`
// 输出: https://goframe.org
date
`.timestamp | date .format`
`date .format .timestamp`
`date .format`
将timestamp时间戳变量进行时间日期格式化,类似PHP的date方法,format参数支持 PHP date 方法格式,亦可参考 时间管理-gtime 。
当timestamp变量为空(或者0)时,表示以当前时间作为时间戳参数执行打印。
示例:
`1540822968 | date "Y-m-d"`
`"1540822968" | date "Y-m-d H:i:s"`
`date "Y-m-d H:i:s"`
// 输出:
// 2018-10-29
// 2018-10-29 22:22:48
// 2018-12-05 10:22:00
compare
`compare .str1 .str2`
`.str2 | compare .str1`
将str1和str2进行字符串比较,返回值: - 0 : str1 == str2 - 1 : str1 > str2 - -1 : str1 < str2
示例:
`compare "A" "B"`
`compare "1" "2"`
`compare 2 1`
`compare 1 1`
// 输出:
// -1
// -1
// 1
// 0
replace
`.str | replace .search .replace`
`replace .search .replace .str`
将str中的search替换为replace。 示例:
`"I'm中国人" | replace "I'm" "我是"`
// 输出:
// 我是中国人
substr
`.str | substr .start .length`
`substr .start .length .str`
将str从start索引位置(索引从0开始)进行字符串截取length,支持中文,类似PHP的substr函数。 示例:
`"我是中国人" | substr 2 -1`
`"我是中国人" | substr 2 2`
// 输出:
// 中国人
// 中国
strlimit
`.str | strlimit .length .suffix`
将str字符串截取length长度,支持中文,超过长度则追加suffix字符串到末尾。 示例:
`"我是中国人" | strlimit 2 "..."`
// 输出:
// 我是...
concat
`concat .str1 .str2 .str3...`
拼接字符串。 示例:
`concat "我" "是" "中" "国" "人"`
// 输出:
// 我是中国人
hidestr
`.str | hidestr .percent .hide`
将str字符串按照percent百分比从字符串中间向两边隐藏字符(主要用于姓名、手机号、邮箱地址、身份证号等的隐藏),隐藏字符由hide变量定义。 支持中文,支持email格式。 示例:
`"热爱GF热爱生活" | hidestr 20 "*"`
`"热爱GF热爱生活" | hidestr 50 "*"`
// 输出:
// 热爱GF*爱生活
// 热爱****生活
highlight
`.str | highlight .key .color`
将str字符串中的关键字key按照定义的颜色color进行前置颜色高亮。 示例:
`"热爱GF热爱生活" | highlight "GF" "red"`
// 输出:
// 热爱<span style="color:red;">GF</span>热爱生活
toupper/tolower
`.str | toupper`
`.str | tolower`
将str字符串进行大小写转换。 示例:
`"gf" | toupper`
`"GF" | tolower`
// 输出:
// GF
// gf
nl2br
`.str | nl2br`
将str字符串中的\n/\r替换为html中的<br />标签。 示例:
`"Go\nFrame" | nl2br`
// 输出:
// Go<br />Frame
dump
`dump .var`
格式化打印变量,功能类似于g.Dump方法,常用于开发调试。 示例:
gview.Assign("var", g.Map{
"name" : "john",
})
``` ```
`dump .var`
// 输出:
// <!--
// {
// name: "john"
// }
// -->
map
`map .var`
将模板变量转换为map[string]interface{}类型,常用于range...end遍历。
maps
`maps .var`
将模板变量转换为[]map[string]interface{}类型,常用于range...end遍历。
json/xml/ini/yaml/yamli/toml
| 函数 | 说明 | 格式 |
|---|---|---|
json |
将模板变量转换为JSON格式字符串。 |
json .var |
xml |
将模板变量转换为XML格式字符串。 |
xml .var |
ini |
将模板变量转换为INI格式字符串。 |
ini .var |
yaml |
将模板变量转换为YAML格式字符串。 |
yaml .var |
yamli |
将模板变量转换为带有自定义缩进的YAML格式字符串。 |
yamli .var .indent |
toml |
将模板变量转换为TOML格式字符串。 |
toml .var |
