golang 模板(template)的常用基本語法
模板
在寫動態頁面的網站的時候,我們常常將不變的部分提出成為模板,可變部分通過后端程序的渲染來生成動態網頁,golang提供了html/template包來支持模板渲染。
這篇文章不討論golang后端的模板讀取及渲染方法,只討論模板中嵌入變量,渲染變量、循環等一些基本用法。
變量
在golang渲染template的時候,可以接受一個interface{}類型的變量,我們在模板文件中可以讀取變量內的值并渲染到模板里。
有兩個常用的傳入參數的類型。一個是struct,在模板內可以讀取該struct域的內容來進行渲染。還有一個是map[string]interface{},在模板內可以使用key來進行渲染。
我一般使用第二種,效率可能會差一點兒,但是用著方便。
模板內內嵌的語法支持,全部需要加{{}}來標記。
在模板文件內, . 代表了當前變量,即在非循環體內,.就代表了傳入的那個變量。假設我們定義了一個結構體:
~~~
type Article struct {
ArticleId int
ArticleContent string
}
~~~
那么我們在模板內可以通過
~~~
<p>{{.ArticleContent}}<span>{{.ArticleId}}</span></p>
~~~
來獲取并把變量的內容渲染到模板內。假設上述的結構體的內容為ArticleId:1 ArticleContent:”hello”, 則對應渲染后的模板內容為
~~~
<p>hello<span>1</span></p>
~~~
是不是很簡單呢。
當然,我們有時候需要定義變量,比如我們需要定義一個article變量,同時將其初始化為”hello”,那么我們可以這樣寫:
~~~
{{$article := "hello"}}
~~~
假設我們想要把傳入值的內容賦值給article,則可以這樣寫:
~~~
{{$article := .ArticleContent}}
~~~
這樣我們只要使用{{$article}}則可以獲取到這個變量的內容。
函數
golang的模板其實功能很有限,很多復雜的邏輯無法直接使用模板語法來表達,所以只能使用模板函數來繞過。
首先,template包創建新的模板的時候,支持.Funcs方法來將自定義的函數集合導入到該模板中,后續通過該模板渲染的文件均支持直接調用這些函數。
該函數集合的定義為:
~~~
type FuncMap map[string]interface{}
~~~
key為方法的名字,value則為函數。這里函數的參數個數沒有限制,但是對于返回值有所限制。有兩種選擇,一種是只有一個返回值,還有一種是有兩個返回值,但是第二個返回值必須是error類型的。這兩種函數的區別是第二個函數在模板中被調用的時候,假設模板函數的第二個參數的返回不為空,則該渲染步驟將會被打斷并報錯。
在模板文件內,調用方法也非常的簡單:
~~~
{{funcname .arg1 .arg2}}
~~~
假設我們定義了一個函數
~~~
func add(left int, right int) int
~~~
則在模板文件內,通過調用
~~~
{{add 1 2}}
~~~
就可以獲得
~~~
3
~~~
這個結果,golang的預定義函數沒有add,所以有點兒麻煩。
判斷
golang的模板也支持if的條件判斷,當前支持最簡單的bool類型和字符串類型的判斷
~~~
{{if .condition}}
{{end}}
~~~
當.condition為bool類型的時候,則為true表示執行,當.condition為string類型的時候,則非空表示執行。
當然也支持else , else if嵌套
~~~
{{if .condition1}}
{{else if .contition2}}
{{end}}
~~~
假設我們需要邏輯判斷,比如與或、大小不等于等判斷的時候,我們需要一些內置的模板函數來做這些工作,目前常用的一些內置模板函數有:
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}}
~~~
在這個range循環內,我們可以通過iv來訪問遍歷的值,還有一種遍歷方式為:
~~~
{{range .slice}}
{{end}}
~~~
這種方式無法訪問到index或者key的值,需要通過.來訪問對應的value
~~~
{{range .slice}}
{{.field}}
{{end}}
~~~
當然這里使用了.來訪問遍歷的值,那么我們想要在其中訪問外部的變量怎么辦?(比如渲染模板傳入的變量),在這里,我們需要使用$.來訪問外部的變量
~~~
{{range .slice}}
{{$.ArticleContent}}
{{end}}
~~~
模板的嵌套
在編寫模板的時候,我們常常將公用的模板進行整合,比如每一個頁面都有導航欄和頁腳,我們常常將其編寫為一個單獨的模塊,讓所有的頁面進行導入,這樣就不用重復的編寫了。
任何網頁都有一個主模板,然后我們可以在主模板內嵌入子模板來實現模塊共享。
當模板想要引入子模板的時候,我們使用以下語句:
~~~
{{template "navbar"}}
~~~
這樣子就會嘗試載入名稱為navbar的子模板,同時我們也得定義一個子模板來實現”navbar”這個子模板。
子模板的定義為:
~~~
{{define "navbar"}}
{{end}}
~~~
在定義之間的內容將會覆蓋{{template “navbar”}}
當然子模板是分離了,那么子模板能否獲得父模板的變量呢?這是當然的,我們只需要使用
~~~
{{template "navbar" .}}
~~~
就可以將當前的變量傳給子模板了,這個也是相當方便的。

- Go語言基礎篇
- Go語言簡介
- Go語言教程
- Go語言環境安裝
- Go語言結構
- Go語言基礎語法
- Go語言數據類型
- Go語言變量
- Go語言提高篇
- Go語言實現貪吃蛇
- Go 諺語
- 解決連通性問題的四種算法
- golang 幾種字符串的連接方式
- Go JSON 技巧
- Go += 包版本
- Golang 編譯成 DLL 文件
- Go指南:牛頓法開方
- Go語言異步服務器框架原理和實現
- Golang適合高并發場景的原因分析
- 如何設計并實現一個線程安全的 Map ?(上篇)
- go語言執行cmd命令關機、重啟等
- IT雜項
- IT 工程師的自我管理
- IT界不為人知的14個狗血故事
- Go語言版本說明
- Go 1.10中值得關注的幾個變化
- Golang面試題解析
- Golang面試題
- Golang語言web開發
- golang 模板(template)的常用基本語法
- go語言快速入門:template模板
- Go Template學習筆記
- LollipopGo框架
- 框架簡介
- Golang語言版本設計模式
- 設計模式-單例模式
- Golang語言資源下載
- 公眾賬號
- leaf
- 合作講師
- 公開課目錄