goweb-动作
go-模板引擎
动作
go 模板的动作就是一些嵌入到模板里面的命令,这些命令在模板中需要放到两个
大括号里{{ 动作 }},之前我们已经用过一个很重要的动作:点(.),它代表了传递给模
板的数据。下面我们再介绍几个常用的动作,如果还想了解其他类型的动作,可以参考
text/template 库的文档。
条件动作
格式一:
{{ if arg}} 要显示的内容 {{ end }}
格式二:
{{ if arg}} 要显示的内容 {{else}} 当 if 条件不满足时要显示的内容 {{ end }}
其中的 arg 是传递给条件动作的参数,该值可以是一个字符串常量、
一个变量、一个返回单个值的函数获取方法等。
例如
模板文件
<html> <head> <title>模板文件</title> <meta charset="utf-8" /> </head> <body> <!-- 嵌入动作 --> {{if .}} 你已经成年了! {{else}} 你还未成年 {{end}} </body> </html>
处理器端代码
func handler(w http.responsewriter, r *http.request) { //解析模板文件 t := template.must(template.parsefiles("hello.html")) //声明一个变量 age := 16 //执行模板 t.execute(w, age > 18) }
浏览器中的结果你还未成年
迭代动作
迭代动作可以对数组、切片、映射或者通道进行迭代。
格式一:
{{range . }} 遍历到的元素是 {{ . }} {{ end }}
格式二:
{{range . }} 遍历到的元素是 {{ . }} {{ else }} 没有任何元素 {{ end }}
range 后面的点代表被遍历的元素;要显示的内容里面的点代表遍历
到的元素
例如:
模板文件
<html> <head> <title>模板文件</title> <meta charset="utf-8" /> </head> <body> <!-- 嵌入动作 --> {{range .}} <a href="#">{{.}}</a> {{else}} 没有遍历到任何内容 {{end}} </body> </html>
处理器端代码
func handler(w http.responsewriter, r *http.request) { //解析模板文件 t := template.must(template.parsefiles("hello.html")) //声明一个字符串切片 stars := []string{"马蓉", "李小璐", "白百何"} //执行模板 t.execute(w, stars) }
浏览器中的结果
马蓉 李小璐 白百何
如果迭代之后是一个个的结构体,获取结构体中的字段值使用 .字段名
方式获取
{{range . }} 获取结构体的 name 字段名 {{ .name }} {{ end }} 迭代 map 时可以设置变量,变量以$开头: {{ range $k , $v := . }} 键是 {{ $k }} , 值是 {{ $v }} {{ end }} 迭代管道 {{ c1 | c2 | c3 }}
c1、c2 和 c3 可以是参数或者函数。管道允许用户将一个参数的输出
传递给下一个参数,各个参数之间使用 | 分割。
设置动作
设置动作允许在指定的范围内对点(.)设置值。
格式一:
{{ with arg }} 为传过来的数据设置的新值是{{ . }} {{ end }}
格式二:
{{ with arg }} 为传过来的数据设置的新值是{{ . }} {{ else }} 传过来的数据仍然是{{ . }} {{ end }}
例如:
模板文件
<html> <head> <title>模板文件</title> <meta charset="utf-8" /> </head> <body> <!-- 嵌入动作 --> <div>得到的数据是:{{.}}</div> {{with "太子"}} <div>替换之后的数据是:{{.}}</div> {{end}} <hr /> {{with ""}} <div>看一下现在的数据是:{{.}}</div> {{else}} <div>数据没有被替换,还是:{{.}}</div> {{end}} </body> </html>
处理器端代码
func handler(w http.responsewriter, r *http.request) { //解析模板文件 t := template.must(template.parsefiles("hello.html")) //执行模板 t.execute(w, "狸猫") }
浏览器中的结果
得到的数据是:狸猫 替换之后的数据是:太子 数据没有被替换,还是:狸猫
包含动作
包含动作允许用户在一个模板里面包含另一个模板,从而构建出嵌套的模
板。
格式一:{{ template “name” }}
name 为被包含的模板的名字
格式二:{{ template “name” arg }}
arg 是用户想要传递给被嵌套模板的数据
例如:
模板文件
hello.html
<html> <head> <title>模板文件</title> <meta charset="utf-8" /> </head> <body> <!-- 嵌入动作 --> <div>从后台得到的数据是:{{.}}</div> <!-- 包含 hello2.html 模板 --> {{ template "hello2.html"}} <div>hello.html 文件内容结束</div> <hr /> <div>将 hello.html 模板文件中的数据传递给 hello2.html 模板文件</div> {{ template "hello2.html" . }} </body> </html>
hello2.html
<html> <head> <title>hello2 模板文件</title> <meta charset="utf-8" /> </head> <body> <!-- 嵌入动作 --> <div>hello2.html 模板文件中的数据是:{{.}}</div> </body> </html>
处理器端代码
func handler(w http.responsewriter, r *http.request) { //解析模板文件 t := template.must(template.parsefiles("hello.html", "hello2.html")) //执行模板 t.execute(w, "测试包含") }
注意:在解析模板文件时,当前文件以及被包含的文件都要解析
浏览器中的结果
从后台得到的数据是:测试包含 hello2.html 模板文件中的数据是: hello.html 文件内容结束 将 hello.html 模板文件中的数据传递给 hello2.html 模板文件 hello2.html 模板文件中的数据是:测试包含
定义动作
当我们访问一些网站时,经常会看到好多网页中有相同的部分:比如导航栏、版权
信息、联系方式等。这些相同的布局我们可以通过定义动作在模板文件中定义模板来实
现。定义模板的格式是:以{{ define “layout” }}开头,以{{ end }}结尾。
- 在一个模板文件(hello.html)中定义一个模板
<!-- 定义模板 --> {{ define "model"}} <html> <head> <title>模板文件</title> <meta charset="utf-8" /> </head> <body> {{ template "content"}} </body> </html> {{ end }}
- 在一个模板文件中定义多个模板
模板文件(hello.html)
<!-- 定义模板 --> {{ define "model"}} <html> <head> <title>模板文件</title> <meta charset="utf-8" /> </head> <body> {{ template "content"}} </body> </html> {{ end }} {{ define "content"}} <a href="#">点我有惊喜</a> {{ end }}
处理器端代码
func handler(w http.responsewriter, r *http.request) { //解析模板文件 t := template.must(template.parsefiles("hello.html")) //执行模板 t.executetemplate(w, "model", "") }
注意:需要调用 executetemplate 方法并指定模板的名字
浏览器中的结果
点我有惊喜
- 在不同的模板文件中定义同名的模板
模板文件
hello.html
<!-- 定义模板 --> {{ define "model"}} <html> <head> <title>模板文件</title> <meta charset="utf-8" /> </head> <body> {{ template "content"}} </body> </html> {{ end }}
content1.html
<html> <head> <title>content 模板文件</title> <meta charset="utf-8" /> </head> <body> <!-- 定义 content 模板 --> {{ define “content” }} <h1>我是 content1.html 模板文件中的内容</h1> {{ end }} </body> </html>
content2.html
<html> <head> <title>content 模板文件</title> <meta charset="utf-8" /> </head> <body> <!-- 定义 content 模板 --> {{ define “content” }} <h1>我是 content2.html 模板文件中的内容</h1> {{ end }} </body> </html>
处理器端代码
func handler(w http.responsewriter, r *http.request) { rand.seed(time.now().unix()) var t *template.template if rand.intn(5) > 2 { //解析模板文件 t = template.must(template.parsefiles("hello.html", "content1.html")) } else { //解析模板文件 t = template.must(template.parsefiles("hello.html", "content2.html")) } //执行模板 t.executetemplate(w, "model", "") }
浏览器中的结果
我是 content1.html 模板文件中的内容
块动作
go 1.6 引入了一个新的块动作,这个动作允许用户定义一个模板并立即使用。相当
于设置了一个默认的模板
格式:
{{ block arg }} 如果找不到模板我就要显示了 {{ end }}
修改 6.4.5 中的模板文件 hello.html
<!-- 定义模板 --> {{ define "model"}} <html> <head> <title>模板文件</title> <meta charset="utf-8" /> </head> <body> {{ block "content" .}} 如果找不到就显示我 {{ end }} </body> </html> {{ end }}
稍微修改一下处理器端的代码
func handler(w http.responsewriter, r *http.request) { rand.seed(time.now().unix()) var t *template.template if rand.intn(5) > 2 { //解析模板文件 t = template.must(template.parsefiles("hello.html", "content1.html")) } else { //解析模板文件 t = template.must(template.parsefiles("hello.html")) } //执行模板 t.executetemplate(w, "model", "") }
浏览器中的结果
如果找不到就显示我