GoFrame 模板函數(shù)-基礎(chǔ)函數(shù)

以下為Golang標準庫的一些基礎(chǔ)語法和基礎(chǔ)函數(shù)，?GoFrame?框架對部分基礎(chǔ)函數(shù)做了必要的改進。

變量可以使用符號|?在函數(shù)間傳遞

{{.value | Func1 | Func2}}

使用括號

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

and

{{and .X .Y .Z}}

?and?會逐一判斷每個參數(shù)，將返回第一個為空的參數(shù)，否則就返回最后一個非空參數(shù)

call

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

?call?可以調(diào)用函數(shù)，并傳入?yún)?shù)

調(diào)用的函數(shù)需要返回1個值或者2個值，返回兩個值時，第二個值用于返回?error?類型的錯誤。返回的錯誤不等于?nil?時，執(zhí)行將終止。

index

??index??支持??map??, ??slice??, ?array?, ?string?，讀取指定類型對應(yīng)下標的值。

{{index .Maps "name"}}

len

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

返回對應(yīng)類型的長度，支持類型：?map?, ?slice?, ?array?, ?string?, ?chan?。

not

?not?返回輸入?yún)?shù)的否定值。

例如，判斷是否變量是否為空：

{{if not .Var}}
// 執(zhí)行為空操作(.Var為空, 如: nil, 0, "", 長度為0的slice/map)
{{else}}
// 執(zhí)行非空操作(.Var不為空)
{{end}}

or

{{or .X .Y .Z}}

?or?會逐一判斷每個參數(shù)，將返回第一個非空的參數(shù)，否則就返回最后一個參數(shù)。

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

這類函數(shù)一般配合在?if?中使用

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

?eq?和其他函數(shù)不一樣的地方是，支持多個參數(shù)。

{{eq arg1 arg2 arg3 arg4}}

和下面的邏輯判斷相同:

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

與?if?一起使用

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

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

例如，判斷變量不為空時執(zhí)行：

{{if .Var}}
// 執(zhí)行非空操作(.Var不為空)
{{else}}
// 執(zhí)行為空操作(.Var為空, 如: nil, 0, "", 長度為0的slice/map)
{{end}}

對比函數(shù)改進

?GoFrame?框架模板引擎對標準庫自帶的對比模板函數(shù)?eq/ne/lt/le/gt/ge?做了必要的改進，以便支持任意數(shù)據(jù)類型的比較。例如，在標準庫模板中的以下比較：

{{eq 1 "1"}}

將會引發(fā)錯誤：

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

由于比較的兩個參數(shù)不是同一數(shù)據(jù)類型，因此引發(fā)了?panic?錯誤。

在?GoFrame?框架的模板引擎中，將會自動將兩個參數(shù)進行數(shù)據(jù)轉(zhuǎn)換，轉(zhuǎn)換為同一類型后再進行比較，這樣的開發(fā)體驗更好、靈活性更高。如果兩個參數(shù)均為整型變量（或者整型字符串），那么將會轉(zhuǎn)換為整型進行比較，否則轉(zhuǎn)換為字符串變量進行比較（區(qū)分大小寫）。

改進運行示例

我們來看一個?GoFrame?框架的模板引擎中的對比模板函數(shù)運行示例。

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

運行后，輸出結(jié)果為：

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