template

Documentation

Index

• Variables
• func AddFuncMap(name string, f interface{}) error
• func Compare(a, b interface{}) (equal bool)
• func CompareNot(a, b interface{}) (equal bool)
• func Date(t time.Time, format string) string
• func DateFormat(t time.Time, layout string) (datestring string)
• func DateParse(dateString, format string) (time.Time, error)
• func Empty(a interface{}) bool
• func HTML2str(html string) string
• func Htmlquote(text string) string
• func Htmlunquote(text string) string
• func Init(_viewPath, _templateExt, _langRoot, _langExt string, _debug bool)
• func UnHTML(x string) interface{}
• type Template
  • func New(path string) (t *Template, err error)
  • func (t *Template) AssociatesTemplate(paths ...string) (r []*template.Template, errPath string, err error)
  • func (t *Template) AssociatesTemplateAuto()
  • func (t *Template) Execute(wr io.Writer, data interface{}, cacheTime int64) (err error)
  • func (t *Template) GetLang(langName string, extra ...string) (langData map[string]string)
  • func (t *Template) UseCache(wr io.Writer) (successful bool)
  • func (t *Template) UseCacheAlways(wr io.Writer) (successful bool)

Variables

var Errs = struct {
	ErrNotFound error // 未找到错误
}{
	errors.New("file not found"),
}

Errs 预定义错误

Functions

func AddFuncMap

func AddFuncMap(name string, f interface{}) error

AddFuncMap 添加模板函数，需要在Init模板初始化之前添加才能生效

func Compare

func Compare(a, b interface{}) (equal bool)

Compare 比较两个对象，如果相同返回 true，否者 false，使用方法 {{compare .A .B}}

func CompareNot

func CompareNot(a, b interface{}) (equal bool)

CompareNot !Compare

func Date

func Date(t time.Time, format string) string

Date 兼容php语言风格的时间的格式化

func DateFormat

func DateFormat(t time.Time, layout string) (datestring string)

DateFormat 时间的格式化，返回字符串，使用方法 {{dateformat .Time “2006-01-02T15:04:05Z07:00”}}

func DateParse

func DateParse(dateString, format string) (time.Time, error)

DateParse 兼容php语言风格的时间字符串解析

func Empty

func Empty(a interface{}) bool

Empty 对象为空时返回true

func HTML2str

func HTML2str(html string) string

HTML2str html转化为字符串，剔除一些 script、css 之类的元素，返回纯文本信息，使用方法 {{html2str .Htmlinfo}}

func Htmlquote

func Htmlquote(text string) string

Htmlquote html字符转义，使用方法 {{htmlquote .quote}}

func Htmlunquote

func Htmlunquote(text string) string

Htmlunquote html字符反转义，使用方法 {{htmlunquote .unquote}}

func Init

func Init(_viewPath, _templateExt, _langRoot, _langExt string, _debug bool)

Init 初始化 _langRoot, _langExt 是多语言功能相关参数，为空表示不使用该功能

func UnHTML

func UnHTML(x string) interface{}

UnHTML template.HTML

Types

type Template

type Template struct {
	T *template.Template

	M *sync.RWMutex
	// contains filtered or unexported fields
}

Template Template

func New

func New(path string) (t *Template, err error)

New 返回一个*Template

func (*Template) AssociatesTemplate

func (t *Template) AssociatesTemplate(paths ...string) (r []*template.Template, errPath string, err error)

AssociatesTemplate 关联模板

func (*Template) AssociatesTemplateAuto

func (t *Template) AssociatesTemplateAuto()

AssociatesTemplateAuto 在相同目录下自动寻找并关联模板

func (*Template) Execute

func (t *Template) Execute(wr io.Writer, data interface{}, cacheTime int64) (err error)

Execute Execute cacheTime: 缓存时间(单位秒)，<=0 不缓存;>0 使用缓存，需要和UseCache配合使用

func (*Template) GetLang

func (t *Template) GetLang(langName string, extra ...string) (langData map[string]string)

GetLang 获取语言数据 langName: 语言名,实际上就是语言包根目录下的文件夹名 extra: 额外的语言文件路径，可选参数

func (*Template) UseCache

func (t *Template) UseCache(wr io.Writer) (successful bool)

UseCache 使用缓存，前提是Execute时使用了缓存

func (*Template) UseCacheAlways

func (t *Template) UseCacheAlways(wr io.Writer) (successful bool)

UseCacheAlways 当缓存数据存在时，不管是否过期都使用缓存