以下为Golang标准库的一些基础语法和基础函数，GoFrame框架对部分基础函数做了必要的改进。

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

{{.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返回输入参数的否定值。

例如，判断是否变量是否为空：

{{if not .Var}}
// 执行为空操作(.Var为空, 如: nil, 0, "", 长度为0的slice/map)
{{else}}
// 执行非空操作(.Var不为空)
{{end}}

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和其他函数不一样的地方是，支持多个参数。

{{eq arg1 arg2 arg3 arg4}}

和下面的逻辑判断相同:

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

与if一起使用

{{if eq true .Var1 .Var2 .Var3}}...{{end}}
{{if lt 100 200}}...{{end}}

例如，判断变量不为空时执行：

{{if .Var}}
// 执行非空操作(.Var不为空)
{{else}}
// 执行为空操作(.Var为空, 如: nil, 0, "", 长度为0的slice/map)
{{end}}

对比函数改进

GoFrame框架模板引擎对标准库自带的对比模板函数eq/ne/lt/le/gt/ge做了必要的改进，以便支持任意数据类型的比较。例如，在标准库模板中的以下比较：

{{eq 1 "1"}}

将会引发错误：

panic: template: at <eq 1 "1">: error calling eq: incompatible types for comparison

由于比较的两个参数不是同一数据类型，因此引发了panic错误。

在GoFrame框架的模板引擎中，将会自动将两个参数进行数据转换，转换为同一类型后再进行比较，这样的开发体验更好、灵活性更高。如果两个参数均为整型变量（或者整型字符串），那么将会转换为整型进行比较，否则转换为字符串变量进行比较（区分大小写）。

改进运行示例

我们来看一个GoFrame框架的模板引擎中的对比模板函数运行示例。

package main

import (
	"context"
	"fmt"
	"github.com/gogf/gf/v2/frame/g"
)

func main() {
	tplContent := `
eq:
eq "a" "a": {{eq "a" "a"}}
eq "1" "1": {{eq "1" "1"}}
eq  1  "1": {{eq  1  "1"}}

ne:
ne  1  "1": {{ne  1  "1"}}
ne "a" "a": {{ne "a" "a"}}
ne "a" "b": {{ne "a" "b"}}

lt:
lt  1  "2": {{lt  1  "2"}}
lt  2   2 : {{lt  2   2 }}
lt "a" "b": {{lt "a" "b"}}

le:
le  1  "2": {{le  1  "2"}}
le  2   1 : {{le  2   1 }}
le "a" "a": {{le "a" "a"}}

gt:
gt  1  "2": {{gt  1  "2"}}
gt  2   1 : {{gt  2   1 }}
gt "a" "a": {{gt "a" "a"}}

ge:
ge  1  "2": {{ge  1  "2"}}
ge  2   1 : {{ge  2   1 }}
ge "a" "a": {{ge "a" "a"}}
`
	content, err := g.View().ParseContent(context.TODO(), tplContent, nil)
	if err != nil {
		panic(err)
	}
	fmt.Println(content)
}

运行后，输出结果为：

eq:
eq "a" "a": true
eq "1" "1": true
eq  1  "1": true

ne:
ne  1  "1": false
ne "a" "a": false
ne "a" "b": true

lt:
lt  1  "2": true
lt  2   2 : false
lt "a" "b": true

le:
le  1  "2": true
le  2   1 : false
le "a" "a": true

gt:
gt  1  "2": false
gt  2   1 : true
gt "a" "a": false

ge:
ge  1  "2": false
ge  2   1 : true
ge "a" "a": true







Content Menu

  • No labels

6 Comments

  1. sanrentai

    eq和其他函数不一样的地方是，支持多个参数。

    写模板的时候没注意到，把 ne 也传了多个参数，导致页面显示有问题，但模板没有报错，这里是否有必要加个错误提示呢？

    1. 郭强

      那你可以把代码提个issue，我运行看看呢？

      1. sanrentai

        https://github.com/gogf/gf/issues/1095

        有时间看看

  2. 皛心

    没有+1么？

    比方说我要循环遍历数组将数据放在一个表格里，表格第一列是序号，循环的模板是

    {{range $key, $elem := .artList}}
    <th>{{$key}}</th>

    这样序号是从0开始，我想对key+1只能另外自定义函数了么？强烈建议内置一些简单的四则运算函数在模板里！

  3. 18lkdev

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

    这个怎么使用 

    func (c *cArticle) HelloW(ctx g.Ctx, req *v1.ArticleReq) (res *v1.ArcRes, err error) {

	r := Hello(req.ID)
	g.RequestFromCtx(ctx).Response.WriteTpl("hello.tpl", g.Map{
		"v": r,
	})

	return
}
func (c *cArticle) Index(ctx g.Ctx, req *v1.IndexReq) (res *v1.ArcRes, err error) {

	r := Hello(req.ID)
	g.RequestFromCtx(ctx).Response.WriteTpl("index.tpl", g.Map{
		"index": r,
	})

	return
}


    <html >
<title></title>
<h1>首页index</h1> 
${dump (call .HelloW .v.id .err)}
</html>


    是这么用么,没demo

    1. 尹佟凯

         Delimiters  =  ["${", "}"]          # 模板引擎变量分隔符号。默认为 ["{{", "}}"]
      是不是没有配置用的默认的啊