模板

在寫動(dòng)態(tài)頁(yè)面的網(wǎng)站的時(shí)候，我們常常將不變的部分提出成為模板，可變部分通過(guò)后端程序的渲染來(lái)生成動(dòng)態(tài)網(wǎng)頁(yè)，golang提供了html/template包來(lái)支持模板渲染。

這篇文章不討論golang后端的模板讀取及渲染方法，只討論模板中嵌入變量，渲染變量、循環(huán)等一些基本用法。

變量

在golang渲染template的時(shí)候，可以接受一個(gè)interface{}類型的變量，我們?cè)谀０逦募锌梢宰x取變量?jī)?nèi)的值并渲染到模板里。

有兩個(gè)常用的傳入?yún)?shù)的類型。一個(gè)是struct，在模板內(nèi)可以讀取該struct域的內(nèi)容來(lái)進(jìn)行渲染。還有一個(gè)是map[string]interface{}，在模板內(nèi)可以使用key來(lái)進(jìn)行渲染。

我一般使用第二種，效率可能會(huì)差一點(diǎn)兒，但是用著方便。

模板內(nèi)內(nèi)嵌的語(yǔ)法支持，全部需要加{{}}來(lái)標(biāo)記。

在模板文件內(nèi)， . 代表了當(dāng)前變量，即在非循環(huán)體內(nèi)，.就代表了傳入的那個(gè)變量。假設(shè)我們定義了一個(gè)結(jié)構(gòu)體：

type Article struct {
  ArticleId int
  ArticleContent string
}

那么我們?cè)谀０鍍?nèi)可以通過(guò)

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

來(lái)獲取并把變量的內(nèi)容渲染到模板內(nèi)。假設(shè)上述的結(jié)構(gòu)體的內(nèi)容為ArticleId:1 ArticleContent:”hello”， 則對(duì)應(yīng)渲染后的模板內(nèi)容為：

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

是不是很簡(jiǎn)單呢。

當(dāng)然，我們有時(shí)候需要定義變量，比如我們需要定義一個(gè)article變量，同時(shí)將其初始化為”hello”，那么我們可以這樣寫：

{{$article := "hello"}}

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

{{$article := .ArticleContent}}

這樣我們只要使用{{$article}}則可以獲取到這個(gè)變量的內(nèi)容。

函數(shù)

golang的模板其實(shí)功能很有限，很多復(fù)雜的邏輯無(wú)法直接使用模板語(yǔ)法來(lái)表達(dá)，所以只能使用模板函數(shù)來(lái)繞過(guò)。

首先，template包創(chuàng)建新的模板的時(shí)候，支持.Funcs方法來(lái)將自定義的函數(shù)集合導(dǎo)入到該模板中，后續(xù)通過(guò)該模板渲染的文件均支持直接調(diào)用這些函數(shù)。

該函數(shù)集合的定義為：

type FuncMap map[string]interface{}

key為方法的名字，value則為函數(shù)。這里函數(shù)的參數(shù)個(gè)數(shù)沒(méi)有限制，但是對(duì)于返回值有所限制。有兩種選擇，一種是只有一個(gè)返回值，還有一種是有兩個(gè)返回值，但是第二個(gè)返回值必須是error類型的。這兩種函數(shù)的區(qū)別是第二個(gè)函數(shù)在模板中被調(diào)用的時(shí)候，假設(shè)模板函數(shù)的第二個(gè)參數(shù)的返回不為空，則該渲染步驟將會(huì)被打斷并報(bào)錯(cuò)。

在模板文件內(nèi)，調(diào)用方法也非常的簡(jiǎn)單：

{{funcname .arg1 .arg2}}

假設(shè)我們定義了一個(gè)函數(shù)

func add(left int, right int) int

則在模板文件內(nèi)，通過(guò)調(diào)用

{{add 1 2}}

就可以獲得

3

這個(gè)結(jié)果，golang的預(yù)定義函數(shù)沒(méi)有add，所以有點(diǎn)兒麻煩。

判斷

golang的模板也支持if的條件判斷，當(dāng)前支持最簡(jiǎn)單的bool類型和字符串類型的判斷

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

當(dāng).condition為bool類型的時(shí)候，則為true表示執(zhí)行，當(dāng).condition為string類型的時(shí)候，則非空表示執(zhí)行。

當(dāng)然也支持else ， else if嵌套

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

假設(shè)我們需要邏輯判斷，比如與或、大小不等于等判斷的時(shí)候，我們需要一些內(nèi)置的模板函數(shù)來(lái)做這些工作，目前常用的一些內(nèi)置模板函數(shù)有：

• 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}}

循環(huán)

golang的template支持range循環(huán)來(lái)遍歷map、slice內(nèi)的內(nèi)容，語(yǔ)法為：

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

在這個(gè)range循環(huán)內(nèi)，我們可以通過(guò)iiv來(lái)訪問(wèn)遍歷的值，還有一種遍歷方式為：

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

這種方式無(wú)法訪問(wèn)到index或者key的值，需要通過(guò).來(lái)訪問(wèn)對(duì)應(yīng)的value

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

當(dāng)然這里使用了.來(lái)訪問(wèn)遍歷的值，那么我們想要在其中訪問(wèn)外部的變量怎么辦？(比如渲染模板傳入的變量)，在這里，我們需要使用$.來(lái)訪問(wèn)外部的變量

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

模板的嵌套

在編寫模板的時(shí)候，我們常常將公用的模板進(jìn)行整合，比如每一個(gè)頁(yè)面都有導(dǎo)航欄和頁(yè)腳，我們常常將其編寫為一個(gè)單獨(dú)的模塊，讓所有的頁(yè)面進(jìn)行導(dǎo)入，這樣就不用重復(fù)的編寫了。

任何網(wǎng)頁(yè)都有一個(gè)主模板，然后我們可以在主模板內(nèi)嵌入子模板來(lái)實(shí)現(xiàn)模塊共享。

當(dāng)模板想要引入子模板的時(shí)候，我們使用以下語(yǔ)句：

{{template "navbar"}}

這樣子就會(huì)嘗試載入名稱為navbar的子模板，同時(shí)我們也得定義一個(gè)子模板來(lái)實(shí)現(xiàn)”navbar”這個(gè)子模板。

子模板的定義為：

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

在定義之間的內(nèi)容將會(huì)覆蓋{{template “navbar”}}

當(dāng)然子模板是分離了，那么子模板能否獲得父模板的變量呢？這是當(dāng)然的，我們只需要使用

{{template "navbar" .}}

就可以將當(dāng)前的變量傳給子模板了，這個(gè)也是相當(dāng)方便的。

以上就是本文的全部?jī)?nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評(píng)論