golang模板语法简明教程

本文内容纲要：

【模板标签】

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

【注释】

{{/*acomment*/}}

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

【变量】

{{.}}

此标签输出当前对象的值

{{.Admpub}}

表示输出Struct对象中字段或方法名称为“Admpub”的值。

当“Admpub”是匿名字段时，可以访问其内部字段或方法,比如“Com”：{{.Admpub.Com}}，

如果“Com”是一个方法并返回一个Struct对象，同样也可以访问其字段或方法：{{.Admpub.Com.Field1}}

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

调用方法“Method1”，将后面的参数值依次传递给此方法，并输出其返回值。

{{$admpub}}

此标签用于输出在模板中定义的名称为“admpub”的变量。当$admpub本身是一个Struct对象时，可访问其字段：{{$admpub.Field1}}

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

比如：{{$x:="OK"}}或{{$x:=pipeline}}

【管道函数】

用法1：

{{FuncName1}}

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

用法2：

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

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

用法3：

{{.Admpub|FuncName1}}

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

【条件判断】

用法1：

{{ifpipeline}}T1{{end}}

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

用法2：

{{ifpipeline}}T1 {{else}}T0{{end}}

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

用法3：

{{ifpipeline}}T1{{elseifpipeline}}T0{{end}}

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

其中if后面可以是一个条件表达式（包括管道函数表达式。pipeline即管道），也可以是一个字符窜变量或布尔值变量。当为字符窜变量时，如为空字符串则判断为false，否则判断为true。

【遍历】

用法1：

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

range...end结构内部如要使用外部的变量，比如.Var2，需要这样写：$.Var2

（即：在外部变量名称前加符号“$”即可，单独的“$”意义等同于global）

用法2：

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

用法3：

{{rangepipeline}}T1 {{else}}T0{{end}}

当没有可遍历的值时，将执行else部分。

【嵌入子模板】

用法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}}

{{template"T3"}}

输出：

ONETWO

【定义局部变量】

用法1：

{{withpipeline}}T1{{end}}

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

用法2：

{{withpipeline}}T1 {{else}}T0{{end}}

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

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

【例子：输出字符窜】

{{"\"output\""}}

输出一个字符窜常量。

{{`"output"`}}

输出一个原始字符串常量

{{printf"%q""output"}}

函数调用.（等同于：printf("%q","output")。）

{{"output"|printf"%q"}}

竖线“|”左边的结果作为函数最后一个参数。（等同于：printf("%q","output")。）

{{printf"%q"(print"out""put")}}

圆括号中表达式的整体结果作为printf函数的参数。（等同于：printf("%q",print("out","put"))。）

{{"put"|printf"%s%s""out"|printf"%q"}}

一个更复杂的调用。（等同于：printf("%q",printf("%s%s","out","put"))。）

{{"output"|printf"%s"|printf"%q"}}

等同于：printf("%q",printf("%s","output"))。

{{with"output"}}{{printf"%q".}}{{end}}

一个使用点号“.”的with操作。（等同于：printf("%q","output")。）

{{with$x:="output"|printf"%q"}}{{$x}}{{end}}

with结构，定义变量，值为执行管道函数之后的结果（等同于：$x:=printf("%q","output")。）

{{with$x:="output"}}{{printf"%q"$x}}{{end}}

with结构中，在其它动作中使用定义的变量

{{with$x:="output"}}{{$x|printf"%q"}}{{end}}

同上，但使用了管道。（等同于：printf("%q","output")。）

===============【预定义的模板全局函数】================

【and】

{{andxy}}

表示：ifxthenyelsex

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

【call】

{{call.X.Y12}}

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

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

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

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

【html】

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

【index】

{{indexx123}}

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

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

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

【js】

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

【len】

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

【not】

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

【or】

{{orxy}}

表示：ifxthenxelsey。等同于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只接受两个参数进行比较，后面其它的参数将分别依次与第一个参数进行比较，

{{eqarg1arg2arg3arg4}}

即只能作如下比较：

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

来源:

http://www.admpub.com/blog/post-221.html

本文内容总结：

原文链接：https://www.cnblogs.com/Pynix/p/4154630.html