standard

README

模板引擎

特点

1. 支持继承
2. 支持包含子模板
3. 支持golang原生模板语法（详细用法可参阅golang模板语法简明教程）
4. 自动注册模板函数 hasBlock(blocks ...string) bool 和 hasAnyBlock(blocks ...string) bool
   • hasBlock(blocks ...string) bool - 是否在扩展模板中设置了指定名称的Block
   • hasAnyBlock(blocks ...string) bool - 是否在扩展模板中设置了指定名称中的任意一个Block
5. 支持多重继承

模板继承

用于模板继承的标签有：Block、Extend、Super

例如，有以下两个模板：
layout.html：
	
	{{Block "title"}}-- powered by webx{{/Block}}
	{{Block "body"}}内容{{/Block}}
	
index.html：

	{{Extend "layout"}}
	{{Block "title"}}首页 {{Super}}{{/Block}}
	{{Block "body"}}这是一个演示{{/Block}}
	
渲染模板index.html将会输出:

	首页 -- powered by webx
	这是一个演示
	
注意：Super标签只能在扩展模板（含Extend标签的模板）的Block标签内使用。

因为最新增加了对多重继承的支持，所以，现在我们还可以创建一个模板`new.html`用来继承上面的`index.html`，比如`new.html`的内容为：

	{{Extend "index"}}
	{{Block "body"}}这是一个多重继承的演示{{/Block}}

渲染这个新模板将会输出：

	首页 -- powered by webx
	这是一个多重继承的演示

也就是说这个新模板具有这样的继承关系：new.html -> index.html -> layout.html (目前限制为最多不超过10级)

包含子模板

例如，有以下两个模板：
footer.html:
	
	www.webx.top

index.html:

	前面的一些内容
	{{Include "footer"}}
	后面的一些内容
	
渲染模板index.html将会输出:

	前面的一些内容
	www.webx.top
	后面的一些内容
	
也可以在循环中包含子模板，例如：

	{{range .list}}
	{{Include "footer"}}
	{{end}}

因为本模板引擎缓存了模板对象，所以它并不会多次读取模板内容，在循环体内也能高效的工作。

Include标签也能在Block标签内部使用，例如：

	{{Block "body"}}
	这是一个演示
	{{Include "footer"}}
	{{/Block}}

另外，Include标签也支持嵌套。

点此查看完整例子

Documentation

Overview

*

• 模板扩展
• @author swh <swh@admpub.com>

Index

• Variables
• func New(templateDir string, args ...logger.Logger) driver.Driver
• func NewTplInfo(t *htmlTpl.Template) *tplInfo
• type CcRel
• type Standard
  • func (self *Standard) ClearCache()
  • func (self *Standard) Close()
  • func (self *Standard) ContainsSubTpl(content string, subcs *map[string]string) string
  • func (self *Standard) Fetch(tmplName string, data interface{}, funcMap map[string]interface{}) string
  • func (self *Standard) Include(tmplName string, funcMap htmlTpl.FuncMap, values interface{}) interface{}
  • func (self *Standard) Init(cached ...bool)
  • func (self *Standard) InitRegexp()
  • func (self *Standard) Logger() logger.Logger
  • func (self *Standard) MonitorEvent(fn func(string))
  • func (self *Standard) ParseBlock(content string, subcs *map[string]string, extcs *map[string]string)
  • func (self *Standard) ParseExtend(content string, extcs *map[string]string, passObject string, ...) (string, [][]string)
  • func (self *Standard) RawContent(tmpl string) (b []byte, e error)
  • func (self *Standard) Render(w io.Writer, tmplName string, values interface{}, c echo.Context) error
  • func (self *Standard) SetContentProcessor(fn func([]byte) []byte)
  • func (self *Standard) SetFuncMap(fn func() map[string]interface{})
  • func (self *Standard) SetLogger(l logger.Logger)
  • func (self *Standard) SetManager(mgr driver.Manager)
  • func (self *Standard) Tag(content string) string
  • func (self *Standard) TemplatePath(p string) string
  • func (self *Standard) TmplDir() string

Variables

var Debug = false

Functions

func New

func New(templateDir string, args ...logger.Logger) driver.Driver

func NewTplInfo

func NewTplInfo(t *htmlTpl.Template) *tplInfo

Types

type CcRel

type CcRel struct {
	Rel map[string]uint8
	Tpl [2]*tplInfo //0是独立模板；1是子模板
}

type Standard

type Standard struct {
	CachedRelation map[string]*CcRel
	TemplateDir    string
	TemplateMgr    driver.Manager

	DelimLeft  string
	DelimRight string

	IncludeTag         string
	ExtendTag          string
	BlockTag           string
	SuperTag           string
	Ext                string
	TemplatePathParser func(string) string
	Debug              bool
	FuncMapFn          func() map[string]interface{}
	// contains filtered or unexported fields
}

func (*Standard) ClearCache

func (self *Standard) ClearCache()

func (*Standard) Close

func (self *Standard) Close()

func (*Standard) ContainsSubTpl

func (self *Standard) ContainsSubTpl(content string, subcs *map[string]string) string

func (*Standard) Fetch

func (self *Standard) Fetch(tmplName string, data interface{}, funcMap map[string]interface{}) string

func (*Standard) Include

func (self *Standard) Include(tmplName string, funcMap htmlTpl.FuncMap, values interface{}) interface{}

func (*Standard) Init

func (self *Standard) Init(cached ...bool)

func (*Standard) InitRegexp

func (self *Standard) InitRegexp()

func (*Standard) Logger

func (self *Standard) Logger() logger.Logger

func (*Standard) MonitorEvent

func (self *Standard) MonitorEvent(fn func(string))

func (*Standard) ParseBlock

func (self *Standard) ParseBlock(content string, subcs *map[string]string, extcs *map[string]string)

func (*Standard) ParseExtend

func (self *Standard) ParseExtend(content string, extcs *map[string]string, passObject string, subcs *map[string]string) (string, [][]string)

func (*Standard) RawContent

func (self *Standard) RawContent(tmpl string) (b []byte, e error)

func (*Standard) Render

func (self *Standard) Render(w io.Writer, tmplName string, values interface{}, c echo.Context) error

Render HTML

func (*Standard) SetContentProcessor

func (self *Standard) SetContentProcessor(fn func([]byte) []byte)

func (*Standard) SetFuncMap

func (self *Standard) SetFuncMap(fn func() map[string]interface{})

func (*Standard) SetLogger

func (self *Standard) SetLogger(l logger.Logger)

func (*Standard) SetManager

func (self *Standard) SetManager(mgr driver.Manager)

func (*Standard) Tag

func (self *Standard) Tag(content string) string

func (*Standard) TemplatePath

func (self *Standard) TemplatePath(p string) string

func (*Standard) TmplDir

func (self *Standard) TmplDir() string