go html模板的使用

【模板标签】

模板标签用"{{"和"}}"括起来

【注释】

{{/* a comment /}}

使用“{{/”和“*/}}”来包含注释内容

【变量】

使用 . 来访问当前位置的上下文

使用 $ 来引用当前模板根级的上下文

{{.}}                                   

此标签输出当前对象的值

{{.Admpub}}                             

表示输出Struct对象中字段或方法名称为“Admpub”的值。（首字母必须大写）

{{.Admpub.Com.Field1}}              

Com 如果是一个方法并返回一个对象则返回对象的Field1参数

{{.Method1 "参数值1" "参数值2"}}      

表示返回当前随想的Method1方法，并且传入参数为 参数一和参数二

{{$admpub.Field1}}                      

在模板中定义变量：变量名称用字母和数字组成，并带上“$”前缀，采用符号“:=”进行赋值。

{{$admpub}}                             

此标签用于输出在模板中定义的名称为“admpub”的变量（若为对象，处理方法和对象相同）

【管道函数】

{{FuncName1}}   

此标签将调用名称为“FuncName1”的模板函数（等同于执行“FuncName1()”，不传递任何参数）并输出其返回值。

{{FuncName1 "参数值1" "参数值2"}} 

此标签将调用“FuncName1("参数值1", "参数值2")”，并输出其返回值

{{.Admpub|FuncName1}}

此标签将调用名称为“FuncName1”的模板函数（等同于执行“FuncName1(this.Admpub)”，将竖线“|”左边的“.Admpub”变量值作为函数参数传送）并输出其返回值。

【条件判断】

{{if pipeline}} T1 {{end}}          

标签结构：{{if ...}} ... {{end}}

{{if pipeline}} T1 {{else}} T0 {{end}}  

标签结构：{{if ...}} ... {{else}} ... {{end}}

{{if pipeline}} T1 {{else if pipeline}} T0 {{end}}  

标签结构：{{if ...}} ... {{else if ...}} ... {{end}}

【遍历】

用法1：

{{range $k, $v := .Var}} {{$k}} => {{$v}} {{end}}

用法2：

{{range .Var}} {{.}} {{end}}

用法3：

{{range pipeline}} T1 {{else}} T0 {{end}}

【嵌入子模板】

用法1：

{{template "name"}}

嵌入名称为“name”的子模板。使用前，请确保已经用“{{define "name"}}子模板内容{{end}}”定义好了子模板内容。

用法2：

{{template "name" pipeline}}

将管道的值赋给子模板中的“.”（即“{{.}}”）

【子模板嵌套】

{{define "T1"}}ONE{{end}}

{{define "T2"}}TWO{{end}}

{{define "T3"}}{{template "T1"}} {{template "T2"}}{{end}}//将模板t1t2嵌套使用t3直接就使用了t1t2的嵌套

{{template "T3"}}

输出：

ONE TWO

【定义局部变量】

用法1：

{{with pipeline}} T1 {{end}}

管道的值将赋给该标签内部的“.”。（注：这里的“内部”一词是指被{{with pipeline}}...{{end}}包围起来的部分，即T1所在位置）

用法2：

{{with pipeline}} T1 {{else}} T0 {{end}}

如果管道的值为空，“.”不受影响并且执行T0，否则，将管道的值赋给“.”并且执行T1。

说明：{{end}}标签是if、with、range的结束标签。

【and】

{{and x y}}

表示：if x then y else x

如果x为真，返回y，否则返回x。等同于Golang中的：x && y

【call】

{{call .X.Y 1 2}}

表示：dot.X.Y(1, 2)

call后面的第一个参数的结果必须是一个函数（即这是一个函数类型的值），其余参数作为该函数的参数。

该函数必须返回一个或两个结果值，其中第二个结果值是error类型。

如果传递的参数与函数定义的不匹配或返回的error值不为nil，则停止执行。

【html】

转义文本中的html标签，如将“<”转义为“<”，“>”转义为“>”等

【index】

{{index x 1 2 3}}

返回index后面的第一个参数的某个索引对应的元素值，其余的参数为索引值

表示：x[1][2][3]

x必须是一个map、slice或数组

【js】

返回用JavaScript的escape处理后的文本

【len】

返回参数的长度值（int类型）

【not】

返回单一参数的布尔否定值。

【or】

{{or x y}}

表示：if x then x else y。等同于Golang中的：x || y

如果x为真返回x，否则返回y。

【print】

fmt.Sprint的别名

【printf】

fmt.Sprintf的别名

【println】

fmt.Sprintln的别名

【urlquery】

返回适合在URL查询中嵌入到形参中的文本转义值。（类似于PHP的urlencode）

=================【布尔函数】===============

布尔函数对于任何零值返回false，非零值返回true。

这里定义了一组二进制比较操作符函数：

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