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 例如，有以下两个模板：

1. layout.html：

{{Block "title"}}-- powered by webx{{/Block}}
{{Block "body"}}内容{{/Block}}

1. index.html：

{{Extend "layout"}}
{{Block "title"}}首页 {{Super}}{{/Block}}
{{Block "body"}}这是一个演示{{/Block}}

渲染模板index.html将会输出:

首页 -- powered by webx
这是一个演示

注意：

1. Super标签只能在扩展模板（含Extend标签的模板）的Block标签内使用。
2. Extend标签 必须放在页面内容的起始位置才有效

因为最新增加了对多重继承的支持，所以，现在我们还可以创建一个模板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 CacheData
  • func NewCache() *CacheData
  • func (c *CacheData) GetOk(cacheKey string) (*CcRel, bool)
  • func (c *CacheData) Remove(cacheKey string)
  • func (c *CacheData) Reset()
  • func (c *CacheData) Set(cacheKey string, r *CcRel)
• type CcRel
  • func NewRel(cachedKey string) *CcRel
  • func (c *CcRel) GetOk(cacheKey string) (uint8, bool)
  • func (c *CcRel) Remove(cacheKey string)
  • func (c *CcRel) Reset()
  • func (c *CcRel) Set(cacheKey string, r uint8)
• type RenderData
• type Standard
  • func (a *Standard) ClearCache()
  • func (a *Standard) Close()
  • func (a *Standard) ContainsFunctionResult(c echo.Context, tmplOriginalName string, content string, ...) string
  • func (a *Standard) ContainsSubTpl(c echo.Context, content string, subcs map[string]string) string
  • func (a *Standard) Debug() bool
  • func (a *Standard) Fetch(tmplName string, data interface{}, c echo.Context) string
  • func (a *Standard) Init()
  • func (a *Standard) InitRegexp()
  • func (a *Standard) Logger() logger.Logger
  • func (a *Standard) Manager() driver.Manager
  • func (a *Standard) MonitorEvent(fn func(string))
  • func (a *Standard) ParseBlock(c echo.Context, content string, subcs map[string]string, ...)
  • func (a *Standard) ParseExtend(c echo.Context, content string, extcs map[string]string, passObject string, ...) (string, [][]string)
  • func (a *Standard) RawContent(tmpl string) (b []byte, e error)
  • func (a *Standard) Render(w io.Writer, tmplName string, values interface{}, c echo.Context) error
  • func (a *Standard) SetContentProcessor(fn func([]byte) []byte)
  • func (a *Standard) SetDebug(on bool)
  • func (a *Standard) SetFuncMap(fn func() map[string]interface{})
  • func (a *Standard) SetLogger(l logger.Logger)
  • func (a *Standard) SetManager(mgr driver.Manager)
  • func (a *Standard) SetTmplPathFixer(fn func(echo.Context, string) string)
  • func (a *Standard) Tag(content string) string
  • func (a *Standard) TmplDir() string
  • func (a *Standard) TmplPath(c echo.Context, p string) 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 CacheData

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

func NewCache

func NewCache() *CacheData

func (*CacheData) GetOk

func (c *CacheData) GetOk(cacheKey string) (*CcRel, bool)

func (*CacheData) Remove

func (c *CacheData) Remove(cacheKey string)

func (*CacheData) Reset

func (c *CacheData) Reset()

func (*CacheData) Set

func (c *CacheData) Set(cacheKey string, r *CcRel)

type CcRel

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

func NewRel

func NewRel(cachedKey string) *CcRel

func (*CcRel) GetOk

func (c *CcRel) GetOk(cacheKey string) (uint8, bool)

func (*CcRel) Remove

func (c *CcRel) Remove(cacheKey string)

func (*CcRel) Reset

func (c *CcRel) Reset()

func (*CcRel) Set

func (c *CcRel) Set(cacheKey string, r uint8)

type RenderData

type RenderData struct {
	Func   template.FuncMap
	Data   interface{}
	Stored param.MapReadonly
}

type Standard

type Standard struct {
	CachedRelation *CacheData
	TemplateDir    string
	TemplateMgr    driver.Manager

	DelimLeft  string
	DelimRight string

	IncludeTag  string
	FunctionTag string
	ExtendTag   string
	BlockTag    string
	SuperTag    string
	StripTag    string
	Ext         string
	// contains filtered or unexported fields
}

func (*Standard) ClearCache

func (a *Standard) ClearCache()

func (*Standard) Close

func (a *Standard) Close()

func (*Standard) ContainsFunctionResult

func (a *Standard) ContainsFunctionResult(c echo.Context, tmplOriginalName string, content string, clips map[string]string) string

func (*Standard) ContainsSubTpl

func (a *Standard) ContainsSubTpl(c echo.Context, content string, subcs map[string]string) string

func (*Standard) Debug

func (a *Standard) Debug() bool

func (*Standard) Fetch

func (a *Standard) Fetch(tmplName string, data interface{}, c echo.Context) string

func (*Standard) Init

func (a *Standard) Init()

func (*Standard) InitRegexp

func (a *Standard) InitRegexp()

func (*Standard) Logger

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

func (*Standard) Manager

func (a *Standard) Manager() driver.Manager

func (*Standard) MonitorEvent

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

func (*Standard) ParseBlock

func (a *Standard) ParseBlock(c echo.Context, content string, subcs map[string]string, extcs map[string]string)

func (*Standard) ParseExtend

func (a *Standard) ParseExtend(c echo.Context, content string, extcs map[string]string, passObject string, subcs map[string]string) (string, [][]string)

func (*Standard) RawContent

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

func (*Standard) Render

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

Render HTML

func (*Standard) SetContentProcessor

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

func (*Standard) SetDebug

func (a *Standard) SetDebug(on bool)

func (*Standard) SetFuncMap

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

func (*Standard) SetLogger

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

func (*Standard) SetManager

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

func (*Standard) SetTmplPathFixer

func (a *Standard) SetTmplPathFixer(fn func(echo.Context, string) string)

func (*Standard) Tag

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

func (*Standard) TmplDir

func (a *Standard) TmplDir() string

func (*Standard) TmplPath

func (a *Standard) TmplPath(c echo.Context, p string) string