Go 语言的 html/template 包提供了强大的模板渲染功能，允许开发者将数据动态地嵌入到 HTML 或其他文本格式中。虽然模板引擎提供了条件判断（if）等控制结构，但循环结构同样至关重要，尤其是在处理集合数据时。本文将详细介绍如何在 Go 模板中使用 range 关键字来迭代切片或数组。
range 的基本用法
range 关键字是 Go 模板中实现循环的主要方式。它允许你遍历一个切片或数组，并在每次迭代中访问当前元素。其基本语法如下：
{{range 集合}}
{{.}} <!-- 当前元素 -->
{{end}}其中，集合 可以是一个切片、数组或映射。在循环体内部，{{.}} 表示当前元素。
迭代切片并访问元素属性
当集合中的元素是结构体时，你可以使用点号（.）来访问元素的属性。例如，假设我们有一个包含 Person 结构体的切片：
package main
import (
"html/template"
"os"
)
type Person struct {
Name string
Age int
}
func main() {
people := []Person{
{Name: "Alice", Age: 30},
{Name: "Bob", Age: 25},
{Name: "Charlie", Age: 35},
}
tmpl, err := template.New("people").Parse(`
<!DOCTYPE html>
<html>
<head>
<title>People</title>
</head>
<body>
<h1>People List</h1>
<ul>
{{range .}}
<li>Name: {{.Name}}, Age: {{.Age}}</li>
{{end}}
</ul>
</body>
</html>
`)
if err != nil {
panic(err)
}
err = tmpl.Execute(os.Stdout, people)
if err != nil {
panic(err)
}
}在这个例子中，{{.Name}} 和 {{.Age}} 分别访问了 Person 结构体的 Name 和 Age 字段。运行这段代码，将会输出一个包含人员列表的 HTML 页面。
迭代切片并获取索引和值
range 还可以同时提供索引和值。这在某些情况下非常有用，例如需要显示列表的序号。语法如下：
{{range $index, $element := 集合}}
Index: {{$index}}, Element: {{$element}}
{{end}}在这个语法中，$index 是当前元素的索引，$element 是当前元素的值。可以将上述例子修改为同时显示索引：
package main
import (
"html/template"
"os"
)
type Person struct {
Name string
Age int
}
func main() {
people := []Person{
{Name: "Alice", Age: 30},
{Name: "Bob", Age: 25},
{Name: "Charlie", Age: 35},
}
tmpl, err := template.New("people").Parse(`
<!DOCTYPE html>
<html>
<head>
<title>People</title>
</head>
<body>
<h1>People List</h1>
<ul>
{{range $index, $person := .}}
<li>Index: {{$index}}, Name: {{$person.Name}}, Age: {{$person.Age}}</li>
{{end}}
</ul>
</body>
</html>
`)
if err != nil {
panic(err)
}
err = tmpl.Execute(os.Stdout, people)
if err != nil {
panic(err)
}
}注意事项
- 变量作用域： 在 range 循环内部定义的变量（如 $index 和 $element）只在循环体内部有效。
- 空切片处理： 如果要迭代的切片为空，range 循环体将不会执行。你可以使用 if 语句来判断切片是否为空，并采取相应的处理。
- 避免修改集合： 在 range 循环内部修改正在迭代的切片或数组可能会导致不可预测的结果，应尽量避免。
总结
range 关键字是 Go 模板中进行循环迭代的关键。通过灵活运用 range，可以方便地遍历切片、数组和映射，并在模板中动态地生成内容。理解 range 的用法和注意事项，能够帮助你编写更高效、更可维护的 Go 模板代码。希望本文提供的示例和说明能够帮助你更好地掌握 Go 模板中的循环结构。
