plus/minus/times/divide

text

  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

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

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

    date

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

    timestamp时间戳变量进行时间日期格式化,类似PHP的date方法,format参数支持 方法格式,亦可参考 时间管理-gtime

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

    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. // 输出:
    2. // 我是中国人

    hidestr

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

    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. // -->

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