echo/website/content/guide/templates.md

+++ title = "Templates" description = "How to use templates in Echo" [menu.main] name = "Templates" parent = "guide" weight = 3 +++

Template Rendering

Context#Render(code int, name string, data interface{}) error renders a template with data and sends a text/html response with status code. Templates can be registered using Echo.SetRenderer(), allowing us to use any template engine.

Example below shows how to use Go html/template:

1. Implement echo.Renderer interface

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

2. Pre-compile templates

   public/views/hello.html

   {{define "hello"}}Hello, {{.}}!{{end}}
   

   t := &Template{
       templates: template.Must(template.ParseGlob("public/views/*.html")),
   }
   

3. Register templates

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

4. Render a template inside your handler

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