go-模板引擎
动作
Go 模板的动作就是一些嵌入到模板里面的命令,这些命令在模板中需要放到两个
大括号里{{ 动作 }},之前我们已经用过一个很重要的动作:点(.),它代表了传递给模
板的数据。下面我们再介绍几个常用的动作,如果还想了解其他类型的动作,可以参考
text/template 库的文档。
条件动作
格式一:
{{ if arg}} 要显示的内容 {{ end }}
格式二:
{{ if arg}} 要显示的内容 {{else}} 当 if 条件不满足时要显示的内容 {{ end }}
其中的 arg 是传递给条件动作的参数,该值可以是一个字符串常量、
一个变量、一个返回单个值的函数获取方法等。
例如
模板文件
模板文件
{{if .}} 你已经成年了! {{else}} 你还未成年 {{end}}
处理器端代码
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 后面的点代表被遍历的元素;要显示的内容里面的点代表遍历
到的元素
例如:
模板文件
模板文件
{{range .}}
{{.}}
{{else}} 没有遍历到任何内容 {{end}}
处理器端代码
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 }}
例如:
模板文件
模板文件
得到的数据是:{{.}}
{{with "太子"}}
替换之后的数据是:{{.}}
{{end}}
{{with ""}}
看一下现在的数据是:{{.}}
{{else}}
数据没有被替换,还是:{{.}}
{{end}}
处理器端代码
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
模板文件
从后台得到的数据是:{{.}}
{{ template "hello2.html"}}
hello.html 文件内容结束
将 hello.html 模板文件中的数据传递给 hello2.html 模板文件
{{ template "hello2.html" . }}
hello2.html
hello2 模板文件
hello2.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"}}
模板文件
{{ template "content"}}
{{ end }}
- 在一个模板文件中定义多个模板
模板文件(hello.html)
{{ define "model"}}
模板文件
{{ template "content"}}
{{ end }} {{ define "content"}}
点我有惊喜
{{ 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"}}
模板文件
{{ template "content"}}
{{ end }}
content1.html
content 模板文件
{{ define “content” }}
我是 content1.html 模板文件中的内容
{{ end }}
content2.html
content 模板文件
{{ define “content” }}
我是 content2.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",
"content2.html"))
}
//执行模板
t.ExecuteTemplate(w, "model", "")
}
浏览器中的结果
我是 content1.html 模板文件中的内容
块动作
Go 1.6 引入了一个新的块动作,这个动作允许用户定义一个模板并立即使用。相当
于设置了一个默认的模板
格式:
{{ block arg }} 如果找不到模板我就要显示了 {{ end }}
修改 6.4.5 中的模板文件 hello.html
{{ define "model"}}
模板文件
{{ block "content" .}} 如果找不到就显示我 {{ end }}
{{ 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", "")
}
浏览器中的结果
如果找不到就显示我