HTML rendering

Using LoadHTMLGlob() or LoadHTMLFiles()

  1. func main() {
  2.     router := gin.Default()
  3.     router.LoadHTMLGlob("templates/*")
  4.     //router.LoadHTMLFiles("templates/template1.html", "templates/template2.html")
  5.     router.GET("/index", func(c *gin.Context) {
  6.         c.HTML(http.StatusOK, "index.tmpl", gin.H{
  7.             "title": "Main website",
  8.         })
  9.     })
  10.     router.Run(":8080")
  11. }

templates/index.tmpl

  1. <html>
  2.     <h1>
  3.         {{ .title }}
  4.     </h1>
  5. </html>

Using templates with same name in different directories

  1. func main() {
  2.     router := gin.Default()
  3.     router.LoadHTMLGlob("templates/**/*")
  4.     router.GET("/posts/index", func(c *gin.Context) {
  5.         c.HTML(http.StatusOK, "posts/index.tmpl", gin.H{
  6.             "title": "Posts",
  7.         })
  8.     })
  9.     router.GET("/users/index", func(c *gin.Context) {
  10.         c.HTML(http.StatusOK, "users/index.tmpl", gin.H{
  11.             "title": "Users",
  12.         })
  13.     })
  14.     router.Run(":8080")
  15. }

templates/posts/index.tmpl

  1. {{ define "posts/index.tmpl" }}
  2. <html><h1>
  3.     {{ .title }}
  4. </h1>
  5. <p>Using posts/index.tmpl</p>
  6. </html>
  7. {{ end }}

templates/users/index.tmpl

  1. {{ define "users/index.tmpl" }}
  2. <html><h1>
  3.     {{ .title }}
  4. </h1>
  5. <p>Using users/index.tmpl</p>
  6. </html>
  7. {{ end }}

Custom Template renderer

You can also use your own html template render

  1. import "html/template"
  3. func main() {
  4.     router := gin.Default()
  5.     html := template.Must(template.ParseFiles("file1", "file2"))
  6.     router.SetHTMLTemplate(html)
  7.     router.Run(":8080")
  8. }

Custom Delimiters

You may use custom delims

  1.     r := gin.Default()
  2.     r.Delims("{[{", "}]}")
  3.     r.LoadHTMLGlob("/path/to/templates"))

Custom Template Funcs

See the detail example code.

main.go

  1. import (
  2.     "fmt"
  3.     "html/template"
  4.     "net/http"
  5.     "time"
  7.     "github.com/gin-gonic/gin"
  8. )
  10. func formatAsDate(t time.Time) string {
  11.     year, month, day := t.Date()
  12.     return fmt.Sprintf("%d%02d/%02d", year, month, day)
  13. }
  15. func main() {
  16.     router := gin.Default()
  17.     router.Delims("{[{", "}]}")
  18.     router.SetFuncMap(template.FuncMap{
  19.         "formatAsDate": formatAsDate,
  20.     })
  21.     router.LoadHTMLFiles("./fixtures/basic/raw.tmpl")
  23.     router.GET("/raw", func(c *gin.Context) {
  24.         c.HTML(http.StatusOK, "raw.tmpl", map[string]interface{}{
  25.             "now": time.Date(2017, 07, 01, 0, 0, 0, 0, time.UTC),
  26.         })
  27.     })
  29.     router.Run(":8080")
  30. }

raw.tmpl

  1. Date: {[{.now | formatAsDate}]}

Result:

  1. Date: 2017/07/01