Go html/template 模板的使用实例详解

2023-08-22 18:59:04 74

从字符串载入模板

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

template.New(tplNamestring).Parse(tplstring)

//从字符串模板构建
tplStr:=`
{{.Name}}{{.Age}}
`
//ifparsefailedMustwillrenderapanicerror
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"}}






{{.PageTitle}}

{{end}}
views/footer.html
{{define"footer"}}

{{end}}

views/index/index.html

{{define"index/index"}}
{{/*引用其他模板注意后面的.*/}}
{{template"header".}}


hello,{{.Name}},age{{.Age}}


{{template"footer".}}
{{end}}

views/news/index.html

{{define"news/index"}}
{{template"header".}}

{{/*页面变量定义*/}}
{{$pageTitle:="newstitle"}}
{{$pageTitleLen:=len$pageTitle}}
{{/*长度>4才输出eqnegtltgele*/}}
{{ifgt$pageTitleLen4}}
{{$pageTitle}}
{{end}}

{{$c1:=gt43}}
{{$c2:=lt23}}
{{/*andornot条件必须为标量值不能是逻辑表达式如果需要逻辑表达式请先求值*/}}
{{ifand$c1$c2}}
1==13>24<5
{{end}}



{{range.List}}
{{$title:=.Title}}
{{/*.Title上下文变量调用funcparam1param2方法/函数调用$.根节点变量调用*/}}
{{$title}}--{{.CreatedAt.Format"2006-01-0215:04:05"}}--Author{{$.Author}}
{{end}}

{{/*!emptyTotal才输出*/}}
{{with.Total}}
总数：{{.}}
{{end}}


{{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",
),
)

//rendertemplatewithtplNameindex
_=tpl.ExecuteTemplate(
os.Stdout,
"index/index",
map[string]interface{}{
PageTitle:"首页",
Name:"big_cat",
Age:29,
},
)
//rendertemplatewithtplNameindex
_=tpl.ExecuteTemplate(
os.Stdout,
"news/index",
map[string]interface{}{
"PageTitle":"新闻",
"List":[]struct{
Titlestring
CreatedAttime.Time
}{
{Title:"thisisgolangviews/templateexample",CreatedAt:time.Now()},
{Title:"tobehonest,idon'tverylikethisrawengine",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"))
//rendertemplatewithtplNameindex
//rendertemplatewithtplNameindex
_=tpl.ExecuteTemplate(
os.Stdout,
"index/index",
map[string]interface{}{
PageTitle:"首页",
Name:"big_cat",
Age:29,
},
)
//rendertemplatewithtplNameindex
_=tpl.ExecuteTemplate(
os.Stdout,
"news/index",
map[string]interface{}{
"PageTitle":"新闻",
"List":[]struct{
Titlestring
CreatedAttime.Time
}{
{Title:"thisisgolangviews/templateexample",CreatedAt:time.Now()},
{Title:"tobehonest,idon'tverylikethisrawengine",CreatedAt:time.Now()},
},
"Total":1,
"Author":"big_cat",
},
)

Web服务器

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

packagemain

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

var(
htmlTplEngine*template.Template
htmlTplEngineErrerror
)

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

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

}

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

//news
funcNewsHandler(whttp.ResponseWriter,r*http.Request){
_=htmlTplEngine.ExecuteTemplate(
w,
"news/index",
map[string]interface{}{
"PageTitle":"新闻",
"List":[]struct{
Titlestring
CreatedAttime.Time
}{
{Title:"thisisgolangviews/templateexample",CreatedAt:time.Now()},
{Title:"tobehonest,idon'tverylikethisrawengine",CreatedAt:time.Now()},
},
"Total":1,
"Author":"big_cat",
},
)
}

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

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

ifnil!=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自己指定要渲染的模板名，省的一团乱。

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

Go html/template 模板的使用实例详解

{{$pageTitle}}

1==13>24<5

热门推荐

随机推荐