go的模板

2017-11-29

html/template

最基本渲染

type User struct {
	Nick string
	Des  string
}

func main(){
	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		tmpl := template.Must(template.ParseFiles("templates/demo.html"))
		user := User{Nick: "abc", Des: "ddddddd"}
		tmpl.ExecuteTemplate(w, "demo", user)
    })
...
}

其中,template应该在开头和结尾定义了 define/end 之外,还有几个参数

{ {.} } // 这样显示的是 {abc,ddddd}
{ {.Nick} } // 显示 abc

对文件渲染

就是验证码 …????

注释

html模板里的注释,是会解析的

模板的注释是 { {/ 注释内容 /} }

局部变量,就是 `with`

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

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

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

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

预定义的模板全局函数

名称	举例	表示	说明
【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} }	x[1][2][3]	返回index后面的第一个参数的某个索引对应的元素值，其余的参数为索引值,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）

条件循环

{ {if 条件} } 代码段 { {end} }

{ {if 条件} } 代码段 { {else} } 代码段 { {end} }

{ {if 条件} } 代码段 { {else if 条件} } 代码段 { {end} }

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

range…end结构内部如要使用外部的变量，比如.Var2，需要这样写：$.Var2
（即：在外部变量名称前加符号“$”即可，单独的“$”意义等同于global）

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

{ {range 条件} } 代码段 { {else} } 代码段 { {end} } //当没有可遍历的值时，将执行else部分。

条件,叫管道函数

{ {FuncName1} }

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

{ {FuncName1 “参数值1” “参数值2”} }

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

{ {.Admpub|FuncName1} }

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

布尔函数

名称	符号
eq	==
ne	!=
lt	<
le	<=
gt	>
ge	>=

转义

如何让参数不转义,这种冒险行为是这样.. template.HTML(到模板的参数)),就是将参数用template.HTML括起来,还有 template.JS,template.CSS

还有一种对付这种不转义的办法,自定义模板变量

func unescaped (x string) interface{} { return template.HTML(x) } // 定义 unescaped

http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) { 
	tmpl := template.New("")
	tmpl = tmpl.Funcs(template.FuncMap{"unescaped": unescaped})
	tmpl, _ = tmpl.ParseFiles("templates/demo.html")
	// tmpl = template.Must(tmpl.ParseFiles("templates/demo.html"))  // 这样写也可以的,那么这个template.Must到底干嘛的呢? 其实就是省略了一个err
	user := User{Nick: "abc", Des: "<h1>啥?啥?啥?</h1>"}
	if err := tmpl.ExecuteTemplate(w, "demo", user); nil != err {
		http.Error(w, err.Error(), http.StatusBadRequest)
	}
})

使用

1 2	{ {printf "%s" .Body \| unescaped} } //[]byte { {.Body \| unescaped} } //string

html的特殊符号转译

【例子：输出字符窜】

表达式	介绍
{ {“\”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”)。）

自定义模板函数

 
func main() {  
    
    Func := template.FuncMap{"Func": ce}   //把定义的函数实例  
    t := template.New("")  
    t.Funcs(Func)    //注册要使用的函数  
    t....
}  
  
func ce(i int) string {  
    return "姓名："  
}

子页面

一个页面包含了多个 template.

{ {template “别的模板名”} }

如果用ParseFiles,那就把这个页面用到的页面全写上.