Go html/template 模板的使用實例詳解
更新時間：2019年05月31日 15:13:19 作者：big_cat
這篇文章主要介紹了Go html/template 模板的使用實例詳解，小編覺得挺不錯的，現在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧
從字符串載入模板
我們可以定義模板字符串，然后載入并解析渲染：
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 里使用 . 訪問的其實是循環(huán)項的數據域
- 使用 $. 訪問絕對頂層數據域
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 方法/函數調用 $.根節(jié)點變量調用 */}}
<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、正則不應包含文件夾，否則會因文件夾被作為視圖載入無法解析而報錯
2、可以設定多個模式串，如下我們載入了一級目錄和二級目錄的視圖文件
// 從模板文件構建
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 方法執(zhí)行渲染時，會去查找名為 index.html 的模板，所以常用的還是 tplObj.ExecuteTemplate 自己指定要渲染的模板名，省的一團亂。
以上就是本文的全部內容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。
相關文章
這篇文章主要介紹了golang 替換掉字符串里面的換行符\n操作，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2021-03-03
golang替換無法顯示的特殊字符(\u0000,?\000,?^@)
這篇文章主要介紹了golang替換無法顯示的特殊字符,包括的字符有\(zhòng)u0000,?\000,?^@等，下文詳細資料，需要的小伙伴可以參考一下2022-04-04
這篇文章主要介紹了go語言制作的zip壓縮程序，其主體思路是首先創(chuàng)建一個讀寫緩沖，然后用壓縮器包裝該緩沖，用Walk方法來將所有目錄下的文件寫入zip，有需要的小伙伴參考下。2015-03-03
這篇文章主要介紹了Go語言執(zhí)行系統(tǒng)命令行命令的方法,實例分析了Go語言操作系統(tǒng)命令行的技巧,具有一定參考借鑒價值,需要的朋友可以參考下2015-02-02
這篇文章主要為大家介紹了Go?Redis客戶端使用對比詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2022-07-07
Go gorilla securecookie庫的安裝使用詳解
這篇文章主要介紹了Go gorilla securecookie庫的安裝使用詳解,有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2022-08-08
HMAC（Hash-based Message Authentication Code）是一種基于 Hash 函數和密鑰的消息認證碼,HMAC將密鑰、消息和哈希函數一起使用,確保消息在傳輸過程中不被篡改,還可以驗證消息的發(fā)送者身份,本文詳細講解了如何在Golang中實現HMAC,需要的朋友可以參考下2023-11-11
這篇文章主要介紹了Golang精編49面試題匯總(選擇題),本文章內容詳細，具有很好的參考價值，希望對大家有所幫助，需要的朋友可以參考下2023-01-01
SVG是可伸縮矢量圖形?(Scalable?Vector?Graphics)，于2003年1月14日成為?W3C?推薦標準。本文將利用Go語言實現制作svg格式樹形圖，感興趣的可以了解一下2022-09-09
在Golang中,模塊（module）是Go 1.11版本引入的依賴管理系統(tǒng),幫助開發(fā)者管理項目的依賴,在Go模塊推出之前,開發(fā)者通常使用GOPATH和vendor目錄來管理項目的依賴,本文將給大家詳細介紹Golang的模塊版本管理與語義版本控制,需要的朋友可以參考下2023-12-12