GoFrame 模板函数-内置函数

plus/minus/times/divide

函数	说明	格式	示例
​plus​	加	​{{.value1 | plus .value2}}​	​{{3 | plus 2}} => 5​
​minus​	减	​{{.value1 | minus .value2}}​	​{{3 | minus 2}} => 1​
​times​	乘	​{{.value1 | times .value2}}​	​{{3 | times 2}} => 6​
​divide​	除	​{{.value1 | divide .value2}}​	​{{3 | divide 2}} => 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}}
// 输出: &lt;div&gt;测试&lt;/div&gt;

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 方法格式。

当​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}}​