详解golang模板(模板)的常用基本语法

  


  

  

在写动态页面的网站的时候,我们常常将不变的部分提出成为模板,可变部分通过后端程序的渲染来生成动态网页,golang提供了html/模板包来支持模板渲染。

  

这篇文章不讨论golang后端的模板读取及渲染方法,只讨论模板中嵌入变量,渲染变量,循环等一些基本用法。

  


  

  

在golang渲染模板的时候,可以接受一个接口{}类型的变量,我们在模板文件中可以读取变量内的值并渲染到模板里。

  

有两个常用的传入参数的类型。一个是结构体,在模板内可以读取该结构域的内容来进行渲染。还有一个是map [string]接口{},在模板内可以使用键来进行渲染。

  

我一般使用第二种,效率可能会差一点儿,但是用着方便。

  

模板内内嵌的语法支持,全部需要加{{}}来标记。

  

在模板文件内,。代表了当前变量,即在非循环体内,,就代表了传入的那个变量。假设我们定义了一个结构体:

        类型的文章结构{   正如int   ArticleContent字符串   }   之前      

那么我们在模板内可以通过

        & lt; p> {{.ArticleContent}} & lt; span> {{.ArticleId}} & lt;/span> & lt;/p>      

来获取并把变量的内容渲染到模板内。假设上述的结构体的内容为正如:1 ArticleContent:“你好”,则对应渲染后的模板内容为:

        & lt; p> hello 1 & lt;/span> & lt;/p>      

是不是很简单呢。

  

当然,我们有时候需要定义变量,比如我们需要定义一个文章变量,同时将其初始化为“你好”,那么我们可以这样写:

        {{$文章:="你好"}}      

假设我们想要把传入值的内容赋值给文章,则可以这样写:

        {{$文章:=.ArticleContent}}      

这样我们只要使用{{$条}}则可以获取到这个变量的内容。

  


  

  

golang的模板其实功能很有限,很多复杂的逻辑无法直接使用模板语法来表达,所以只能使用模板函数来绕过。

  

首先,模板包创建新的模板的时候,支持.Funcs方法来将自定义的函数集合导入到该模板中,后续通过该模板渲染的文件均支持直接调用这些函数。

  

该函数集合的定义为:

        接口类型FuncMap map [string] {}   之前      

键为方法的名字,价值则为函数。这里函数的参数个数没有限制,但是对于返回值有所限制。有两种选择,一种是只有一个返回值,还有一种是有两个返回值,但是第二个返回值必须是错误类型的。这两种函数的区别是第二个函数在模板中被调用的时候,假设模板函数的第二个参数的返回不为空,则该渲染步骤将会被打断并报错。

  

在模板文件内,调用方法也非常的简单:

        {{funcname .arg1 .arg2}}      

假设我们定义了一个函数

        函数添加(int, int) int      

则在模板文件内,通过调用

        {{2加1}}      

就可以获得

  
  

3
  

     

这个结果,golang的预定义函数没有添加,所以有点儿麻烦。

  


  

  

golang的模板也支持如果的条件判断,当前支持最简单的bool类型和字符串类型的判断

        {{如果.condition}}   {{结束}}      

当.condition为bool类型的时候,则为真表示执行,当.condition为字符串类型的时候,则非空表示执行。

  

当然也支持,其他如果嵌套

        {{如果.condition1}}   {{else if .contition2}}   {{结束}}      

假设我们需要逻辑判断,比如与或,大小不等于等判断的时候,我们需要一些内置的模板函数来做这些工作,目前常用的一些内置模板函数有:

  
      <李>不非李   
  

{{如果不是.condition}}
  {{结束}}

  
      <李>,与李   
  

{{如果.condition1 .condition2}}
  {{结束}}

  
      <李>或或李   
  

{{如果或.condition1 .condition2}}
  {{结束}}

详解golang模板(模板)的常用基本语法