内置函数

text

  1. {{.value | text}}

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

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

htmlencode/encode/html

  1. {{.value | htmlencode}}
  2. {{.value | encode}}
  3. {{.value | html}}

value变量值进行html转义。
示例:

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

htmldecode/decode

  1. {{.value | htmldecode}}
  2. {{.value | decode}}

value变量值进行html反转义。
示例:

  1. {{"&lt;div&gt;测试&lt;/div&gt;" | htmldecode}}
  2. // 输出: <div>测试</div>

urlencode/url

  1. {{.url | url}}

url变量值进行url转义。
示例:

  1. {{"https://goframe.org" | url}}
  2. // 输出: https%3A%2F%2Fgoframe.org

urldecode

  1. {{.url | urldecode}}

url变量值进行url反转义。
示例:

  1. {{"https%3A%2F%2Fgoframe.org"|urldecode}}
  2. // 输出: https://goframe.org

date

  1. {{.timestamp | date .format}}
  2. {{date .format .timestamp}}
  3. {{date .format}}

timestamp时间戳变量进行时间日期格式化,类似PHP的date方法,format参数支持PHP date方法格式,亦可参考【gtime模块】。

timestamp变量为(或者0)时,表示以当前时间作为时间戳参数执行打印。

示例:

  1. {{1540822968 | date "Y-m-d"}}
  2. {{"1540822968" | date "Y-m-d H:i:s"}}
  3. {{date "Y-m-d H:i:s"}}
  4. // 输出:
  5. // 2018-10-29
  6. // 2018-10-29 22:22:48
  7. // 2018-12-05 10:22:00

compare

  1. {{compare .str1 .str2}}
  2. {{.str2 | compare .str1}}

str1str2进行字符串比较,返回值:

  • 0 : str1 == str2
  • 1 : str1 > str2
  • -1 : str1 < str2

示例:

  1. {{compare "A" "B"}}
  2. {{compare "1" "2"}}
  3. {{compare 2 1}}
  4. {{compare 1 1}}
  5. // 输出:
  6. // -1
  7. // -1
  8. // 1
  9. // 0

replace

  1. {{.str | replace .search .replace}}
  2. {{replace .search .replace .str}}

str中的search替换为replace
示例:

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

substr

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

strstart索引位置(索引从0开始)进行字符串截取length,支持中文,类似PHP的substr函数。
示例:

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

strlimit

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

str字符串截取length长度,支持中文,超过长度则追加suffix字符串到末尾。
示例:

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

concat

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

拼接字符串。
示例:

  1. {{concat "我" "是" "中" "国" "人"}}
  2. // 输出:
  3. // 我是中国人

hidestr

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

str字符串按照percent百分比从字符串中间向两边隐藏字符(主要用于姓名、手机号、邮箱地址、身份证号等的隐藏),隐藏字符由hide变量定义。
支持中文,支持email格式。
示例:

  1. {{"热爱GF热爱生活" | hidestr 20 "*"}}
  2. {{"热爱GF热爱生活" | hidestr 50 "*"}}
  3. // 输出:
  4. // 热爱GF*爱生活
  5. // 热爱****生活

highlight

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

str字符串中的关键字key按照定义的颜色color进行前置颜色高亮。
示例:

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

toupper/tolower

  1. {{.str | toupper}}
  2. {{.str | tolower}}

str字符串进行大小写转换。
示例:

  1. {{"gf" | toupper}}
  2. {{"GF" | tolower}}
  3. // 输出:
  4. // GF
  5. // gf

nl2br

  1. {{.str | nl2br}}

str字符串中的\n/\r替换为html中的<br />标签。
示例:

  1. {{"Go\nFrame" | nl2br}}
  2. // 输出:
  3. // Go<br />Frame

dump

  1. {{dump .var}}

格式化打印变量,功能类似于g.Dump方法。
示例:

  1. gview.Assign("var", g.Map{
  2. "name" : "john",
  3. })
  1. {{dump .var}}
  2. // 输出:
  3. // <!--
  4. // {
  5. // name: "john"
  6. // }
  7. // -->