模板的簡單語法説明:
1. 基礎語法:
1.1 獲取傳入的數據:
在向編寫模板的時候需要留有佔位符接受傳遞給模板的數據,這些佔位符都是使用雙跨括號{{
,}}
包括起來的,用一個點.
表示傳入的整個數據,如果傳入的數據是一個複雜數據類型,比如結構體,map,則可以使用.
+屬性
的方式來獲取這個複雜數據結構中的屬性值。在!使用模板中使用的正是這樣一種例子
1.2 注釋:
模板的注釋是寫在{{/*
和*/}}
之間的内容,既可以用於多行注釋,也可以用於單行注釋,但是注釋不能嵌套。
1.3 移除空白:
當需要移除特定佔位符前後的空白的時候可以使用{{-
移除其左側的空白,使用-}}
移除其右側的空白符。移除空白是爲了保證在渲染之後的頁面不會變形走樣。
2. 常規操作:
2.1 條件判斷:
條件判斷與golang是一樣的if
,if-else
, if-else-if
。不過不同的是在模板中這些關鍵字需要包括在{{}}``中檔,而且需要使用
{{end}}`來標識結束--這一點反而有點像bash shell。其基礎格式如下(pipeline是指所有能產生數據的操作,甚至包括1.1接受數據的動作):
if-end結構
{{if pipeline}}
T1
{{end}}
if-else-end結構:
{{if pipeline}}
T1
{{else}}
T0
{{end}}
if-else-if-end結構:
{{if pipeline}}
T1
{{else if pipeline}}
T0
{{end}}
2.2 遍歷:
如果傳入的數據是一個map,struct,dict等可以遍歷的數據類型,則可以通過使用range函數進行遍歷:{{range pipeline}} T1 {{end}}
。
3. 預定義函數:
3.1 常用函數
and
函数返回它的第一个empty参数或者最后一个参数;
就是说"and x y"等价于"if x then y else x";所有参数都会执行;
or
返回第一个非empty参数或者最后一个参数;
亦即"or x y"等价于"if x then x else y";所有参数都会执行;
not
返回它的单个参数的布尔值的否定
len
返回它的参数的整数类型长度
index
执行结果为第一个参数以剩下的参数为索引/键指向的值;
如"index x 1 2 3"返回x[1][2][3]的值;每个被索引的主体必须是数组、切片或者字典。
print
即fmt.Sprint
printf
即fmt.Sprintf
println
即fmt.Sprintln
html
返回与其参数的文本表示形式等效的转义HTML。
这个函数在html/template中不可用。
urlquery
以适合嵌入到网址查询中的形式返回其参数的文本表示的转义值。
这个函数在html/template中不可用。
js
返回与其参数的文本表示形式等效的转义JavaScript。
call
执行结果是调用第一个参数的返回值,该参数必须是函数类型,其余参数作为调用该函数的参数;
如"call .X.Y 1 2"等价于go语言里的dot.X.Y(1, 2);
其中Y是函数类型的字段或者字典的值,或者其他类似情况;
call的第一个参数的执行结果必须是函数类型的值(和预定义函数如print明显不同);
该函数类型值必须有1到2个返回值,如果有2个则后一个必须是error接口类型;
如果有2个返回值的方法返回的error非nil,模板执行会中断并返回给调用模板执行者该错误;
3.2 比較函數:
eq 如果arg1 == arg2则返回真
ne 如果arg1 != arg2则返回真
lt 如果arg1 < arg2则返回真
le 如果arg1 <= arg2则返回真
gt 如果arg1 > arg2则返回真
ge 如果arg1 >= arg2则返回真