amber

README

---

id: amber title: Amber

Amber is a template engine create by eknkc, to see the original syntax documentation please click here

Basic Example

./views/index.amber

import ./views/partials/header

h1 #{Title}

import ./views/partials/footer

./views/partials/header.amber

h1 Header

./views/partials/footer.amber

h1 Footer

./views/layouts/main.amber

doctype html
html
  head
    title Main
  body
    #{embed()}

package main

import (
	"log"
	
	"github.com/gofiber/fiber/v2"
	"github.com/gofiber/template/amber/v2"
)

func main() {
	// Create a new engine
	engine := amber.New("./views", ".amber")

  // Or from an embedded system
  // See github.com/gofiber/embed for examples
  // engine := html.NewFileSystem(http.Dir("./views", ".amber"))

	// Pass the engine to the Views
	app := fiber.New(fiber.Config{
		Views: engine,
	})

	app.Get("/", func(c *fiber.Ctx) error {
		// Render index
		return c.Render("index", fiber.Map{
			"Title": "Hello, World!",
		})
	})

	app.Get("/layout", func(c *fiber.Ctx) error {
		// Render index within layouts/main
		return c.Render("index", fiber.Map{
			"Title": "Hello, World!",
		}, "layouts/main")
	})

	log.Fatal(app.Listen(":3000"))
}

Documentation

Index

• type Engine
  • func New(directory, extension string) *Engine
  • func NewFileSystem(fs http.FileSystem, extension string) *Engine
  • func (e *Engine) Load() error
  • func (e *Engine) Render(out io.Writer, name string, binding interface{}, layout ...string) error

Types

type Engine

type Engine struct {
	core.Engine
	// templates
	Templates map[string]*template.Template
}

Engine struct

func New

func New(directory, extension string) *Engine

New returns an Amber render engine for Fiber

func NewFileSystem

func NewFileSystem(fs http.FileSystem, extension string) *Engine

NewFileSystem returns an Amber render engine for Fiber with file system

func (*Engine) Load

func (e *Engine) Load() error

Load parses the templates to the engine.

func (*Engine) Render

func (e *Engine) Render(out io.Writer, name string, binding interface{}, layout ...string) error

Render will execute the template name along with the given values.