70f07e27e31b2e75ac7aec9358324efb.png

原文也可以在这里找到:

https://jiajunhuang.com/articles/2019_08_23-golang_html_template.md.html​jiajunhuang.com

模板语言,在前后端分离的时代,大概可以归类到上古时代的技术了。不过前后端分离并不是银弹(而且也只是 把模板从后端移到前端而已),它也有很多问题:

- SEO
- 需维护两套程序
- ...

模板语言仍然有它的用处,例如我的博客部署在一台512M的小机器上,起两套程序不仅写起来麻烦,而且内存占用 大,部署也不方便。

{{}}{{ }}jinja2

举个例子,看看这个博客的模板(https://github.com/jiajunhuang/blog/tree/master/templates):

{{ block "header.html" . }}{{ end }}

{{ .content }}

{{ block "footer.html" . }}{{ end }}

这是渲染这篇博客的模板,很明显,它由三部分组成:

header.html{{ .content }}footer.html

它的写法,就是把一个完整的HTML页面拆成几个部分,然后进行拼装。有点像这样的意思:

function renderHeader() {
    renderNavbar()
    renderPartOfBody()
}

function renderContent() {
    renderContentBody()
}

function renderFooter() {
    renderPartOfBody()
    renderSidebar()
    renderBottom()
}

renderHeader()
renderContent()
renderFooter()

接下来我们来看看具体的语法:

{{ define "layout" }}{{ end }}define{{ block "template filename" . }} {{ end }}..{{ range $i := .items }} {{ end }}for i := range items{{ if .items }}if items{{if pipeline}} T1 {{else if pipeline}} T0 {{end}}{{ .variable }}variable{{/* a comment */}}{{- /* a comment with white space trimmed from preceding and following text */ -}}
template.HTML("blablabla")templatehtml/template

例如,这个博客输出RSS的Controller是这样的:

// RSSHandler RSS
func RSSHandler(c *gin.Context) {
	c.Header("Content-Type", "application/xml")
	c.HTML(
		http.StatusOK, "rss.html", gin.H{
			"rssHeader": template.HTML(`<?xml version="1.0" encoding="UTF-8"?>`),
			"articles":  articles,
		},
	)
}

模板是这样的:

{{ .rssHeader }}
<rss version="2.0">
    <channel>
        <title>Jiajun的编程随想</title>
        <link>https://jiajunhuang.com</link>
        <description>Jiajun的编程随想</description>

        {{ range $article := .articles }}
            <item>
                <title>{{ .Title }}</title>
                <link>https://jiajunhuang.com/{{ .DirName }}/{{ .Filename }}.html</link>
                <description>{{ .Title }}</description>
            </item>
        {{ end }}

    </channel>
</rss>
<

参考资料:

  • https://golang.org/pkg/text/template/