Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

内置函数

text

{{.value | text}}

value变量值去掉HTML标签,仅显示文字内容(并且去掉script标签)。 示例:

{{"<div>测试</div>"|text}}
// 输出: 测试

htmlencode/encode/html

{{.value | htmlencode}}
{{.value | encode}}
{{.value | html}}

...

{{"<div>测试</div>"|html}}
// 输出: &lt;div&gt;测试&lt;/div&gt;

htmldecode/decode

{{.value | htmldecode}}
{{.value | decode}}

...

{{"&lt;div&gt;测试&lt;/div&gt;" | 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}}

...

{{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}}

...

{{"I'm中国人" | replace "I'm" "我是"}}
// 输出:
// 我是中国人

substr

{{.str | substr .start .length}}
{{substr .start .length .str}}

...

{{"我是中国人" | substr 2 -1}}
{{"我是中国人" | substr 2  2}}
// 输出:
// 中国人
// 中国

strlimit

{{.str | strlimit .length .suffix}}

...

{{"我是中国人" | strlimit 2  "..."}}
// 输出:
// 我是...

concat

{{concat .str1 .str2 .str3...}}

...

{{concat "我" "是" "中" "国" "人"}}
// 输出:
// 我是中国人

hidestr

{{.str | hidestr .percent .hide}}

...

{{"热爱GF热爱生活" | hidestr 20  "*"}}
{{"热爱GF热爱生活" | hidestr 50  "*"}}
// 输出:
// 热爱GF*爱生活
// 热爱****生活

highlight

{{.str | highlight .key .color}}

...

{{"热爱GF热爱生活" | highlight "GF" "red"}}
// 输出:
// 热爱<span style="color:red;">GF</span>热爱生活

toupper/tolower

{{.str | toupper}}
{{.str | tolower}}

...

{{"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方法。 示例:

...