一. Action

  • Go语言官方文档给出action(动作)的列表。”Arguments”和”pipelines”代表数据的执行结果
  1. {{/* a comment */}}
  2. 注释,执行时会忽略。可以多行。注释不能嵌套,并且必须紧贴分界符始止,就像这里表示的一样。
  3. {{pipeline}}
  4. pipeline的值的默认文本表示会被拷贝到输出里。
  5. {{if pipeline}} T1 {{end}}
  6. 如果pipeline的值为empty,不产生输出,否则输出T1执行结果。不改变dot的值。
  7. Empty值包括false0、任意nil指针或者nil接口,任意长度为0的数组、切片、字典。
  8. {{if pipeline}} T1 {{else}} T0 {{end}}
  9. 如果pipeline的值为empty,输出T0执行结果,否则输出T1执行结果。不改变dot的值。
  10. {{if pipeline}} T1 {{else if pipeline}} T0 {{end}}
  11. 用于简化if-else链条,else action可以直接包含另一个if;等价于:
  12. {{if pipeline}} T1 {{else}}{{if pipeline}} T0 {{end}}{{end}}
  13. {{range pipeline}} T1 {{end}}
  14. pipeline的值必须是数组、切片、字典或者通道。
  15. 如果pipeline的值其长度为0,不会有任何输出;
  16. 否则dot依次设为数组、切片、字典或者通道的每一个成员元素并执行T1
  17. 如果pipeline的值为字典,且键可排序的基本类型,元素也会按键的顺序排序。
  18. {{range pipeline}} T1 {{else}} T0 {{end}}
  19. pipeline的值必须是数组、切片、字典或者通道。
  20. 如果pipeline的值其长度为0,不改变dot的值并执行T0;否则会修改dot并执行T1
  21. {{template "name"}}
  22. 执行名为name的模板,提供给模板的参数为nil,如模板不存在输出为""
  23. {{template "name" pipeline}}
  24. 执行名为name的模板,提供给模板的参数为pipeline的值。
  25. {{with pipeline}} T1 {{end}}
  26. 如果pipelineempty不产生输出,否则将dot设为pipeline的值并执行T1。不修改外面的dot
  27. {{with pipeline}} T1 {{else}} T0 {{end}}
  28. 如果pipelineempty,不改变dot并执行T0,否则dot设为pipeline的值并执行T1
  • action主要完成流程控制、循环、模版等操作.通过使用action可以在模版中完成简单逻辑处理(复杂逻辑处理应该在go中实现,传递给模版的数据应该是已经加工完的数据)

二. if 使用

  • if写在模版中和写在go文件中功能是相同的,区别是语法
  • 布尔函数会将任何类型的零值视为假,其余视为真。
  • if后面的表达式中如果包含逻辑控制符在模版中实际上是全局函数
  1. and
  2. 函数返回它的第一个empty参数或者最后一个参数;
  3. 就是说"and x y"等价于"if x then y else x";所有参数都会执行;
  4. or
  5. 返回第一个非empty参数或者最后一个参数;
  6. 亦即"or x y"等价于"if x then x else y";所有参数都会执行;
  7. not
  8. 返回它的单个参数的布尔值的否定
  9. len
  10. 返回它的参数的整数类型长度
  11. index
  12. 执行结果为第一个参数以剩下的参数为索引/键指向的值;
  13. "index x 1 2 3"返回x[1][2][3]的值;每个被索引的主体必须是数组、切片或者字典。
  14. print
  15. fmt.Sprint
  16. printf
  17. fmt.Sprintf
  18. println
  19. fmt.Sprintln
  20. html
  21. 返回其参数文本表示的HTML逸码等价表示。
  22. urlquery
  23. 返回其参数文本表示的可嵌入URL查询的逸码等价表示。
  24. js
  25. 返回其参数文本表示的JavaScript逸码等价表示。
  26. call
  27. 执行结果是调用第一个参数的返回值,该参数必须是函数类型,其余参数作为调用该函数的参数;
  28. "call .X.Y 1 2"等价于go语言里的dot.X.Y(1, 2);
  29. 其中Y是函数类型的字段或者字典的值,或者其他类似情况;
  30. call的第一个参数的执行结果必须是函数类型的值(和预定义函数如print明显不同);
  31. 该函数类型值必须有12个返回值,如果有2个则后一个必须是error接口类型;
  32. 如果有2个返回值的方法返回的errornil,模板执行会中断并返回给调用模板执行者该错误;
  • 二元比较运算的集合:(也是函数,函数具有两个参数,满足参数语法)
  1. eq 如果arg1 == arg2则返回真
  2. ne 如果arg1 != arg2则返回真
  3. lt 如果arg1 < arg2则返回真
  4. le 如果arg1 <= arg2则返回真
  5. gt 如果arg1 > arg2则返回真
  6. ge 如果arg1 >= arg2则返回真
  • 简单if示例-go文件
  1. package main
  2. import (
  3. "net/http"
  4. "html/template"
  5. )
  6. func test(rw http.ResponseWriter, r *http.Request) {
  7. t, _ := template.ParseFiles("template/html/if.html")
  8. //第二个参数传递类型默认值:nil,"",0,false等都会导致if不成立
  9. t.Execute(rw, "")
  10. }
  11. func main() {
  12. //创建server服务
  13. server := http.Server{Addr: ":8090"}
  14. //设置处理器函数
  15. http.HandleFunc("/test", test)
  16. //监听和开始服务
  17. server.ListenAndServe()
  18. }
  • 简单if示例-html文件
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="UTF-8">
  5. <title>if测试</title>
  6. </head>
  7. <body>
  8. 测试if是否执行<br/>
  9. {{if . }}
  10. if成立这个位置输出
  11. {{end}}
  12. </body>
  13. </html>
  • 直接在HTMl中定义变量演示if..else用法(go文件不变)
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="UTF-8">
  5. <title>测试</title>
  6. </head>
  7. <body>
  8. {{$n:=123}}
  9. {{if ne $n 123}}
  10. if成立这个位置输出
  11. {{else}}{{/* 比if结构多了else */}}
  12. 这是else的功能
  13. {{end}}
  14. </body>
  15. </html>
  • go文件不变,演示if…else if…else用法
  1. <body>
  2. {{$n:=124}}
  3. {{if eq $n 123}}
  4. 123
  5. {{else if eq $n 124}}
  6. 124
  7. {{else if eq $n 125}}
  8. 125
  9. {{else}}
  10. else
  11. {{end}}
  12. </body>
  • 在模版中也可以相互嵌套
  1. <body>
  2. {{$n:=124}}
  3. {{if gt $n 100}}
  4. {{if gt $n 200}}
  5. gt 200
  6. {{else}}
  7. lt 200
  8. {{end}}
  9. {{else}}
  10. 小于100
  11. {{end}}
  12. </body>

三.range使用

  • range遍历数组或切片或map或channel时,在range内容中{{.}}表示获取迭代变量
  1. <body>
  2. {{range .}}
  3. {{.}}{{/* 此处dot为迭代变量 */}}
  4. {{end}}
  5. {{.}}{{/* 此处获取还是传递给模版的切片 */}}
  6. </body>