go 模板(template)的常用基本語法

模板

在寫動態頁面的網站的時候，我們常常將不變的部分提出成為模板，可變部分通過後端程式的渲染來生成動態網頁，golang提供了html/template包來支援模板渲染。

這篇文章不討論golang後端的模板讀取及渲染方法，只討論模板中嵌入變數，渲染變數、迴圈等一些基本用法。

變數

在golang渲染template的時候，可以接受一個interface{}型別的變數，我們在模板檔案中可以讀取變數內的值並渲染到模板裡。

有兩個常用的傳入引數的型別。一個是struct，在模板內可以讀取該struct域的內容來進行渲染。還有一個是map[string]interface{}，在模板內可以使用key來進行渲染。

我一般使用第二種，效率可能會差一點兒，但是用著方便。

模板內內嵌的語法支援，全部需要加{{}}來標記。

在模板檔案內， . 代表了當前變數，即在非迴圈體內，.就代表了傳入的那個變數。假設我們定義了一個結構體：

type Article struct {
    ArticleId int
    ArticleContent string
}

• 1
• 2
• 3
• 4
• 5

那麼我們在模板內可以通過

<p>{{.ArticleContent}}<span>{{.ArticleId}}</span></p>

• 1
• 2

來獲取並把變數的內容渲染到模板內。假設上述的結構體的內容為ArticleId:1 ArticleContent:”hello”， 則對應渲染後的模板內容為：

<p>hello<span>1</span></p>

• 1
• 2

是不是很簡單呢。

當然，我們有時候需要定義變數，比如我們需要定義一個article變數，同時將其初始化為”hello”，那麼我們可以這樣寫：

{{$article := "hello"}}

• 1
• 2

假設我們想要把傳入值的內容賦值給article，則可以這樣寫：

{{$article := .ArticleContent}}

• 1
• 2

這樣我們只要使用{{$article}}則可以獲取到這個變數的內容。

函式

golang的模板其實功能很有限，很多複雜的邏輯無法直接使用模板語法來表達，所以只能使用模板函式來繞過。

首先，template包建立新的模板的時候，支援.Funcs方法來將自定義的函式集合匯入到該模板中，後續通過該模板渲染的檔案均支援直接呼叫這些函式。

該函式集合的定義為：

type FuncMap map[string]interface{}

• 1
• 2

key為方法的名字，value則為函式。這裡函式的引數個數沒有限制，但是對於返回值有所限制。有兩種選擇，一種是隻有一個返回值，還有一種是有兩個返回值，但是第二個返回值必須是error型別的。這兩種函式的區別是第二個函式在模板中被呼叫的時候，假設模板函式的第二個引數的返回不為空，則該渲染步驟將會被打斷並報錯。

在模板檔案內，呼叫方法也非常的簡單：

{{funcname .arg1 .arg2}}

• 1
• 2

假設我們定義了一個函式

func add(left int, right int) int

• 1
• 2

則在模板檔案內，通過呼叫

{{add 1 2}}

• 1
• 2

就可以獲得

3

• 1
• 2

這個結果，golang的預定義函式沒有add，所以有點兒麻煩。

判斷

golang的模板也支援if的條件判斷，當前支援最簡單的bool型別和字串型別的判斷

{{if .condition}}
{{end}}

• 1
• 2
• 3

當.condition為bool型別的時候，則為true表示執行，當.condition為string型別的時候，則非空表示執行。

當然也支援else ， else if巢狀

{{if .condition1}}
{{else if .contition2}}
{{end}}

• 1
• 2
• 3
• 4

假設我們需要邏輯判斷，比如與或、大小不等於等判斷的時候，我們需要一些內建的模板函式來做這些工作，目前常用的一些內建模板函式有：

• not 非

  {{if not .condition}}
  {{end}}

• and 與

  {{if and .condition1 .condition2}}
  {{end}}

• or 或

  {{if or .condition1 .condition2}}
  {{end}}

• eq 等於

  {{if eq .var1 .var2}}
  {{end}}

• ne 不等於

  {{if ne .var1 .var2}}
  {{end}}

• lt 小於 (less than)

  {{if lt .var1 .var2}}
  {{end}}

• le 小於等於

  {{if le .var1 .var2}}
  {{end}}

• gt 大於

  {{if gt .var1 .var2}}
  {{end}}

• ge 大於等於

  {{if ge .var1 .var2}}
  {{end}}

迴圈

golang的template支援range迴圈來遍歷map、slice內的內容，語法為：

{{range $i, $v := .slice}}
{{end}}

• 1
• 2
• 3

在這個range迴圈內，我們可以通過i

v來訪問遍歷的值，還有一種遍歷方式為：

{{range .slice}}
{{end}}

• 1
• 2
• 3

這種方式無法訪問到index或者key的值，需要通過.來訪問對應的value

{{range .slice}}
{{.field}}
{{end}}

• 1
• 2
• 3
• 4

當然這裡使用了.來訪問遍歷的值，那麼我們想要在其中訪問外部的變數怎麼辦？(比如渲染模板傳入的變數)，在這裡，我們需要使用$.來訪問外部的變數

{{range .slice}}
{{$.ArticleContent}}
{{end}}

• 1
• 2
• 3
• 4

模板的巢狀

在編寫模板的時候，我們常常將公用的模板進行整合，比如每一個頁面都有導航欄和頁尾，我們常常將其編寫為一個單獨的模組，讓所有的頁面進行匯入，這樣就不用重複的編寫了。

任何網頁都有一個主模板，然後我們可以在主模板內嵌入子模板來實現模組共享。

當模板想要引入子模板的時候，我們使用以下語句：

{{template "navbar"}}

• 1
• 2

這樣子就會嘗試載入名稱為navbar的子模板，同時我們也得定義一個子模板來實現”navbar”這個子模板。

子模板的定義為：

{{define "navbar"}}
{{end}}

• 1
• 23

在定義之間的內容將會覆蓋{{template “navbar”}}

當然子模板是分離了，那麼子模板能否獲得父模板的變數呢？這是當然的，我們只需要使用

{{template "navbar" .}}

• 1
• 2

就可以將當前的變數傳給子模板了，這個也是相當方便的。