社区微信群开通啦,扫一扫抢先加入社区官方微信群
社区微信群
{{ }}
是默认的模板界定符。用于在 HTML 模板文件中界定模板语法。例如:
Hello, {{ .User }}
<br>
你熟悉的技术:
<ul>
{{ range .List }}
<li>{{.}}</li>
{{end}}
</ul>
若需要使用自定义的界定符,使用 func (t *Template) Delims(left, right string) *Template
方法进行定义。后续的解析会识别新定义的界定符。
分配到模板中的数据使用 .
点可以访问。点会随着所处的上下文变化而变化,例如上面的例子,在 range
内就表示所遍历的每个数据,而在 range
外,就表示分配到模板中的数据整体。
解析数据时,默认会被 HTML 实体编码,防止 XSS 攻击。若需要原样输出,需要将数据转换为 template.HTML
类型,例如:
t.Execute(w, `<script>alert("Hack")</script>`)
// 解析结果: <script>alert("Hack")</script>
t.Execute(w, template.HTML(`<script>alert("Hack")</script>`))
// 解析结果: <script>alert("Hack")</script>
甚至在不同的 HTML 语法上下文中,会有不同的编码方式,例如:
假设 .
的值为 Hank's 博客
:
a href="{{.}}" 中,会进行 URL 编码,结果为:Hank%27s%20%e5%8d%9a%e5%ae%a2
a title="{{.}}" 中,会进行 ASCII 实体编码,结果为:Hank's 博客
{{FuncName1 "参数值1" "参数值2"}}
函数支持模板函数,和全局函数。预定义的全局函数为:
and x y
等价于 if x then y else x
,所有参数都会执行or x y
等价于 if x then x else y
,所有参数都会执行index x 1 2 3
返回 x[1][2][3]
的值;每个被索引的主体必须是数组、切片或者字典。可以在变量后使用 | (管道符),将其值作为参数传递给函数,并得到函数的返回值。管道可以连续使用,演示为:
// . 为 `Hank's 博客`
{{.|urlquery}}
// Hank%27s+%E5%8D%9A%E5%AE%A2
{{if pipeline}} T1 {{ else if pipeline}} T2 {{else}} T3 {{end}}
若 pipeline 的值不为 empty,条件匹配,执行相应分支。
empty 空值为:false、0、任意nil指针或者nil接口,任意长度为0的数组、切片、字典。
{{range pipeline}} T1 {{else}} T0 {{end}}
或
{{range $index, $element := pipeline}} T1 {{end}}
遍历数组、切片、字典或者通道的每一个成员元素并执行 T1。
若 pipeline 为空,执行 T0。else 分支可以省略。
empty 空值为:false、0、任意nil指针或者nil接口,任意长度为0的数组、切片、字典。
若需要同时获取下标和值,需要使用变量赋值语法。
{{template "name" pipeline}}
解析名为 name 的模板,提供给模板的参数为 pipeline。
{{$variable := pipeline}}
{{/* a comment */}}
完!
原文出自:小韩说课
微信关注:小韩说课
如果觉得我的文章对您有用,请随意打赏。你的支持将鼓励我继续创作!