详解详解golang 模板模板(template)的常用基本语法的常用基本语法
主要介绍了详解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}}
假设我们定义了一个函数