在线文档  >   Golang练习   >   文本模板

Go提供了内置支持,可以通过 text/template 包创建动态内容或向用户显示自定义输出。名为html/template的兄弟包提供了相同的API,但具有额外的安全特性,应用于生成HTML。

package main

import (
    "os"
    "text/template"
)

func main() {

    // 我们可以创建一个新模板,并从字符串解析其主体。
    // 模板是静态文本和“操作”的组合,其中“操作”包含在`{{...}}`中,用于动态插入内容。
    t1 := template.New("t1")
    t1, err := t1.Parse("Value is {{.}}\n")
    if err != nil {
        panic(err)
    }

    // 或者,我们可以使用`template.Must`函数,在`Parse`返回错误时出现紧急情况。
    // 这对于在全局范围内初始化的模板尤其有用。
    t1 = template.Must(t1.Parse("Value: {{.}}\n"))

    // 通过“执行”模板,我们可以为其操作生成文本,并使用特定值替换`{{.}}`操作的参数。
    // 该`{{.}}`操作将被传递给`Execute`。
    t1.Execute(os.Stdout, "some text")
    t1.Execute(os.Stdout, 5)
    t1.Execute(os.Stdout, []string{
        "Go",
        "Rust",
        "C++",
        "C#",
    })

    // 我们将在下面使用的帮助器函数。
    Create := func(name, t string) *template.Template {
        return template.Must(template.New(name).Parse(t))
    }

    // 如果数据是结构体,我们可以使用`{{.FieldName}}`操作访问其字段。
    // 字段应导出以在模板执行时可访问。
    t2 := Create("t2", "Name: {{.Name}}\n")

    t2.Execute(os.Stdout, struct {
        Name string
    }{"Jane Doe"})

    // 对于映射,也是同样的方法,不限制键名的大小写。
    t2.Execute(os.Stdout, map[string]string{
        "Name": "Mickey Mouse",
    })

    // if/else语句为模板提供条件执行。
    // 如果一个值是一个类型的默认值,比如0、空字符串、nil指针等,它被认为是false。
   // 该示例演示了模板的另一个功能:在操作中使用“-”来修剪空格。
    t3 := Create("t3",
        "{{if . -}} yes {{else -}} no {{end}}\n")
    t3.Execute(os.Stdout, "not empty")
    t3.Execute(os.Stdout, "")

    // range块让我们循环遍历切片、数组、映射或通道。
    // 在range block内部,`{{.}}`设置为当前迭代的项目。
    t4 := Create("t4",
        "Range: {{range .}}{{.}} {{end}}\n")
    t4.Execute(os.Stdout,
        []string{
            "Go",
            "Rust",
            "C++",
            "C#",
        })
}

运行结果如下:

$ go run templates.go 
Value: some text
Value: 5
Value: [Go Rust C++ C#]
Name: Jane Doe
Name: Mickey Mouse
yes 
no 
Range: Go Rust C++ C#