extemplate: github.com/dannyvankooten/extemplate Index | Examples | Files

package extemplate

import "github.com/dannyvankooten/extemplate"

Index

Examples

Package Files

template.go

type Extemplate Uses

type Extemplate struct {
    // contains filtered or unexported fields
}

Extemplate holds a reference to all templates and shared configuration like Delims or FuncMap

func New Uses

func New() *Extemplate

New allocates a new, empty, template map

func (*Extemplate) Delims Uses

func (x *Extemplate) Delims(left, right string) *Extemplate

Delims sets the action delimiters to the specified strings, to be used in subsequent calls to ParseDir. Nested template definitions will inherit the settings. An empty delimiter stands for the corresponding default: {{ or }}. The return value is the template, so calls can be chained.

func (*Extemplate) ExecuteTemplate Uses

func (x *Extemplate) ExecuteTemplate(wr io.Writer, name string, data interface{}) error

ExecuteTemplate applies the template named name to the specified data object and writes the output to wr.

func (*Extemplate) Funcs Uses

func (x *Extemplate) Funcs(funcMap template.FuncMap) *Extemplate

Funcs adds the elements of the argument map to the template's function map. It must be called before templates are parsed It panics if a value in the map is not a function with appropriate return type or if the name cannot be used syntactically as a function in a template. It is legal to overwrite elements of the map. The return value is the Extemplate instance, so calls can be chained.

func (*Extemplate) Lookup Uses

func (x *Extemplate) Lookup(name string) *template.Template

Lookup returns the template with the given name It returns nil if there is no such template or the template has no definition.

func (*Extemplate) ParseDir Uses

func (x *Extemplate) ParseDir(root string, extensions []string) error

ParseDir walks the given directory root and parses all files with any of the registered extensions. Default extensions are .html and .tmpl If a template file has {{/* extends "other-file.tmpl" */}} as its first line it will parse that file for base templates. Parsed templates are named relative to the given root directory

Code:

xt := extemplate.New().Funcs(template.FuncMap{
    "tolower": strings.ToLower,
})
_ = xt.ParseDir("examples/", []string{".tmpl"})
_ = xt.ExecuteTemplate(os.Stdout, "child.tmpl", nil)

Output:

Hello from child.tmpl
	Hello from partials/question.tmpl

Package extemplate imports 9 packages (graph). Updated 2018-08-19. Refresh now. Tools for package owners.