HUGO
Menu
GitHub 87548 stars Mastodon

Store

返回一個"暫存板"來存儲和操作數據,作用域為當前 shortcode。

Syntax

SHORTCODE.Store

Returns

maps.Scratch
New in v0.139.0

使用 Store 方法創建一個 暫存板 來存儲和操作數據,作用域為當前 shortcode。要創建一個具有不同 作用域 的暫存板,請參閱下面的 作用域 部分。

隨著 [newScratch] 函數的引入,以及能夠在初始化後 [給模板變量賦值],shortcode 內的 Store 方法大部分已過時。

方法

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

接受 keymapKeyvalue,並將 mapKeyvalue 的映射添加到給定 key

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

DeleteInMap

接受 keymapKey,並從給定 key 中移除 mapKey 的映射。

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

GetSortedMapValues

返回按 mapKey 排序的 key 值數組。

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

Delete

移除給定鍵。

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



{{__hugo_ctx pid=1467}}

## 作用域

用於創建暫存板的方法或函數決定了其作用域。例如,在 `Page` 對象上使用 `Store` 方法創建作用於頁面的暫存板。

作用域 | 方法或函數
:--|:--
page|[`PAGE.Store`]
site|[`SITE.Store`]
global|[`hugo.Store`]
local|[`collections.NewScratch`]
shortcode|[`SHORTCODE.Store`]

[`page.store`]: /zh/methods/page/store
[`site.store`]: /zh/methods/site/store
[`hugo.store`]: /zh/functions/hugo/store
[`collections.newscratch`]: /zh/functions/collections/newscratch
[`shortcode.store`]: /zh/methods/shortcode/store
{{__hugo_ctx/}}



[`newScratch`]: /zh/functions/collections/newscratch/
[給模板變量賦值]: https://go.dev/doc/go1.11#texttemplatepkgtexttemplate

Last updated: January 1, 0001
Improve this page