Golang 模板
最近又尝试了一下 Golang 的 Template,发现一般功能都满足了,而且语法也相对比较简单,所以稍作总结。在 Go语言中,模板有 text/template 和 html/template 两个,但是接口都是一致的,区别在于 html/template 用于生成 HTML 输出,会自动得转移 HTML 标签用于防范攻击。
模板规则
Go 语言中,模板的特殊表达式都是通过 {{ 和 }} 引起来的,没有引起来的一般都是直接翻译出来就好了,所以也没啥特别说的。在 Go 语言的模板里面,掌握几个概念基本上就可以使用了,分别是:
- pipeline
- 变量
- 函数
这基本上就是 Go 里面模板的主要功能了,后面就对这几个组件进行详述,看看分别是什么东西。
pipeline
pipeline 我觉得是 Go 语言的模板中差不多最复杂的一个东西了,其实 pipeline 可以理解成管道(如果你玩 Linux 的话),前面条命令的输出就是后面条命令的输入,而且 Go 语言的 pipeline 也支持变量取值,而且变量取值的本身就是 pipeline 中的一个环节。
除此之外,pipeline 中的函数还支持多个参数,2 个 3 个甚至多个参数都是支持的,除了管道前面的输出作为第一个参数之外,在函数后面接着的所有变量都是参数,依次排序。下面就是一个管道的示例:
.Name | toUpper | toEnglish
这里包含了 .Name 是一个变量,用于取值,然后 toUpper 和 toEnglish 都是函数,除了使用 .Name 用于取值之外,还支持 .Method 用于调用函数,那么这里的取值和调用方法的对象主体是谁?这就是在渲染这个模板的时候传进来的对象,所有关于 . 的操作都以这个传递的对象为基准进行操作。
可使用表达式
{{pipeline}}: pipeline 结果的值会被直接输出{{if pipeline}} T1 {{end}}: 如果 pipe 不 empty,那么 T1 就会被执行- The empty values are false, 0, any nil pointer or interface value, and any array, slice, map, or string of length zero.
{{if pipeline}} T1 {{else}} T0 {{end}}:如果 pipeline 不 empty,T0 会被执行,否则 T1 会被执行{{if pipeline}} T1 {{else if pipeline}} T0 {{end}}:含义同上{{range pipeline}} T1 {{end}}:- pipeline 的结果必须是 array, slice, map 或者 channel
- If the value is a map and the keys are of basic type with a defined order ("comparable"), the elements will be visited in sorted key order.
{{range pipeline}} T1 {{else}} T0 {{end}}: 如果 pipeline 是空的,那么 T1 不会被执行,T0 会被执行{{with pipeline}} T1 {{end}}:如果 pipeline 不空,则 T1 会被执行{{with pipeline}} T1 {{else}} T0 {{end}}:如果 pipeline 空,T0 会执行,否则,T1 会被执行{{block "name" pipeline}} T1 {{end}}:{{define "name"}} T1 {{end}}再加上{{template "name" .}}
定义模板
- 定义模板以
{{define "name"}}开头,以{{end}}结尾 {{template "name"}}: 指定名字为 name 的模板并以 nil 的数据渲染{{template "name" pipeline}}:执行名字为 name 的模板,并以 pipeline 的值渲染示例:
// home.tmpl
{{define "title"}}Home{{end}}
{{define "content"}}This is the Home page.{{end}} // base.tmpl, template 里面没有默认内容
<title>{{template "title" .}}</title>
<body>{{template "content" .}}</body> // base.tmpl 和 home.tmpl 顺序很重要,错误了将得不到输出
t, err := template.ParseFiles("base.tmpl", "home.tmpl")
if err != nil {
Block
- 和 template 差不多,但是 block 有默认值,可以通过
define覆盖 - template 没有默认值,只能通过
define来定义 示例:
// home.tmpl
{{define "title"}}Home{{end}}
{{define "content"}}This is the Home page.{{end}} // base.tmpl, block 里面有默认内容,如果上面没有定义,依旧会输出内容
<title>{{block "title" .}}Default Title{{end}}</title>
<body>{{block "content" .}}This is the default body.{{end}}</body> // base.tmpl 和 home.tmpl 顺序很重要,错误了将得不到输出
t, err := template.ParseFiles("base.tmpl", "home.tmpl")
if err != nil {
渲染模板
- 直接渲染默认的模板:
tmpl.Execute(os.Stdout, "no data needed") - 根据名字渲染模板:
tmpl.ExecuteTemplate(os.Stdout, "name", "no data needed")
常用变量
- boolean,string,character,interget,float,复杂常量等常用数据类型
- nil 表示 Go 中的无类型 nil
- '.' 表示 dot 的值
- $ 符号加变量名表示变量的值,例如:
$username - struc 的 field 值:
.Filed或者.File1.File2或者$arg.Field1.Field2 - map 的值,
.Key或者$map.Key - 调用方法:
.Method - 调用函数:
.Fun
变量赋值
在模板中也可以对 pipeline 的值进行赋值,赋值的方式如下:
$variable := pipeline
range $index, $element := pipeline
模板函数
During execution functions are found in two function maps:
- first in the template
- then in the global function map.
预定义的全局函数
- and:返回第一个空的参数或者最后一个元素(所有都不为空?)!注意,所有的参数都会被计算
- call:调用第一个参数,使用后面的参数作为调用的参数
- html:返回 HTML 转义的值
- index:返回第一个参数的索引位置的值
- js:返回转义过的 JS 代码
- len:返回参数的长度
- not:返回唯一一个参数的反值
- or:返回所有参数中第一个不为空的,或者最后一个元素(所有都为空?)!无论如何,所有的值都会被计算
- print:alias for
fmt.Sprint - printf:alias for
fmt.Sprintf - println:alias for
fmt.Sprintln - urlquery:将值转义成可嵌入 URL Query 语句的值
预定义的布尔函数
- eq:返回 arg1 == arg2
- ne:arg1 != arg2
- le:arg1 < arg2
- le:arg1 <= arg2
- gt:arg1 > arg2
- ge:arg1 >= arg2
注释
{{/* a comment */}}
特殊字符
- {{ }}: 用于输出变量的值
- {{- 或 -}}:用于删除后面或前面的空格(注意,不是变量的空格)

Glob
从一个目录中加载一系列的模板
函数的使用
func New(name string) *Template:等价于{{define "name"}} {{end}}func Must(t *Template, err error) *Template:helper 函数,如果 err 为 False 则 panic,否则返回 Templatefunc ParseFiles(filenames ...string) (*Template, error):如果 filenames 有不同目录相同的名字,那么,后面的将会覆盖前面的- 所以 filenames 的顺序很重要,弄错了将会导致无法正确渲染
- 但是所有定义在这些文件中的 template 和 block 都会被保存在返回的 Template 中
Reference
Golang 模板的更多相关文章
- golang模板语法简明教程
[模板标签] 模板标签用"{{"和"}}"括起来 [注释] {{/* a comment */}} 使用“{{/*”和“*/}}”来包含注释内容 [变量 ...
- golang 模板(template)的常用基本语法
1. 模板 在写动态页面的网站的时候,我们常常将不变的部分提出成为模板,可变部分通过后端程序的渲染来生成动态网页,golang提供了html/template包来支持模板渲染. 这篇文章不讨论gola ...
- golang模板语法简明教程(后面有福利哦)
template是go 语言web开发中必不可少的,特此记录下来: [模板标签] 模板标签用"{{"和"}}"括起来 [注释] {{/* a comment ...
- golang 模板语法使不解析html标签及特殊字符
场景 有时候需要使用go的模板语法,比如说用go 去渲染html页面的时候,再比如说用go的模板搞代码生成的时候.这时候可能会遇到一个麻烦,不想转译的特殊字符被转译了. 我遇到的情况是写代码生成器的时 ...
- golang 模板 html/template与text/template
html模板生成: html/template包实现了数据驱动的模板,用于生成可对抗代码注入的安全HTML输出.它提供了和text/template包相同的接口,Go语言中输出HTML的场景都应使用t ...
- golang模板语法
https://www.cnblogs.com/Pynix/p/4154630.html https://blog.csdn.net/huwh_/article/details/77140664 ht ...
- golang深坑记录
go深坑:1.gin.context.JSON,如果没有make数组时,数组返回为null,make后,数组为[]2.json.Number转int64类型 datatemp.(json.Number ...
- istio1.0.2配置
项目的组件相对比较复杂,原有的一些选项是靠 ConfigMap 以及 istioctl 分别调整的,现在通过重新设计的Helm Chart,安装选项用values.yml或者 helm 命令行的方式来 ...
- libnetwork插件化网络功能
Docker把网络跟存储这两部分的功能实现都以插件化形式剥离出来,允许用户通过指令来选择不同的后端实现.这也是Docker希望构建围绕着容器的强大生态系统的一些积极的尝试.剥离出来的独立容器网络项目叫 ...
随机推荐
- Flask 实现 WebSocket 通讯---群聊和私聊
一.WebSocket介绍 WebSocket是一种在单个TCP连接实现了服务端和客户端进行双向文本或二进制数据通信的一种通信的协议. WebSocket使得客户端和服务器之间的数据交换变得更加简单, ...
- 实现一个算法,寻找字符串中出现次数最少的、并且首次出现位置最前的字符 如"cbaacfdeaebb",符合要求的是"f",因为他只出现了一次(次数最少)。并且比其他只出现一次的字符(如"d")首次出现的位置最靠前。
实现一个算法,寻找字符串中出现次数最少的.并且首次出现位置最前的字符如"cbaacfdeaebb",符合要求的是"f",因为他只出现了一次(次数最少).并且比其 ...
- mybatis单表操作实现完全java代码封装
之前在项目中用到mybtis操作数据库时都是手动写sql,对于我这种sql水平不是很好地人来说痛苦死了:动态查询的sql我表示到现在还不会写呀! 还好,利用数据库表反向生成的工具可以帮我解决大部分的s ...
- Windows下安装MySQL详细教程
Windows下安装MySQL详细教程 1.安装包下载 2.安装教程 (1)配置环境变量 (2)生成data文件 (3)安装MySQL (4)启动服务 (5)登录MySQL (6)查询用户密码 (7 ...
- js之global 对象 方法
global 作为js的全局对象,但其是无法直接访问的,但是在浏览器中浏览器是将这个对象当做是window对象的一部分,即Date 等Global的属性使用window.Date 可访问到 1.url ...
- 【xsy1120】 支援(assist) dp+卡常
妙啊算错时间复杂度了 题目大意:给你一棵$n$个节点的二叉树,每个节点要么是叶子节点,要么拥有恰好两个儿子. 令$m$为叶子节点个数,你需要在这棵二叉树中选择$i$个叶子节点染色,叶节点染色需要一定的 ...
- (转)用Python写堡垒机项目
原文:https://blog.csdn.net/ywq935/article/details/78816860 前言 堡垒机是一种运维安全审计系统.主要的功能是对运维人员的运维操作进行审计和权限控制 ...
- 编译Qt-mingw使用的opencv
set path=D:\dev\IDE\Qt5.7.0\Tools\mingw530_32\bin;%path% cd build_mingw530_32 cmake -G "MinGW M ...
- Python -- Gui编程 -- Win32API的使用
消息框 messageBox.py import win32api, win32con win32api.MessageBox(0, 'Hello World!', 'Come Here', win3 ...
- Chapter 3 Phenomenon——14
They wheeled me away then, to X-ray my head. 他们把我移到了一边用X光照射我的头. 他们把我放到轮椅上,推着我去做头部X光检查. I told them t ...