1
0
Fork 0
hugo/docs/content/en/functions/collections/Querify.md

1.2 KiB

title description categories keywords action aliases
collections.Querify Returns a URL query string composed of the given key-value pairs, encoded and sorted by key.
aliases related returnType signatures
querify
functions/go-template/urlquery.md
string
collections.Querify [VALUE...]
/functions/querify

Specify the key-value pairs as a map, a slice, or a sequence of scalar values. For example, the following are equivalent:

{{ collections.Querify (dict "a" 1 "b" 2) }}
{{ collections.Querify (slice "a" 1 "b" 2) }}
{{ collections.Querify "a" 1 "b" 2 }}

To append a query string to a URL:

{{ $qs := collections.Querify (dict "a" 1 "b" 2) }}
{{ $href := printf "https://example.org?%s" $qs }}

<a href="{{ $href }}">Link</a>

Hugo renders this to:

<a href="https://example.org?a=1&amp;b=2">Link</a>

You can also pass in a map from your site configuration or front matter. For example:

{{< code-toggle file=content/example.md fm=true >}} title = 'Example' [params.query] a = 1 b = 2 {{< /code-toggle >}}

{{ collections.Querify .Params.query }}