我有一个像这样定义的Golang模板
{{- define "test" -}}
{{- printf "%s" .Name | trunc 24 -}}
{{- end -}}
然后我在我的一个文件中使用它:
{{ template "test" . }}
“测试”后点的含义是什么? Golang模板文档说:
{{template "name" pipeline}}
The template with the specified name is executed with dot set
to the value of the pipeline.
但我不确定管道是什么。阅读文档没有结果,任何人都可以再次解释?
另外,为什么我们必须以dot开头的值?例如。 {{ - printf "%s" .Name | trunc 24 -}}
。它也是一种管道吗?
先感谢您!
有2个template
包,text/template
和html/template
。
它们具有相同的接口,但html/template
包用于生成HTML输出以防止代码注入,并且只要输出为HTML,就应该使用text/template
代替html/template
。
由于它们具有相同的接口,但text/html
提供了一些额外的功能(插入数据的上下文转义),基本原理和原则仅记录在html/template
,而text/template
的文档主要侧重于详细说明额外的。
话虽如此,“管道”属于基础。它记录在Pipelines,Argument
The result is the value of evaluating the argument.
.Method [Argument...]
The method can be alone or the last element of a chain but,
unlike methods in the middle of a chain, it can take arguments.
The result is the value of calling the method with the
arguments:
dot.Method(Argument1, etc.)
functionName [Argument...]
The result is the value of calling the function associated
with the name:
function(Argument1, etc.)
Functions and function names are described below.
部分:
Pipelines
管道是可能链接的“命令”序列。命令是一个简单的值(参数)或函数或方法调用,可能有多个参数:
.
通过用管道字符“|”分隔一系列命令,可以“链接”管道。在链式管道中,每个命令的结果都作为以下命令的最后一个参数传递。管道中最终命令的输出是管道的值。
“参数”和“管道”是对数据的评估。
“dot”{{range}}
基本上是一个光标,指向您在执行模板时传递的数据结构中的某个位置。点的起始值是您传递的值,但此点由许多操作修改,例如{{with}}
或.Name
。
执行模板遍历结构并设置光标,由句点'。'表示。并且在执行过程中将“dot”称为结构中当前位置的值。
因此,当您编写Name
时,这意味着dot当前指向的值,您想要引用其字段或方法或称为struct
的键。例如,如果传递.Name
,则在模板的开头,Name
将表示结构字段Name()
(如果存在)或其方法名为{{template "something" .}}
。
当您调用/包含另一个模板时,您可以告诉您要将哪些值传递给它的执行。当您编写Name
时,这意味着您要将当前由dot指向的值传递给模板执行。如果你只想传递点所指向的结构的{{template "something" .Name}}
字段,你可以像{{template}}
那样做。
您在$
中作为管道传递的值将成为调用的其他模板中的点。
因此,在处理/呈现模板时,可以更改点并将其“仅”指向最初传递给模板执行的值的一部分。通常它很方便或需要仍然达到原始值而不仅仅是光标。为此,模板包提供了{{range}}
:
执行开始时,$设置为传递给Execute的数据参数,即dot的起始值。
因此,即使您在{{range .Books}}
中(例如,将点设置为数组/切片/贴图的连续元素,您还可以覆盖),您仍然可以伸出并引用传递给它的值的任何其他部分模板执行。
因此,例如,如果你在Name
等书籍的范围内,如果你需要最初传递的结构的{{range}}
字段,你可以在{{range .Books}}
Title: {{.Title}}
Original name: {{$.Name}}
{{end}}
中这样做:
qazxswpoi