beego模板语法循环html块,在Beego中使用Jade模板

Jade是一个高性能的HTML模板引擎，它受到Haml的影响,是使用JavaScript实现的。Jade在客户端也有支持，它的代码比html可读性要高很多，Jade是一个比较常用的HTML模板。

Beego是一个go语言的web应用程序开源web框架，而Beego从1.7.0开始支持更加复杂的模板引擎，当然也包括了对于jade的支持，支持更复杂模板引擎的PR地址https://github.com/astaxie/beego/pull/1940。

在介绍Jade的使用之前先来看下Go下面的html/template包。

html/template

在Go语言中，html/template包是一个很强大的html模板包，结合text/template的模板语法，基本上可以满足大部分的HTML模板需求，无论是Beego中是默认支持的两种模板格式.tpl和.html,以及jade和ace都是可以解析为html/template中的Template对象使用，就是说我们所使用的html模板最终都是基于html/template包实现的。

html/template使用实例:

package main

import (

"html/template"

)

type User struct {

Name string

}

func main() {

t := template.New("template example")

t, _ = t.Parse("hello {{.Name}}!")

p := User{Name: "jjz"}

t.Execute(os.Stdout, p)

}

上面的例子会输出字符串：hello jjz。

通过上面的例子我们可以看到，如何新建一个模板，再使用模板函数Parse()从字符串中加载模板内容，使用模板函数Execute()可以给模板替换字段。替换模板字段的语法,{{}}中的字段就是要替换字段,{{. Name}}表示需要替换的字段名称。

Beego使用复杂模板的方式很简单，增加一个模板引擎函数，在项目运行的时候遍历views中的文件，把指定的文件解析为template.Template对象，返回该对象提供使用，这个模板引擎函数就是：`beego.AddTemplateEngine

`。

AddTemplateEngine

beego.AddTemplateEngine是一个用来把指定的文件，转换为template.Template的对象的函数。它的第一个参数是文件的后缀名，在views中的含有此后缀名的文件都会进入该方法进行处理。他的第二个参数是一个函数，用来处理文件的转换，最后会返回一个template.Template的对象。有了这个函数，我们还少一个把jade文件解析为template.Template的方法，还好有人已经做了jade的Go语言实现。

jade.go

jade.go是Jade的Go语言实现。

jade.go的使用，首先安装jade.go：

go get github.com/Joker/jade

jade.go使用示例:

func main() {

tpl, err := jade.Parse("name_of_tpl", "doctype 5: html: body: p Hello world!")

if err != nil {

return

}

fmt.Printf( "%s", tpl )

}

输出字符串:

Hello world!

有了jade.go就可以在Beego中使用，把jade文件转换为Template对象，在beego中添加jade.go解析jade模板的方法：

func addJadeTemplate() {

beego.AddTemplateEngine("jade", func(root, path string, funcs template.FuncMap) (*template.Template, error) {

jadePath := filepath.Join(root, path)

content, err := utils.ReadFile(jadePath)

fmt.Println(content)

if err != nil {

return nil, fmt.Errorf("error loading jade template: %v", err)

}

tpl, err := jade.Parse("name_of_tpl", content)

if err != nil {

return nil, fmt.Errorf("error loading jade template: %v", err)

}

fmt.Println("html:\n%s",tpl)

tmp := template.New("Person template")

tmp, err = tmp.Parse(tpl)

if err != nil {

return nil, fmt.Errorf("error loading jade template: %v", err)

}

fmt.Println(tmp)

return tmp, err

})

}

jade.go目前只支持使用字符串的方式接卸jade模板，因此需要先把.jade文件的内容以字符串的方式读取出来。读取文件的方法:

func ReadFile(path string) (str string, err error) {

fi, err := os.Open(path)

defer fi.Close()

fd, err := ioutil.ReadAll(fi)

str = string(fd)

return

}

jade.go解析出的结果也是一个字符串，因此在代码中需要把字符串转换为template.Template对象，使用了Template.Parse()方法。

解析jade模板的引擎方法需要在main()中调用，添加完jade的模板转换引擎之后，就可以在Beego中使用jade模板了。

jade模板的使用

首先定义一个页面home.jade:

doctype html

html

head

title pageTitle

body

h1 jade

.content {{.content}}

其中{{.content}}是需要替换的字段，Controller层代码：

func (c *MainController) Jade() {

c.Data["content"] = "this is jade template"

c.TplName = "home.jade"

}

运行之后生成的页面代码：

pageTitle

jade

this is jade template

通过添加一个解析模板的引擎就可以在beego中使用jade的模板，beego从1.7.0之后开始支持复杂的模板引擎，不仅仅是对于jade的支持，也包括对于其他模板引擎的支持。

除了jade之外，在这个PR中推荐使用的是aceHTML模板引擎。

ace

ace是一个Go语言的HTML模板引擎，它借鉴了Slim和Jade,在Go语言里有超高的人气。

ace模板在beego中的使用与使用Jade类似，首先安装ace的依赖包:

go get github.com/yosssi/ace

在main函数中添加ace模板解析引擎:

func addAceTemplate() {

beego.AddTemplateEngine("ace", func(root, path string, funcs template.FuncMap) (*template.Template, error) {

aceOptions := &ace.Options{DynamicReload: true, FuncMap: funcs}

aceBasePath := filepath.Join(root, "base")

aceInnerPath := filepath.Join(root, strings.TrimSuffix(path, ".ace"))

tpl, err := ace.Load(aceBasePath, aceInnerPath, aceOptions)

if err != nil {

return nil, fmt.Errorf("error loading ace template: %v", err)

}

return tpl, nil

})

}

注意使用ace模板需要指定一个base.ace，另外使用ace.Load()函数可以直接返回一个template.Template对象，不需要再做其他转换的工作。

添加完模板引擎之后就可以直接在views中添加.ace文件使用，新建一个home.ace文件:

= doctype html

html lang=en

head

meta charset=utf-8

title Base and Inner Template

body

h1 ace

.content {{.content}}

同样的{{.content}}是也需要在controller层本替换成需要的内容,controller层代码:

func (c *MainController)Ace() {

c.Data["content"] = "this is ace template"

c.TplName = "home.ace"

}