title: 模板 url : guide/templates menu: side: parent: guide

  1. weight: 11

模板

模板渲染

使用 Context#Render(code int, name string, data interface{}) error 命令渲染带有数据的模板，并发送带有状态代码的 text / html 响应。通过 Echo.Renderer 的设置我们可以使用任何模板引擎。

下面是使用 Go html/template 的示例：

  1. 实现 echo.Renderer 接口

    1. type Template struct {
    2.     templates *template.Template
    3. }
    5. func (t *Template) Render(w io.Writer, name string, data interface{}, c echo.Context) error {
    6.     return t.templates.ExecuteTemplate(w, name, data)
    7. }

  2. 预编译模板

    public/views/hello.html

    1. {{define "hello"}}Hello, {{.}}!{{end}}
    1. t := &Template{
    2.     templates: template.Must(template.ParseGlob("public/views/*.html")),
    3. }

  3. 声明模板

    1. e := echo.New()
    2. e.Renderer = t
    3. e.GET("/hello", Hello)

  4. 在 action 中渲染模板

    1. func Hello(c echo.Context) error {
    2.      return c.Render(http.StatusOK, "hello", "World")
    3.  }

高级 - 在模版中调用 Echo

在某些情况下，从模板生成 uri 可能很有用，为此，您需要从模板本身调用 Echo#Reverse。此时，Golang 的 html/template 包并不一定合适这种情况，但我们可以通过两种方法实现它：第一种，给所有的传递到模版的对象提供一个公用的方法；第二种，将 map[string]interface{} 作为参数传递并在自定义渲染器中扩充此模版。鉴于后一种方法的灵活性，这里有一个示例程序： template.html

  1. <html>
  2.     <body>
  3.         <h1>Hello {{index . "name"}}</h1>
  5.         <p>{{ with $x := index . "reverse" }}
  6.            {{ call $x "foobar" }} &lt;-- this will call the $x with parameter "foobar"
  7.            {{ end }}
  8.         </p>
  9.     </body>
  10. </html>

server.go

  1. package main
  3. import (
  4.     "html/template"
  5.     "io"
  6.     "log"
  7.     "net/http"
  9.     "github.com/labstack/echo"
  10. )
  12. // TemplateRenderer is a custom html/template renderer for Echo framework
  13. type TemplateRenderer struct {
  14.     templates *template.Template
  15. }
  17. // Render renders a template document
  18. func (t *TemplateRenderer) Render(w io.Writer, name string, data interface{}, c echo.Context) error {
  20.     // Add global methods if data is a map
  21.     if viewContext, isMap := data.(map[string]interface{}); isMap {
  22.         viewContext["reverse"] = c.Echo().Reverse
  23.     }
  25.     return t.templates.ExecuteTemplate(w, name, data)
  26. }
  28. func main() {
  29.   e := echo.New()
  30.   renderer := &TemplateRenderer{
  31.       templates: template.Must(template.ParseGlob("*.html")),
  32.   }
  33.   e.Renderer = renderer
  35.   // Named route "foobar"
  36.   e.GET("/something", func(c echo.Context) error {
  37.       return c.Render(http.StatusOK, "something.html", map[string]interface{}{
  38.           "name": "Dolly!",
  39.       })
  40.   }).Name = "foobar"
  42.   log.Fatal(e.Start(":8000"))
  43. }