Question

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

提前谢谢！

Answer 1

有2个template个软件包，text/template和html/template。

它们具有相同的接口，但html/template包用于生成针对代码注入安全的HTML输出，并且只要输出为HTML，就应该使用text/template而不是html/template。

由于它们具有相同的接口，但text/html提供了一些额外的功能（插入数据的上下文转义），所以基础和原则仅记录在html/template，以及{{1}的文档主要关注详细说明额外的内容。

话虽如此，＆＃34;管道＆＃34;属于基础。它记录在text/template，Pipelines部分：

中

管道

管道是一个可能被链接的＆＃34;命令＆＃34;的序列。命令是一个简单的值（参数）或函数或方法调用，可能带有多个参数：
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.
管道可能被链接＆＃34;通过用管道符号分隔一系列命令＆＃39; |＆＃39;。在链式管道中，每个命令的结果都作为以下命令的最后一个参数传递。管道中最终命令的输出是管道的值。

＆＃34;参数＆＃34;和＆＃34;管道＆＃34;是对数据的评估。

＆＃34; dot＆＃34; .基本上是一个游标，指向您在执行模板时传递的数据结构中的某个位置。点的起始值是您传递的值，但此点由许多操作修改，例如{{range}}或{{with}}。

模板的执行遍历结构并设置光标，由句点＆＃39;表示。并在执行过程中将＆＃34; dot＆＃34;，调用到结构中当前位置的值。

因此，当您编写.Name时，这意味着当前点指向的值，您想要引用其字段或方法或名为Name的键。例如，如果您传递struct，则在模板的开头.Name将表示结构字段Name（如果存在）或其方法名为Name()。

当您调用/包含另一个模板时，您可以告诉您要将哪些值传递给其执行。当您编写{{template "something" .}}时，这意味着您希望将当前由dot指向的值传递给模板执行。如果您只想传递点所指向的结构的Name字段，则可以像{{template "something" .Name}}那样进行。

作为{{template}}中的管道传递的值将成为调用的其他模板中的点。

因此，在处理/渲染模板时，可能会更改点并仅指向＆＃34;＆＃34;到最初传递给模板执行的值的一部分。它通常很方便或要求仍然达到原始值而不仅仅是光标。为此，模板包提供$：

执行开始时，$设置为传递给Execute的数据参数，即dot的起始值。

因此，即使您在{{range}}内（例如，将点设置为阵列/切片/地图的连续元素，您还可以覆盖范围），您仍然可以伸出并引用传递给模板执行的值的任何其他部分。

例如，如果您在{{range .Books}}之类的书籍上进行测量，并且如果您需要最初传递的结构的Name字段，则可以在{{1}内进行像这样：

{{range}}

Golang模板引擎管道

1 个答案:

管道