Templates

Iris gives you the freedom to render templates through html/template, Django-syntax package Pongo2, Raw Markdown, Amber or Jade via ** iris.Config().Render.Template.Engine = iris.___Engine**.

iris.HTMLEngine is the html/template
iris.PongoEngine is the flosch/pongo2
iris.AmberEngine is the eknkc/amber
iris.JadeEngine is the Joker/jade
iris.MarkdownEngine

// HTML builds up the response from the specified template and bindings.
HTML(status int, name string, binding interface{}, layout ...string) error

// Render same as .HTML but with status to iris.StatusOK (200)
Render(name string, binding interface{}, layout ...string) error 

// RenderString same as Render but instead of client render, returns the result 
RenderString(name string, binding interface{}, layout ...string) (string,error)

A snippet:

iris.Get("/default_standar", func(ctx *iris.Context){
  ctx.Render("index.html", nil) // this will render the file ./templates/index.html
})

Let's read and learn how to set the configuration now.

import (
    "github.com/kataras/iris/config"
    //...
)
// These are the defaults
templateConfig := config.Template {
  		Engine:        DefaultEngine, //or HTMLTemplate
		Gzip:          false,
		IsDevelopment: false,
		Directory:     "templates",
		Extensions:    []string{".html"},
		ContentType:   "text/html",
		Charset:       "UTF-8",
		Layout:        "", // currently this is working only on HTML
		HTMLTemplate:  HTMLTemplate{Left: "{{", Right: "}}", Funcs: template.FuncMap{}},
		Pongo:         Pongo{Filters: make(map[string]pongo2.FilterFunction, 0),
                              Globals: make(map[string]interface{}},
		Markdown:      Markdown{Sanitize: false},
		Amber:         Amber{Funcs: template.FuncMap{}},
        Jade:          Jade{},
}

// Set

// 1. Directly via complete custom configuration field
iris.Config().Render.Template = templateConfig

// 2. Fast way - Pongo snippet
iris.Config().Render.Template.Engine = iris.PongoEngine
iris.Config().Render.Template.Directory = "mytemplates"
iris.Config().Render.Template.Pongo.Filters = ...

// 3. Fast way - HTMLTemplate snippet
iris.Config().Render.Template.Engine = iris.HTMLTemplate // or iris.DefaultEngine
iris.Config().Render.Template.Layout = "layout/layout.html" // = ./templates/layout/layout.html
//...
 
// 4.
theDefaults := config.DefaultTemplate()
theDefaults.Extensions = []string{".myExtension"}
//...

Examples

`HTMLTemplate`

// main.go

package main

import (
	"github.com/kataras/iris"
)

type mypage struct {
  Message string
}

func main() {
	iris.Config().Render.Template.Layout = "layouts/layout.html" // default ""
	iris.Get("/", func(ctx *iris.Context) {
		if err := ctx.Render("page1.html", mypage{"Message from page1!"}); err != nil {
			panic(err)
		}
	})

	println("Server is running at: 8080")
	iris.Listen(":8080")
}

<!-- templates/layouts/layout.html -->

<html>
  <head>
    <title>My Layout</title>

  </head>
  <body>
    <!-- Render the current template here -->
    {{ yield }}
  </body>
</html>

<!-- templates/page1.html -->

<div style="background-color:black;color:blue">

<h1> The message: {{.Message}} </h1>

{{ render "partials/page1_partial1.html"}}

</div>

<!-- templates/partials/page1_partial1.html -->

<div style="background-color:white;color:red"> <h1> Page 1's Partial 1 </h1> </div>