临时存储区
Syntax
PAGE.Scratch
Returns
maps.Scratch
Page 对象上的 Scratch 方法创建一个 临时存储区 来存储和操作数据。要创建在服务器重建时不会重置的临时存储区，请改用 Store 方法。
要创建不附加到 Page 对象的局部作用域临时存储区，请使用 newScratch 函数。
方法
设置
设置给定键的值。
{{ .Scratch.Set "greeting" "Hello" }}
获取
获取给定键的值。
{{ .Scratch.Set "greeting" "Hello" }}
{{ .Scratch.Get "greeting" }} → Hello
添加
将给定值添加到给定键的现有值。
对于单个值， Add 接受支持 Go 的 + 运算符的值。如果某个键的第一次 Add 是数组或切片，则后续添加将附加到该列表中。
{{ .Scratch.Set "greeting" "Hello" }}
{{ .Scratch.Add "greeting" "Welcome" }}
{{ .Scratch.Get "greeting" }} → HelloWelcome
{{ .Scratch.Set "total" 3 }}
{{ .Scratch.Add "total" 7 }}
{{ .Scratch.Get "total" }} → 10
{{ .Scratch.Set "greetings" (slice "Hello") }}
{{ .Scratch.Add "greetings" (slice "Welcome" "Cheers") }}
{{ .Scratch.Get "greetings" }} → [Hello Welcome Cheers]
设置映射值
接受一个 key 、 mapKey 和 value ，并将 mapKey 和 value 的映射添加到给定的 key 。
{{ .Scratch.SetInMap "greetings" "english" "Hello" }}
{{ .Scratch.SetInMap "greetings" "french" "Bonjour" }}
{{ .Scratch.Get "greetings" }} → map[english:Hello french:Bonjour]
删除映射值
接受一个 key 和 mapKey ，并从给定的 key 中删除 mapKey 的映射。
{{ .Scratch.SetInMap "greetings" "english" "Hello" }}
{{ .Scratch.SetInMap "greetings" "french" "Bonjour" }}
{{ .Scratch.DeleteInMap "greetings" "english" }}
{{ .Scratch.Get "greetings" }} → map[french:Bonjour]
获取排序的映射值
返回按 mapKey 排序的 key 中的值数组。
{{ .Scratch.SetInMap "greetings" "english" "Hello" }}
{{ .Scratch.SetInMap "greetings" "french" "Bonjour" }}
{{ .Scratch.GetSortedMapValues "greetings" }} → [Hello Bonjour]
删除
删除给定的键。
{{ .Scratch.Set "greeting" "Hello" }}
{{ .Scratch.Delete "greeting" }}
确定性值
Scratch 方法通常用于在短代码、由短代码调用的局部模板或 Markdown 渲染钩子中设置临时存储区的值。在这三种情况下，直到 Hugo 渲染页面内容后，临时存储区的值才确定。
如果您需要从父模板访问临时存储区的值，而父模板尚未渲染页面内容，则可以通过将返回值赋值给 空操作 变量来触发内容渲染：
{{ $noop := .Content }}
{{ .Store.Get "mykey" }}
您还可以使用 ContentWithoutSummary 、 FuzzyWordCount 、 Len 、 Plain 、 PlainWords 、 ReadingTime 、 Summary 、 Truncated 和 WordCount 方法触发内容渲染。例如：
{{ $noop := .WordCount }}
{{ .Store.Get "mykey" }}