在 Go 的 html/template 包中实现可选模板是一个常见的需求。当主模板依赖于某些子模板，但并非所有子模板都定义了这些依赖项时，会遇到“no such template”错误。本文将介绍一种简单有效的解决方案，即在主模板中定义空模板，从而允许子模板选择性地覆盖它们。
问题背景
在使用 Go 的 html/template 包时，我们经常需要将多个模板文件组合在一起。例如，一个 layout.tpl 文件定义了页面的整体结构，而 home.tpl 和 edit.tpl 文件则定义了页面的具体内容。
假设 layout.tpl 文件中包含一个 {{template extracss}} 语句，用于插入额外的 CSS 样式。但是，并非所有的内容模板都需要额外的 CSS 样式。如果 home.tpl 文件没有定义 extracss 模板，那么在解析模板时就会出现 "no such template" 错误。
解决方案
一个简单的解决方案是在主模板中定义一个空的 extracss 模板：
立即学习“前端免费学习笔记（深入）”；
<html>
<head>
<title>Some title</title>
{{define "extracss"}}{{end}}
</head>
<body>
<h1>Page title</h1>
{{template content .}}
</body>
</html>这样，即使子模板没有定义 extracss 模板，也不会出现错误。如果子模板需要额外的 CSS 样式，可以像下面这样定义 extracss 模板：
{{define "extracss"}}<style>body{background:pink}</style>{{end}}示例代码
以下是一个完整的示例代码：
package main
import (
"html/template"
"net/http"
)
func Render(w http.ResponseWriter, tmpname string, data interface{}) {
t, err := template.ParseFiles("views/layout.tpl", "views/"+tmpname+".tpl")
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
if err := t.Execute(w, data); err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
}
func main() {
http.HandleFunc("/home", func(w http.ResponseWriter, r *http.Request) {
Render(w, "home", nil)
})
http.HandleFunc("/edit", func(w http.ResponseWriter, r *http.Request) {
Render(w, "edit", nil)
})
http.ListenAndServe(":8080", nil)
}目录结构：
.
├── main.go
└── views
├── edit.tpl
├── home.tpl
└── layout.tplviews/layout.tpl 内容：
<html>
<head>
<title>Some title</title>
{{define "extracss"}}{{end}}
{{template extracss}}
</head>
<body>
<h1>Page title</h1>
{{template content .}}
</body>
</html>views/home.tpl 内容：
{{define "content"}}
<p>page content goes here</p>
{{end}}views/edit.tpl 内容：
{{define "content"}}
<form>form content goes here</form>
{{end}}
{{define "extracss"}}<style>body{background:pink}</style>{{end}}注意事项
- 空的 extracss 模板只需要在主模板中定义一次。
- 子模板可以根据需要选择性地覆盖 extracss 模板。
- 这种方法可以应用于任何可选的模板，不仅仅是 extracss 模板。
总结
通过在主模板中定义空模板，我们可以轻松地实现 Go HTML 模板中的可选模板。这种方法简单易懂，并且可以有效地避免 "no such template" 错误。这种技巧在构建复杂 Web 应用时非常有用，可以提高代码的可维护性和灵活性。
