Store

Store 方法可創建一個持久的 塗鴉板，用於存儲和操作數據。要創建一個本地範圍的塗鴉板（未附加到 Page 對象），請使用 newScratch 函數。

方法

Set

設置給定鍵的值。

{{ .Store.Set "greeting" "Hello" }}
Get

獲取給定鍵的值。

{{ .Store.Set "greeting" "Hello" }}
{{ .Store.Get "greeting" }} → Hello
Add

將給定值添加到給定鍵的現有值中。

對於單個值，Add 接受支持 Go 的 + 運算符的值。如果 Add 對於某個鍵是首次操作為陣列或切片，後續的添加將會被追加到該列表。

{{ .Store.Set "greeting" "Hello" }}
{{ .Store.Add "greeting" "Welcome" }}
{{ .Store.Get "greeting" }} → HelloWelcome

{{ .Store.Set "total" 3 }}
{{ .Store.Add "total" 7 }}
{{ .Store.Get "total" }} → 10

{{ .Store.Set "greetings" (slice "Hello") }}
{{ .Store.Add "greetings" (slice "Welcome" "Cheers") }}
{{ .Store.Get "greetings" }} → [Hello Welcome Cheers]
SetInMap

接受 key、mapKey 和 value，將 mapKey 和 value 作為鍵值對加入到給定的 key 中。

{{ .Store.SetInMap "greetings" "english" "Hello" }}
{{ .Store.SetInMap "greetings" "french" "Bonjour" }}
{{ .Store.Get "greetings" }} → map[english:Hello french:Bonjour]
DeleteInMap

接受 key 和 mapKey，並從給定的 key 中刪除 mapKey 及其對應的值。

{{ .Store.SetInMap "greetings" "english" "Hello" }}
{{ .Store.SetInMap "greetings" "french" "Bonjour" }}
{{ .Store.DeleteInMap "greetings" "english" }}
{{ .Store.Get "greetings" }} → map[french:Bonjour]
GetSortedMapValues

返回排序後的 key 中的 mapKey 對應的所有值。

{{ .Store.SetInMap "greetings" "english" "Hello" }}
{{ .Store.SetInMap "greetings" "french" "Bonjour" }}
{{ .Store.GetSortedMapValues "greetings" }} → [Hello Bonjour]
Delete

刪除指定的鍵。

{{ .Store.Set "greeting" "Hello" }}
{{ .Store.Delete "greeting" }}

可決定的值

Store 方法常常用來設置在短代碼（shortcode）、由短代碼調用的部分模板（partial template）或 Markdown 渲染鉤子中設置的塗鴉板值。在這三種情況中，塗鴉板值在 Hugo 渲染頁面內容之前是不可確定的。

如果你需要從父模板中訪問塗鴉板值，並且父模板尚未渲染頁面內容，則可以透過將返回值分配給 noop 變量來觸發內容渲染：

{{ $noop := .Content }}
{{ .Store.Get "mykey" }}

你還可以使用 ContentWithoutSummary、FuzzyWordCount、Len、Plain、PlainWords、ReadingTime、Summary、Truncated 和 WordCount 方法來觸發內容渲染。例如：

{{ $noop := .WordCount }}
{{ .Store.Get "mykey" }}
PageGroups Page