基本函数

变量可以使用符号 | 在函数间传递

{{.value | Func1 | Func2}}

使用括号

{{printf "nums is %s %d" (printf "%d %d" 1 2) 3}}

and

{{and .X .Y .Z}}

and会逐一判断每个参数，将返回第一个为空的参数，否则就返回最后一个非空参数

call

{{call .Field.Func .Arg1 .Arg2}}

call可以调用函数，并传入参数

调用的函数需要返回 1 个值 或者 2 个值，返回两个值时，第二个值用于返回error类型的错误。返回的错误不等于nil时，执行将终止。

index

index支持map, slice, array, string，读取指定类型对应下标的值。

{{index .Maps "name"}}

len

{{printf "The content length is %d" (.Content|len)}}

返回对应类型的长度，支持类型：map, slice, array, string, chan。

not

not返回输入参数的否定值。

or

{{or .X .Y .Z}}

or会逐一判断每个参数，将返回第一个非空的参数，否则就返回最后一个参数。

print

对应fmt.Sprint。

printf

对应fmt.Sprintf。

println

对应fmt.Sprintln。

urlquery

{{urlquery "http://johng.cn"}}

将返回

http%3A%2F%2Fjohng.cn

eq / ne / lt / le / gt / ge

这类函数一般配合在if中使用

`eq`: arg1 == arg2
`ne`: arg1 != arg2
`lt`: arg1 < arg2
`le`: arg1 <= arg2
`gt`: arg1 > arg2
`ge`: arg1 >= arg2

eq和其他函数不一样的地方是，支持多个参数，和下面的逻辑判断相同

arg1==arg2 || arg1==arg3 || arg1==arg4 ...

与if一起使用

{{if eq true .Var1 .Var2 .Var3}}...{{end}}

{{if lt 100 200}}...{{end}}

内置函数

text

{{.value | text}}

将value变量值去掉HTML标签，仅显示文字内容（并且去掉script标签）。

html

在默认情况下，模板引擎会将输出的字符串内容进行HTML转义处理，使用html内置函数可以保留HTML标签，并显示完整的HTML内容。

{{.value | html}}

将value变量值保留HTML标签，显示完整的HTML内容（并且会保留script标签）。

使用示例：

package main
import (
    "gitee.com/johng/gf/g/os/gview"
    "gitee.com/johng/gf/g"
)
func main() {
    if c, err := gview.ParseContent(`{{"<div>测试</div>模板引擎默认处理HTML标签<script>alert(\"test\");</script>\n"}}`, nil); err == nil {
        g.Dump(c)
    } else {
        g.Dump(c)
    }
    if c, err := gview.ParseContent(`{{"<div>测试</div>去掉HTML标签<script>alert(\"test\");</script>\n"|text}}`, nil); err == nil {
        g.Dump(c)
    } else {
        g.Dump(c)
    }
    if c, err := gview.ParseContent(`{{"<div>测试</div>保留HTML标签<script>alert(\"test\");</script>\n"|html}}`, nil); err == nil {
        g.Dump(c)
    } else {
        g.Dump(c)
    }
}

执行后，输出结果为：

<div>测试</div>模板引擎默认处理HTML标签<script>alert("test");</script>
测试去掉HTML标签
<div>测试</div>保留HTML标签<script>alert("test");</script>

get

仅在Web Server下，即通过ghttp模块使用ghttp.Response/gmvc.View对象渲染模板引擎时有效。

{{get "参数名称"}}

用于获取GET方式传递的参数。

使用示例：

{{if (get "name")}}
    {{get "name"}}
{{else}}
    NoName
{{end}}

post

仅在Web Server下，即通过ghttp模块使用ghttp.Response/gmvc.View对象渲染模板引擎时有效。

{{post "参数名称"}}

用于获取POST方式传递的参数。

request

仅在Web Server下，即通过ghttp模块使用ghttp.Response/gmvc.View对象渲染模板引擎时有效。

{{request "参数名称"}}

用于获取路由参数，以及GET/POST方式传递的参数。