Beego脫坑(十五)——View設計
在我們在前面介紹多種格式資料輸出的時候 ,簡單的介紹了下動態模板輸出,我們再來回顧一下。
-
簡單演示
<!-- hello.html --> <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <h1>你猜我會輸出什麼:{{.HW}}</h1> </body> </html>
我們在 Get 裡面寫過這樣的語句 this.TplName ="hello.html"
,設定顯示的模板檔案,預設支援 tpl
和 html
的字尾名,如果想設定其他字尾你可以呼叫 beego.AddTemplateExt
介面設定,那麼模板如何來顯示相應的資料呢?beego 採用了 Go 語言預設的模板引擎,所以和 Go 的模板語法一樣。
下面我們來進階一下
<!DOCTYPE html> <html> <head> <title>Beego</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> </head> <body> <h1>Welcome to Beego!</h1> <p class="description"> Beego is a simple & powerful Go web framework which is inspired by tornado and sinatra. <br /> Official website: <a href="http://{{.Website}}">{{.Website}}</a> <br /> Contact me: {{.Email}} </p> </body> </html>
我們在 Controller 裡面把資料賦值給了 data(map 型別),然後我們在模板中就直接通過 key 訪問 .Website
和 .Email
。這樣就做到了資料的輸出。
-
基本語法
- go 統一使用了
{{
和}}
作為左右標籤。 - 使用
.
來訪問當前位置的上下文 - 使用
$
來引用當前模板根級的上下文 - 使用
$var
來訪問建立的變數
模板中支援的 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}}
call 可以呼叫函式,並傳入引數。呼叫的函式需要返回 1 個值 或者 2 個值,返回兩個值時,第二個值用於返回 error 型別的錯誤。返回的錯誤不等於 nil 時,執行將終止。
{{call .Field.Func .Arg1 .Arg2}}
index 支援 map, slice, array, string,讀取指定型別對應下標的值
this.Data["Maps"] = map[string]string{"name": "Beego"}
{{index .Maps "name"}}
len 返回對應型別的長度,支援型別:map, slice, array, string, chan
{{printf "The content length is %d" (.Content|len)}}
not 返回輸入引數的否定值,if true then false else true
or 會逐一判斷每個引數,將返回第一個非空的引數,否則就返回最後一個引數
{{or .X .Y .Z}}
print 對應 fmt.Sprint
printf 對應 fmt.Sprintf
println 對應 fmt.Sprintln
urlquery 返回ulr
{{urlquery "http://beego.me"}}
eq / ne / lt / le / gt / ge (這裡的用法可以參考orm的操作符)
這類函式一般配合在 if 中使用
eq
: arg1 == arg2ne
: arg1 != arg2lt
: arg1 < arg2le
: arg1 <= arg2gt
: arg1 > arg2ge
: arg1 >= arg2
與 if 一起使用
{{if eq true .Var1 .Var2 .Var3}}{{end}}
{{if lt 100 200}}{{end}}