Go模板template用法详解

下面我将详细讲解一下“Go模板template用法详解”的完整攻略。

什么是Go模板template？

Go模板(template)是一个文本量不大但是功能却相当强大的模板引擎，主要用于生成HTML以及其他类型的文本文件。它是Go语言自带的功能强大的模板引擎，可以根据数据生成任何格式的文本输出，例如HTML、XML、CSS、JavaScript等。

Go模板template的语法

Go模板template提供了以下基本的语法：

1. 输出文本

使用双花括号{{}}来输出文本，例如：

{{.title}}

这个模板语句会输出该模板的数据结构中的“title”字段。

2. 控制语句

Go模板提供了一系列控制语句，用于控制模板的输出。常见的控制语句有以下几种：

• if控制语句

{{if .isAdmin}} 
<h1>Welcome Admin</h1> 
{{end}}

这个模板语句会根据模板数据结构中“isAdmin”字段的值输出对应的欢迎语。

• range控制语句

{{range .}}
    <li>{{.}}</li>
{{end}}

这个模板语句会遍历模板数据结构的每一项，生成对应的HTML列表项。

• with控制语句

{{with .title}}
    <h1>{{.}}</h1>
{{end}}

这个模板语句会输出模板数据结构中“title”字段对应的内容。

Go模板template的使用方法

Go模板template的使用方法非常简单，主要包括以下几个步骤：

1. 创建模板

使用template.New()函数创建模板对象，例如：

t := template.New("test")

2. 注册模板

使用t.Parse()函数注册模板，并获取模板对象，例如：

t, err := t.Parse("<h1>{{.title}}</h1>")

这个模板语句会将<h1>{{.title}}</h1>作为t模板对象的内容。

3. 渲染模板

使用模板对象的Execute()方法渲染模板，例如：

data := map[string]string{"title": "Hello World!"}
err = t.Execute(os.Stdout, data)

这个模板语句会将data数据结构中的"title"字段和模板对象内容的{{.title}}占位符进行替换，然后输出到标准输出。

两条示例说明

示例一：基本语法

package main

import (
    "os"
    "text/template"
)

func main() {
    t, err := template.New("example").Parse("Hello, {{.}}!\n")
    if err != nil {
        panic(err)
    }
    data := "World"
    err = t.Execute(os.Stdout, data)
    if err != nil {
        panic(err)
    }
}

这个示例会输出“Hello, World!”。

该示例使用了模板语法中的基本语法，使用{{.}}这个占位符输出data数据结构中的值。

示例二：流程控制

package main 

import ( 
    "encoding/json" 
    "log" 
    "os" 
    "text/template" 
) 

type Person struct { 
    Name string 
    Age int 
}

func main() { 
    tmpl := template.Must(template.New("example").Parse(`
        List of People:
        {{range .}}
            Name: {{ .Name }}
            Age: {{ .Age }}
        {{end}}
    `)) 

    people := []Person { 
        Person{"Mary", 20}, 
        Person{"Bob", 30}, 
        Person{"Alice", 25}, 
    } 

    if err := tmpl.Execute(os.Stdout, people); err != nil { 
        log.Fatalf("Failed to execute template: %v", err) 
    } 

    asJson, _ := json.Marshal(people) 
    log.Printf("List of People as JSON: %s\n", asJson) 
}

该示例展示了如何使用流程控制语句遍历数据结构。

该示例的模板使用了range语句遍历了一个人物列表，并输出了该列表的每一项内容。

运行该示例会输出每一个人物的姓名和年龄，并最终输出对应人物列表的JSON字符串。

总结

本篇攻略详细讲解了Go模板template的基本语法、使用方法和两个示例，希望对读者在日常开发中使用Go模板template有所帮助。如果读者想要深入了解请参考官方文档。