hugo/docs/content/en/functions/dict.md

2.1 KiB

title description godocref date publishdate lastmod categories menu keywords signature workson hugoversion relatedfuncs deprecated aliases
dict Creates a dictionary from a list of key and value pairs. 2017-02-01 2017-02-01 2017-02-26
functions
docs
parent
functions
dictionary
dict KEY VALUE [KEY VALUE]...
false

dict is especially useful for passing more than one value to a partial template.

Note that the key can be either a string or a string slice. The latter is useful to create a deply nested structure, e.g.:

{{ $m := dict (slice "a" "b" "c") "value" }}

Example: Using dict to pass multiple values to a partial

The partial below creates a SVG and expects fill, height and width from the caller:

Partial definition

{{< code file="layouts/partials/svgs/external-links.svg" download="external-links.svg" >}} {{< /code >}}

Partial call

The fill, height and width values can be stored in one object with dict and passed to the partial:

{{< code file="layouts/_default/list.html" >}} {{ partial "svgs/external-links.svg" (dict "fill" "#01589B" "width" 10 "height" 20 ) }} {{< /code >}}