hugo/docs/content/en/functions/collections/Group.md
2023-12-04 15:24:01 +01:00

1.1 KiB

title description categories keywords action aliases
collections.Group Groups the given page collection by the given key.
aliases related returnType signatures
group
functions/collections/Dictionary
functions/collections/IndexFunction
functions/collections/IsSet
functions/collections/Where
any
collections.Group KEY PAGES
/functions/group
{{ $new := .Site.RegularPages | first 10 | group "New" }}
{{ $old := .Site.RegularPages | last 10 | group "Old" }}
{{ $groups := slice $new $old }}
{{ range $groups }}
  <h3>{{ .Key }}{{/* Prints "New", "Old" */}}</h3>
  <ul>
    {{ range .Pages }}
      <li>
        <a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a>
        <div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
      </li>
    {{ end }}
  </ul>
{{ end }}

The page group you get from group is of the same type you get from the built-in group methods in Hugo. The above example can be paginated.