hugo/docs/content/en/functions/collections/Dictionary.md
2023-10-20 09:43:56 +02:00

2.2 KiB

title linkTitle description categories keywords menu function relatedFunctions aliases
collections.Dictionary dict Creates a map from a list of key and value pairs.
functions
docs
parent
functions
aliases returnType signatures
dict
mapany
collections.Dictionary KEY VALUE [KEY VALUE]...
collections.Dictionary
collections.Group
collections.Index
collections.IsSet
collections.Where
/functions/dict

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 deeply 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 an SVG and expects fill, height and width from the caller:

Partial definition

{{< code file="layouts/partials/svgs/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 >}}