### 模板
#### 模板渲染
* Context#ViewData().Set(key string, value interface{}) error
用于向模板传递自定义数据,可多次调用
* Context#View(name string) error
Context#ViewC(code int, name string) error
用于渲染一个模板,然后可选择发送一个 text/html 的状态响应,默认为200。我们可以使用任何模板引擎,只要实现DotWeb.Renderer接口,并使用 DotWeb.HttpServer#SetRenderer()注册。
* Renderer#SetTemplatePath(path ...string)
用于设置模板引擎默认搜索目录,板查找顺序从最后一个插入的元素开始往前找
默认设置:
* 框架默认自带Go html/template的Render实现
* 模板根目录默认添加base、base/templates、base/views,其中base为执行文件所在目录
#### 默认Go html/template用法:
~~~
app.HttpServer.Renderer().SetTemplatePath("/wwwroot/views/")
func TestView(ctx dotweb.Context) error {
ctx.ViewData().Set("data", "图书信息")
ctx.ViewData().Set("user", &UserInfo{UserName: "user1", Sex: true})
err := ctx.View("testview.html")
return err
}
~~~
首先设置模板默认目录,在使用模板时,只需指定模板名称即可。
testview.html:
~~~
<html>
<head><title>load common template</title></head>
<body>
<h1>{{.data}}</h1>
<div>
<b>User Profile:</b>
<br>
UserName => {{.user.UserName}}
<br>
Sex => {{.user.Sex}}
</div>
</body>
</html>
~~~
#### 自定义模板
通过实现DotWeb.Renderer接口,并使用 DotWeb.HttpServer#SetRenderer()注册。
例如,我们使用github.com/CloudyKit/jet 模板
首先,我们定义struct
~~~
type jetRenderer struct {
htmlSet *Set
}
~~~
实现Render接口
~~~
func (r *jetRenderer) Render(w io.Writer, tpl string, data interface{}, ctx *dotweb.HttpContext) error {
view, err := r.htmlSet.GetTemplate(tpl)
fmt.Println(view, err)
if err != nil {
fmt.Println("Unexpected template err:", err.Error())
}
//if use vars mode, template not use "."
vars := convertMapToVar(data)
return view.Execute(w, vars, nil)
//if use data mode, template use "."
//return view.Execute(w, nil, data)
}
~~~
实现SetTemplatePath接口
~~~
func (r *jetRenderer) SetTemplatePath(path ...string) {
r.htmlSet = jet.NewHTMLSet(path)
}
~~~
实现New函数
~~~
func NewJetRenderer() *jetRenderer {
r := new(jetRenderer)
return r
}
~~~
注册jet模板
~~~
app.HttpServer.SetRenderer(NewJetRenderer().Reload(true))
app.HttpServer.Renderer().SetTemplatePath("/wwwroot/views/")
~~~
到此,就已经实现了自定义Render,在Context中的使用方法与默认模板一致