Go Revel - Templates（模板）

revel使用Go官方的模板库。它会在两个目录查找模板文件:

1、应用的views目录以及它的所有子目录

2、revel库自己的templates目录

revel为错误页面提供了模板（在dev开发模式下，编译错误会更友好的显示），但是，如果用相同的名字创建一个模板，revel则会优先使用自己开发的模板。如 app/views/errors/500.html

渲染内容

revel使用RenderArgs数据map来执行模板。除了从应用提供数据，revel也提供了:

1、“errors”， 从Validation.ErrorMap返回的错误信息

2、“flash”， 上一个请求携带的flash信息

模板函数

Go本身为模板提供了一些函数方便我们使用。revel也添加了一些实用的函数:

eq

类似a == b的条件判断:

<div class="message {{if eq .User " you"}}you{{end}}"="">

set

在当前作用域设置一个变量:

{{set . "title" "Basic Chat room"}}

<h1>{{.title}}</h1>

append

将一个给定的值添加至数组/切片，如果数组/切片不存在，则新建一个。

{{append . "moreScripts" "js/jquery-ui-1.7.2.custom.min.js"}}

{{range .moreStyles}}

{{end}}

field

对Input表单字段进行操作。

给定一个字段名称，它将返回一个包含下列成员的struct：

Id: 字段名，会转换为恰当的HTML id元素

Name: 字段名

Value: RenderArgs中当前字段的值

Flash: 当前字段的flash信息

Error: 任何一个与当前字段有关的错误信息

ErrorClass: hasError的原始信息，如果不存在则为空字符串

{{with $field := field "booking.CheckInDate" .}}
  <p class="{{$field.ErrorClass}}">
    <strong>Check In Date:</strong>
    <input type="text" size="10" name="{{$field.Name}}" class="datepicker" value="{{$field.Flash}}">
    * <span class="error">{{$field.Error}}</span>
  </p>
{{end}}

option

结合field模板函数生成HTML option元素

{{with $field := field "booking.Beds" .}}
<select name="{{$field.Name}}">
  {{option $field "1" "One king-size bed"}}
  {{option $field "2" "Two double beds"}}
  {{option $field "3" "Three beds"}}
</select>
{{end}}

radio

结合field模板函数生成HTML radio元素

{{with $field := field "booking.Smoking" .}}
  {{radio $field "true"}} Smoking
  {{radio $field "false"}} Non smoking
{{end}}

nl2br

生成HTML的换行标签

You said:
<div class="comment">{{nl2br .commentText}}</div>

pluralize

转换单词的复数形式

There are {{.numComments}} comment{{pluralize (len comments) "" "s"}}

Including

Go允许将一个模板嵌入至另一个模板

{{template "header.html" .}}

有两点需要注意:

1、路径必须是app/views的相对路径

2、任何被嵌入的模板必须位于app/views目录的根位置（这个限制希望是暂时的）

Tips

revel的示例程序说明了如何有效的使用模板，请特别留意这两个示例：

revel/samples/booking/app/views/header.html

revel/samples/booking/app/views/header.html

它利用模板函数设置模板自己的html header和样式：

        <title>{{.title}}</title>



        {{range .moreStyles}}

        {{end}}


        {{range .moreScripts}}

        {{end}}

引用html header模板:

{{set . title "Hotels"}}
{{append . "moreStyles" "ui-lightness/jquery-ui-1.7.2.custom.css"}}
{{append . "moreScripts" "js/jquery-ui-1.7.2.custom.min.js"}}
{{template "header.html" .}}

自定义模板函数

revel应用可以注册自定义模板函数:

func init() {
    revel.TemplateFuncs["eq"] = func(a, b interface{}) bool { return a == b }
}</div>