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