Go html/template 模板的使用实例

栏目: Html · 发布时间: 4年前

内容简介：我们可以定义模板字符串，然后载入并解析渲染：模板文件，建议为每个模板文件显式的定义模板名称：

从字符串载入模板

我们可以定义模板字符串，然后载入并解析渲染：

template.New(tplName string).Parse(tpl string)

// 从字符串模板构建
tplStr := `
    {{ .Name }} {{ .Age }}
`
// if parse failed Must will render a panic error
tpl := template.Must(template.New("tplName").Parse(tplStr))
tpl.Execute(os.Stdout, map[string]interface{}{Name: "big_cat", Age: 29})

从文件载入模板

模板语法

模板文件，建议为每个模板文件显式的定义模板名称： {{ define "tplName" }} ，否则会因模板对象名与模板名不一致，无法解析（条件分支很多，不如按一种标准写法实现），另展示一些基本的模板语法。

使用 {{ define "tplName" }} 定义模板名
使用 {{ template "tplName" . }} 引入其他模板
使用 . 访问当前数据域：比如 range 里使用 . 访问的其实是循环项的数据域
使用 $. 访问绝对顶层数据域

views/header.html

{{ define "header" }}
<!doctype html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport"
          content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>{{ .PageTitle }}</title>
</head>
{{ end }}

views/footer.html

{{ define  "footer" }}
</html>
{{ end }}

views/index/index.html

{{ define "index/index" }}
    {{/*引用其他模板 注意后面的 . */}}
    {{ template "header" . }}
    <body>
    <div>
        hello, {{ .Name }}, age {{ .Age }}
    </div>
    </body>
    {{ template "footer" . }}
{{ end }}

views/news/index.html

{{ define "news/index" }}
    {{ template "header" . }}
    <body>
    {{/* 页面变量定义 */}}
    {{ $pageTitle := "news title" }}
    {{ $pageTitleLen := len $pageTitle }}
    {{/* 长度 > 4 才输出 eq ne gt lt ge le */}}
    {{ if gt $pageTitleLen 4 }}
        <h4>{{ $pageTitle }}</h4>
    {{ end }}

    {{ $c1 := gt 4 3}}
    {{ $c2 := lt 2 3 }}
    {{/*and or not 条件必须为标量值 不能是逻辑表达式 如果需要逻辑表达式请先求值*/}}
    {{ if and $c1 $c2 }}
        <h4>1 == 1 3 > 2 4 < 5</h4>
    {{ end }}

    <div>
        <ul>
            {{ range .List }}
                {{ $title := .Title }}
                {{/* .Title 上下文变量调用    func param1 param2 方法/函数调用   $.根节点变量调用 */}}
                <li>{{ $title }} -- {{ .CreatedAt.Format "2006-01-02 15:04:05" }} -- Author {{ $.Author }}</li>
            {{end}}
        </ul>
        {{/* !empty Total 才输出*/}}
        {{ with .Total }}
            <div>总数：{{ . }}</div>
        {{ end }}
    </div>
    </body>
    {{ template "footer" . }}
{{ end }}

template.ParseFiles

手动定义需要载入的模板文件，解析后制定需要渲染的模板名 news/index 。

// 从模板文件构建
tpl := template.Must(
    template.ParseFiles(
        "views/index/index.html",
        "views/news/index.html",
        "views/header.html",
        "views/footer.html",
    ),
)

// render template with tplName index
_ = tpl.ExecuteTemplate(
    os.Stdout,
    "index/index",
    map[string]interface{}{
        PageTitle: "首页",
        Name: "big_cat",
        Age: 29,
    },
)
// render template with tplName index
_ = tpl.ExecuteTemplate(
    os.Stdout,
    "news/index",
    map[string]interface{}{
        "PageTitle": "新闻",
        "List": []struct {
            Title     string
            CreatedAt time.Time
        }{
            {Title: "this is golang views/template example", CreatedAt: time.Now()},
            {Title: "to be honest, i don't very like this raw engine", CreatedAt: time.Now()},
        },
        "Total":  1,
        "Author": "big_cat",
    },
)

template.ParseGlob

手动的指定每一个模板文件，在一些场景下难免难以满足需求，我们可以使用通配符正则匹配载入。

1、正则不应包含文件夹，否则会因文件夹被作为视图载入无法解析而报错

