详解golang 模板(template)的常用基本语法

Go语言的模板库(html/template)是用于生成动态HTML或其他文本格式文档的重要工具。它允许开发者将固定格式的页面模板与动态数据相结合，从而生成最终的输出。本文将深入探讨Go模板的基本语法，包括变量、函数、条件判断以及它们在实际应用中的使用方式。 1. 变量 Go模板中的变量可以通过`{{ }}`来引用和操作。`.`特殊符号通常代表当前上下文的变量。例如，如果你有一个名为`Article`的结构体，并将其作为模板的数据传递，那么`{{.ArticleContent}}`将输出结构体中`ArticleContent`字段的值。你也可以定义新的变量，如`{{$article := "hello"}}`，之后在模板中使用`{{$article}}`。如果要将传入的值赋给新变量，如`ArticleContent`，可以写成`{{$article := .ArticleContent}}`。 2. 函数 Go模板提供了一些内置函数，同时也支持自定义函数。你可以使用`.Funcs`方法将自定义函数集合导入模板。自定义函数必须遵循特定的规则：要么只有一个返回值，要么有两个返回值，其中第二个是`error`类型。例如，定义一个加法函数`add`： ```go func add(left int, right int) int { return left + right } ``` 在模板中调用此函数：`{{add 1 2}}`将得到结果3。如果需要更复杂的逻辑，可能需要使用内置的模板函数，如`not`、`and`、`or`、`eq`、`ne`、`lt`、`le`、`gt`和`ge`进行条件判断。 3. 条件判断 Go模板支持`if`语句进行条件渲染。对于布尔变量，`{{if .condition}}{{end}}`结构会根据`.condition`的真伪来决定是否执行内部的代码块。对于字符串，非空字符串也会被视为`true`。`else if`和`else`可以用于嵌套条件，如`{{if .condition1}}{{else if .condition2}}{{else}}{{end}}`。内置的比较函数如`eq`（等于）、`ne`（不等于）、`lt`（小于）、`le`（小于等于）、`gt`（大于）和`ge`（大于等于）可以帮助构建复杂的逻辑判断。 4. 循环 模板中也有`range`关键字用于遍历数组、切片、映射或通道。例如，如果你有一个`Articles`的切片，可以使用`{{range .Articles}}`来迭代每个元素，然后在循环内部展示每个文章的详细信息。循环结束使用`{{end}}`。 5. 使用示例 下面是一个简单的模板使用示例： ```go type Article struct { ArticleId int ArticleTitle string ArticleContent string } articles := []Article{ {1, "Title1", "Content1"}, {2, "Title2", "Content2"}, } t := template.Must(template.New("articleList").Funcs(map[string]interface{}{ "add": add, }).Parse(` <ul> {{range .}} <li><p>{{.ArticleTitle}}</p><p>{{.ArticleContent}}</p></li> {{end}} </ul> `)) err := t.Execute(os.Stdout, articles) if err != nil { panic(err) } ``` 这个例子展示了如何定义一个模板，包含一个`range`循环遍历`articles`切片，并使用`add`函数。运行这段代码会生成一个包含文章列表的HTML片段。 Go语言的模板系统提供了强大的功能，使得后端开发者能够轻松地将动态数据注入静态模板，生成符合需求的动态页面。通过理解并熟练掌握这些基本语法，你可以构建出高效且灵活的模板引擎，服务于各种Web应用程序。