Golang模板引擎管道

问题描述 投票:3回答:1

我有一个像这样定义的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 -}}。它也是一种管道吗?

先感谢您!

templates go go-templates
1个回答
7
投票

有2个template包,text/templatehtml/template

它们具有相同的接口,但html/template包用于生成HTML输出以防止代码注入,并且只要输出为HTML,就应该使用text/template代替html/template

由于它们具有相同的接口,但text/html提供了一些额外的功能(插入数据的上下文转义),基本原理和原则仅记录在html/template,而text/template的文档主要侧重于详细说明额外的。

话虽如此,“管道”属于基础。它记录在PipelinesArgument 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
© www.soinside.com 2019 - 2024. All rights reserved.