1. 程式人生 > >Beego脫坑(十五)——View設計

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 。這樣就做到了資料的輸出。

  • 基本語法

  1. go 統一使用了 {{ 和 }} 作為左右標籤。
  2. 使用 . 來訪問當前位置的上下文
  3. 使用 $ 來引用當前模板根級的上下文
  4. 使用 $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}}