// 从模板文件构建
tpl := template.Must(template.ParseGlob("views/*.html"))
template.Must(tpl.ParseGlob("views/*/*.html"))
// render template with tplName index
// render template with tplName index
_ = tpl.ExecuteTemplate(
    os.Stdout,
    "index/index",
    map[string]interface{}{
        PageTitle: "首页",
        Name: "big_cat",
        Age: 29,
    },
)
// render template with tplName index
_ = tpl.ExecuteTemplate(
    os.Stdout,
    "news/index",
    map[string]interface{}{
        "PageTitle": "新闻",
        "List": []struct {
            Title     string
            CreatedAt time.Time
        }{
            {Title: "this is golang views/template example", CreatedAt: time.Now()},
            {Title: "to be honest, i don't very like this raw engine", CreatedAt: time.Now()},
        },
        "Total":  1,
        "Author": "big_cat",
    },
)

Web服务器

结合模板库和 Gin 实现一个可以使用模板渲染并返回 html 页面的 web 服务。

package main

import (
    "html/template"
    "log"
    "net/http"
    "time"
)

var (
    htmlTplEngine    *template.Template
    htmlTplEngineErr error
)

func init() {
    // 初始化模板引擎 并加载各层级的模板文件
    // 注意 views/* 不会对子目录递归处理 且会将子目录匹配 作为模板处理造成解析错误
    // 若存在与模板文件同级的子目录时 应指定模板文件扩展名来防止目录被作为模板文件处理
    // 然后通过 view/*/*.html 来加载 view 下的各子目录中的模板文件
    htmlTplEngine = template.New("htmlTplEngine")

    // 模板根目录下的模板文件 一些公共文件
    _, htmlTplEngineErr = htmlTplEngine.ParseGlob("views/*.html")
    if nil != htmlTplEngineErr {
        log.Panic(htmlTplEngineErr.Error())
    }
    // 其他子目录下的模板文件
    _, htmlTplEngineErr = htmlTplEngine.ParseGlob("views/*/*.html")
    if nil != htmlTplEngineErr {
        log.Panic(htmlTplEngineErr.Error())
    }

}

// index
func IndexHandler(w http.ResponseWriter, r *http.Request) {
    _ = htmlTplEngine.ExecuteTemplate(
        w,
        "index/index",
        map[string]interface{}{"PageTitle": "首页", "Name": "sqrt_cat", "Age": 25},
    )
}

// news
func NewsHandler(w http.ResponseWriter, r *http.Request) {
    _ = htmlTplEngine.ExecuteTemplate(
        w,
        "news/index",
        map[string]interface{}{
            "PageTitle": "新闻",
            "List": []struct {
                Title     string
                CreatedAt time.Time
            }{
                {Title: "this is golang views/template example", CreatedAt: time.Now()},
                {Title: "to be honest, i don't very like this raw engine", CreatedAt:  time.Now()},
            },
            "Total":  1,
            "Author": "big_cat",
        },
    )
}

func main() {
    http.HandleFunc("/", IndexHandler)
    http.HandleFunc("/index", IndexHandler)
    http.HandleFunc("/news", NewsHandler)

    serverErr := http.ListenAndServe(":8085", nil)

    if nil != serverErr {
        log.Panic(serverErr.Error())
    }
}

注意 ：模板对象是有名字属性的， template.New("tplName") ，如果没有显示的定义名字，则会使用第一个被载入的视图文件的 baseName 做默认名，比如我们使用 template.ParseFiles/template.ParseGlob 直接生成模板对象时，没有指定模板对象名，则会使用第一个被载入的文件，比如 views/index/index.html 的 baseName 即 index.html 做默认名，而后如果 tplObj.Execute 方法执行渲染时，会去查找名为 index.html 的模板，所以常用的还是 tplObj.ExecuteTemplate 自己指定要渲染的模板名，省的一团乱。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络，本站转载出于传递更多信息之目的，版权归原作者或者来源机构所有，如转载稿涉及版权问题，请联系我们。

码农书籍

硅谷之火

迈克尔·斯韦因 / 王建华 / 机械工业出版社 / 2001-1-1 / 34.00

我们今天正处于这样一个时代：充满幻想的人们发现他们获得了他们曾经梦寐以求的力量，并且可以利用这个力量来改造我们的世界。这是个转折的时代，跨国公司迷失了发展方向，而小企业家却举起了计算机革命的大旗，成了开拓未来的先锋。在这个时代里，计算机奇才的脸上露出了胜利的微笑，胸怀大志者成了富有理想的人，而富有理想的人则成了亿万富翁。这是一场真正的革命，它促使人们变得伟大，变得富有而充满理想，自豪而富......一起来看看《硅谷之火》这本书的介绍吧!

码农工具