[TOC]
# beego 模板語法指南
本文講述 beego 中使用的模板語法,與 go 模板語法基本相同。
## 基本語法
go 統一使用了 `{{` 和 `}}` 作為左右標簽,沒有其他的標簽符號。如果您想要修改為其它符號,可以參考 [模板標簽](http://beego.me/docs/mvc/view/view.md#%E6%A8%A1%E6%9D%BF%E6%A0%87%E7%AD%BE)。
使用 `.` 來訪問當前位置的上下文
使用 `$` 來引用當前模板根級的上下文
使用 `$var` 來訪問創建的變量
[more]
**模板中支持的 go 語言符號**
```
{{"string"}} // 一般 string
{{`raw string`}} // 原始 string
{{'c'}} // byte
{{print nil}} // nil 也被支持
```
**模板中的 pipeline**
可以是上下文的變量輸出,也可以是函數通過管道傳遞的返回值
```
{{. | FuncA | FuncB | FuncC}}
```
當 pipeline 的值等于:
* false 或 0
* nil 的指針或 interface
* 長度為 0 的 array, slice, map, string
那么這個 pipeline 被認為是空
#### if ... else ... end
```
{{if pipeline}}{{end}}
```
if 判斷時,pipeline 為空時,相當于判斷為 False
```
this.Data["IsLogin"] = true
this.Data["IsHome"] = true
this.Data["IsAbout"] = true
```
支持嵌套的循環
```
{{if .IsHome}}
{{else}}
{{if .IsAbout}}{{end}}
{{end}}
```
也可以使用 else if 進行
```
{{if .IsHome}}
{{else if .IsAbout}}
{{else}}
{{end}}
```
#### range ... end
```
{{range pipeline}}{{.}}{{end}}
```
pipeline 支持的類型為 array, slice, map, channel
range 循環內部的 `.` 改變為以上類型的子元素
對應的值長度為 0 時,range 不會執行,`.` 不會改變
```
pages := []struct {
Num int
}{{10}, {20}, {30}}
this.Data["Total"] = 100
this.Data["Pages"] = pages
```
使用 `.Num` 輸出子元素的 Num 屬性,使用 `$.` 引用模板中的根級上下文
```
{{range .Pages}}
{{.Num}} of {{$.Total}}
{{end}}
```
使用創建的變量,在這里和 go 中的 range 用法是相同的。
```
{{range $index, $elem := .Pages}}
{{$index}} - {{$elem.Num}} - {{.Num}} of {{$.Total}}
{{end}}
```
range 也支持 else
```
{{range .Pages}}
{{else}}
{{/* 當 .Pages 為空 或者 長度為 0 時會執行這里 */}}
{{end}}
```
#### with ... end
```
{{with pipeline}}{{end}}
```
with 用于重定向 pipeline
```
{{with .Field.NestField.SubField}}
{{.Var}}
{{end}}
```
也可以對變量賦值操作
```
{{with $value := "My name is %s"}}
{{printf . "slene"}}
{{end}}
```
with 也支持 else
```
{{with pipeline}}
{{else}}
{{/* 當 pipeline 為空時會執行這里 */}}
{{end}}
```
#### define
define 可以用來定義自模板,可用于模塊定義和模板嵌套
```
{{define "loop"}}
<li>{{.Name}}</li>
{{end}}
```
使用 template 調用模板
```
<ul>
{{range .Items}}
{{template "loop" .}}
{{end}}
</ul>
```
#### template
```
{{template "模板名" pipeline}}
```
將對應的上下文 pipeline 傳給模板,才可以在模板中調用
**Beego 中支持直接載入文件模板**
```
{{template "path/to/head.html" .}}
```
Beego 會依據你設置的模板路徑讀取 head.html
在模板中可以接著載入其他模板,對于模板的分模塊處理很有用處
#### 注釋
允許多行文本注釋,不允許嵌套
```
{{/* comment content
support new line */}}
```
## 基本函數
變量可以使用符號 `|` 在函數間傳遞
```
{{.Con | markdown | addlinks}}
```
```
{{.Name | printf "%s"}}
```
使用括號
```
{{printf "nums is %s %d" (printf "%d %d" 1 2) 3}}
```
#### and
```
{{and .X .Y .Z}}
```
and 會逐一判斷每個參數,將返回第一個為空的參數,否則就返回最后一個非空參數
#### call
```
{{call .Field.Func .Arg1 .Arg2}}
```
call 可以調用函數,并傳入參數
調用的函數需要返回 1個值 或者 2個值,返回兩個值時,第二個值用于返回 error 類型的錯誤。返回的錯誤不等于 nil 時,執行將終止。
#### index
index 支持 map, slice, array, string,讀取指定類型對應下標的值
```
this.Data["Maps"] = map[string]{"name": "Beego"}
```
```
{{index .Maps "name"}}
```
#### len
```
{{printf "The content length is %d" (.Content|len)}}
```
返回對應類型的長度,支持類型:map, slice, array, string, chan
#### not
not 返回輸入參數的否定值,if true then false else true
#### or
```
{{or .X .Y .Z}}
```
and 會逐一判斷每個參數,將返回第一個非空的參數,否則就返回最后一個參數
#### print
對應 fmt.Sprint
#### printf
對應 fmt.Sprintf
#### println
對應 fmt.Sprintln
#### urlquery
```
{{urlquery "http://beego.me"}}
```
將返回
```
http%3A%2F%2Fbeego.me
```
#### eq / ne / lt / le / gt / ge
這類函數一般配合在 if 中使用
`eq`: arg1 == arg2
`ne`: arg1 != arg2
`lt`: arg1 < arg2
`le`: arg1 <= arg2
`gt`: arg1 > arg2
`ge`: arg1 >= arg2
eq 和其他函數不一樣的地方是,支持多個參數,和下面的邏輯判斷相同
```
arg1==arg2 || arg1==arg3 || arg1==arg4 ...
```
與 if 一起使用
```
{{if eq true .Var1 .Var2 .Var3}}{{end}}
```
```
{{if lt 100 200}}{{end}}
```
> 更多文檔請訪問 [beego 官網](http://beego.me/docs/mvc/view/view.md)。
- 寫在前面的話
- 第0章 beego 簡介
- 0.1 為beego貢獻
- 0.2 發布版本
- 0.3 升級指南
- 第1章 安裝升級
- 1.1 bee工具的使用
- 第2章 快速入門
- 2.1 新建項目
- 2.2 路由設置
- 2.3 Controller運行機制
- 2.4 Model邏輯
- 2.5 View編寫
- 2.6 靜態文件處理
- 第3章 beego的MVC架構
- 3.1 Model設計
- 3.1.1 概述
- 3.1.2 ORM使用
- 3.1.3 CRUD操作
- 3.1.4 高級查詢
- 3.1.5 原生SQL查詢
- 3.1.6 構造查詢
- 3.1.7 事物處理
- 3.1.8 模型定義
- 3.1.9 命令模式
- 3.1.10 測試用例
- 3.1.11 自定義字段
- 3.1.12 FAQ
- 3.2 View設計
- 3.2.1 模板語法指南
- 3.2.2 模板處理
- 3.2.3 模板函數
- 3.2.4 靜態文件處理
- 3.2.5 模板分頁處理
- 3.3 Controller設計
- 3.3.1 參數配置
- 3.3.2 路由設置
- 3.3.3 控制器函數
- 3.3.4 XSRF過濾
- 3.3.5 請求數據處理
- 3.3.6 session 控制
- 3.3.7 過濾器
- 3.3.8 flash 數據
- 3.3.9 URL構建
- 3.3.10 多種格式數據輸出
- 3.3.11 表單數據驗證
- 3.3.12 錯誤處理
- 3.3.13 日志處理
- 第4章 beego的模塊設計
- 4.1 session 模塊
- 4.2 grace 模塊
- 4.3 cache 模塊
- 4.4 logs 模塊
- 4.5 httplib 模塊
- 4.6 context 模塊
- 4.7 toolbox 模塊
- 4.8 config 模塊
- 4.9 i18n 模塊
- 第5章 beego高級編程
- 5.1 進程內監控
- 5.2 API自動化文檔
- 第6章 應用部署
- 6.1 獨立部署
- 6.2 Supervisor部署
- 6.3 Nginx 部署
- 6.4 Apache 部署
- 第7章 第三方庫
- 第8章 應用例子
- 8.1 在線聊天室
- 8.2 短域名服務
- 8.3 Todo列表
- 第9章 FAQ