[Go] template 常用方法详解 及 注意事项

Go template包下面有两个函数可以创建模板实例

func New(name string) *Template  
func ParseFiles(filenames ...string) (*Template, error)   

首先要说的是每一个template内部可以存储多个模板，而且每个模板必须对应一个独立的名字。

两个的不同点在于：

1、使用 New() 在创建时就为其添加一个模板名称，并且执行 t.Execute() 会默认去寻找该名称进行数据融合；

2、使用 ParseFiles() 创建模板可以一次指定多个文件加载多个模板进来，但是就不可以使用 t.Execute() 来执行数据融合；

因为使用 t.Execute() 无法找到要使用哪个加载过的模板进行数据融合，而只有New()创建时才会指定一个 t.Execute() 执行时默认加载的模板。

但是 ParseFiles() 可以通过

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

来进行数据融合，因为该函数可以指定模板名，因此，实例模板就可以知道要去加载自己内部的哪一个模板进行数据融合。

当然无论使用 New() 还是 ParseFiles() 创建模板，都是可以使用 ExecuteTemplate() 来进行数据融合，

但是对于 Execute() 一般与 New() 创建的模板进行配合使用。

html/template 和 text/template

html下的template结构体 实际上是继承了 text 下面的 template结构体

template包下面还有一个 ParseGlob() 方法用于批量解析文件比如在当前目录下有以h开头的模板10个，

使用 template.ParseGlob("h*") 即可页将10个模板文件一起解析出来。

注意事项

下面这段代码的输出一定为空

t := template.New("haha")
t, err := t.ParseFiles("header.tmpl")
fmt.Println(err)
t.Execute(os.Stdout, nil)

原因是为什么呢.....  

首先先记住一个原则 template.New() 和 ParseFiles() 最好不要一起使用，

如果非要一起使用，那么要记住，

New("TName") 中的 TName 必须要和 header.tmpl 中定义的{{define name}}中的 name 同名。

但是正常的做法应该是这样的，同样的 ExecuteTemplate() 中输入的 name 也必须和模板中 {{define name}} 相同。

t, _ := template.ParseFiles("header.tmpl")
t.ExecuteTemplate(os.Stdout, "header", nil)

这里要注意下，在这种情况下如果使用 t.Execute() 也是不会输出任何结果的，因为他并不知道你要使用哪个模板。

另外一点要注意的就是

如果模板中没有与填充数据对应的模板语言，那么很有可能panic。

模板中 {{}} 花括号表达式，自动实现了对js代码的过滤，如何不过滤js代码呢，只需要使用 text/template 包下的template，因为html/template包下的模板实现一些针对html的安全操作包括过滤js代码。

Golang 当中支持 Pipeline，一样是使用 |，

Go允许在模板中自定义变量，自定义模板函数。

函数定义必须遵循如下格式：

func FuncName(args ...interface{}) string

通过 template.FuncMap() 强制类型转换为 FuncMap 类型，然后再通过 template实例的 Func(FuncMap) 添加在模板实例中，这样该模板内部在解析时就可以使用该函数。

Go模板包中自定义了一系列内置函数：

var builtins = FuncMap{
	"and":      and,
	"call":     call,
	"html":     HTMLEscaper,
	"index":    index,
	"js":       JSEscaper,
	"len":      length,
	"not":      not,
	"or":       or,
	"print":    fmt.Sprint,
	"printf":   fmt.Sprintf,
	"println":  fmt.Sprintln,
	"urlquery": URLQueryEscaper,
	
	
	// Comparisons
	"eq": eq, // ==
	"ge": ge, // >=
	"gt": gt, // >
	"le": le, // <=
	"lt": lt, // <
	"ne": ne, // !=
}

摘自：

http://blog.csdn.net/u012807459/article/details/31531367