plus/minus/times/divide
text
{{"<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
变量值进行url
反转义。 示例:
{{"https%3A%2F%2Fgoframe.org"|urldecode}}
// 输出: https://goframe.org
date
{{date .format .timestamp}}
{{date .format}}
将timestamp
时间戳变量进行时间日期格式化,类似PHP的date
方法,format
参数支持 方法格式,亦可参考 时间管理-gtime 。
当timestamp
变量为空
(或者0
)时,表示以当前时间作为时间戳参数执行打印。
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...}}
拼接字符串。 示例:
// 输出:
// 我是中国人
hidestr
{{"热爱GF热爱生活" | hidestr 20 "*"}}
// 输出:
// 热爱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[string]interface{}
类型,常用于range...end
遍历。
maps
将模板变量转换为[]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}} |