个人技术分享

1 模板文件

重构 articlesCreateHandler() 和 articlesStoreHandler() 函数,将 HTML 抽离并放置于独立的模板文件中。

1.1 articlesStoreHandler() 使用模板文件

.
.
.
func articlesStoreHandler(w http.ResponseWriter, r *http.Request) {
    .
    .
    .

    // 检查是否有错误
    if len(errors) == 0 {
        .
        .
        .
    } else {

        storeURL, _ := router.Get("articles.store").URL()

        data := ArticlesFormData{
            Title:  title,
            Body:   body,
            URL:    storeURL,
            Errors: errors,
        }
        tmpl, err := template.ParseFiles("resources/views/articles/create.gohtml")
        if err != nil {
            panic(err)
        }

        err = tmpl.Execute(w, data)
        if err != nil {
            panic(err)
        }
    }
}
.
.
.

以上的修改:1. 删了 html 变量, 2. 使用以下这段代码加载模板文件,其他代码保持不变:

tmpl, err := template.ParseFiles("resources/views/articles/create.gohtml")

关于模板后缀名 .gohtml ,可以使用任意后缀名,这不会影响代码的运行。常见的 Go 模板后缀名有 .tmpl、.tpl、 .gohtml 等。

接下来创建模板文件:
resources/views/articles/create.gohtml //直接创建文件,对应的目录也会生成

<!DOCTYPE html>
<html lang="en">
<head>
    <title>创建文章 —— 我的技术博客</title>
    <style type="text/css">.error {color: red;}</style>
</head>
<body>
    <form action="{{ .URL }}" method="post">
        <p><input type="text" name="title" value="{{ .Title }}"></p>
        {{ with .Errors.title }}
        <p class="error">{{ . }}</p>
        {{ end }}
        <p><textarea name="body" cols="30" rows="10">{{ .Body }}</textarea></p>
        {{ with .Errors.body }}
        <p class="error">{{ . }}</p>
        {{ end }}
        <p><button type="submit">提交</button></p>
    </form>
</body>
</html>

浏览器访问 localhost:3000/articles/create
在这里插入图片描述

1.2 统一模板

修改 articlesCreateHandler的代码来加载同一个模板:

func articlesCreateHandler(w http.ResponseWriter, r *http.Request) {

    storeURL, _ := router.Get("articles.store").URL()
    data := ArticlesFormData{
        Title:  "",
        Body:   "",
        URL:    storeURL,
        Errors: nil,
    }
    tmpl, err := template.ParseFiles("resources/views/articles/create.gohtml")
    if err != nil {
        panic(err)
    }

    err = tmpl.Execute(w, data)
    if err != nil {
        panic(err)
    }
}

访问 localhost:3000/articles/create :
在这里插入图片描述

2 模板语法

{{}}是默认的模板界定符,模板语法包含在中间。
resources\views\articles\create.gohtml
查看模板文件里的内容

<!DOCTYPE html>
<html lang="en">
<head>
    <title>创建文章 —— 我的技术博客</title>
    <style type="text/css">.error {color: red;}</style>
</head>
<body>
    <form action="{{ .URL }}" method="post">
        <p><input type="text" name="title" value="{{ .Title }}"></p>
        {{ with .Errors.title }}
        <p class="error">{{ . }}</p>
        {{ end }}
        <p><textarea name="body" cols="30" rows="10">{{ .Body }}</textarea></p>
        {{ with .Errors.body }}
        <p class="error">{{ . }}</p>
        {{ end }}
        <p><button type="submit">提交</button></p>
    </form>
</body>
</html>

2.1 {{.}} 语句

<form action="{{ .URL }}" method="post">

{{ . }} 中的点表示当前对象。当我们传入一个结构体对象时,我们可以使用 . 来访问结构体的对应字段。同理,当我们传入的变量是 map 时,也可以在模板文件中通过 . 根据 key 来取值。

2.2 with 关键字

{{ with .Errors.title }}
<p class="error">{{ . }}</p>
{{ end }}

语法

{{ with pipeline }} T1 {{ end }}
如果 pipeline 为空则不产生输出,否则将 . 设为 pipeline 的值并执行 T1。不修改外面的 . 。

{{ with pipeline }} T1 {{ else }} T0 {{ end }}
如果 pipeline 为空则不改变 . 并执行 T0,否则 . 设为 pipeline 的值并执行 T1。

2.3 pipeline管道

pipeline 是指产生数据的操作。比如 {{ . }}、{{ .Name }} 等。Go 的模板语法支持使用管道符号 | 连接多个命令,用法和 Unix 下的管道类似 —— | 前面的命令会将运算结果 (或返回值) 传递给后一个命令的最后一个位置。
go模板中,pipeline的概念是传递数据,只要能产生数据就是pipeline。

3 其他语法

3.1 注释

{{/* 这是一个注释 */}}

3.2 变量

用来保存传入模板的数据或其他语句生成的结果

$variable := {{ . }}

3.3 移除空格

有时会不可避免的引入空格或者换行符,导致模板最终渲染结果不符预期。这种情况可以使用 {{- 语法去除模板内容左侧的所有空白符号, 使用 -}} 去除模板内容右侧的所有空白符号。

{{- .Name -}}

3.4 条件判断

{{if pipeline}} T1 {{end}}

{{if pipeline}} T1 {{else}} T0 {{end}}

{{if pipeline}} T1 {{else if pipeline}} T0 {{end}}

3.5 range 遍历

{{range pipeline}} T1 {{end}}
如果 pipeline 的值其长度为 0,不会有任何输出

{{range pipeline}} T1 {{else}} T0 {{end}}
如果 pipeline 的值其长度为 0,则会执行 T0。

3.6 修改默认的标识符

Go 标准库的模板引擎使用的花括号 {{和}} 作为标识,而许多前端框架(如 Vue 和 AngularJS)也使用 {{和}} 作为标识符,所以当我们同时使用 Go 语言模板引擎和以上前端框架时就会出现冲突,这个时候我们需要修改标识符,修改前端的或者修改 Go 语言的。这里演示如何修改 Go 语言模板引擎默认的标识符:

template.New(“test”).Delims(“{[”, “]}”).ParseFiles(“filename.gohtml”)
这行代码的含义是创建一个名为"test"的模板,并设置该模板的分隔符为"{[“和”]}",然后从文件"filename.gohtml"中解析模板内容。这意味着模板中的控制结构和变量插值将使用新的分隔符,并且模板内容将从指定的文件中读取。