hugo/docs/content/en/methods/pages/GroupBy.md
2023-12-04 15:24:01 +01:00

36 lines
771 B
Markdown

---
title: GroupBy
description: Returns the given page collection grouped by the given field in ascending order.
categories: []
keywords: []
action:
related: []
returnType: page.PagesGroup
signatures: ['PAGES.GroupBy FIELD [SORT]']
---
{{% include "methods/pages/_common/group-sort-order.md" %}}
```go-html-template
{{ range .Pages.GroupBy "Section" }}
<p>{{ .Key }}</p>
<ul>
{{ range .Pages }}
<li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
{{ end }}
</ul>
{{ end }}
```
To sort the groups in descending order:
```go-html-template
{{ range .Pages.GroupBy "Section" "desc" }}
<p>{{ .Key }}</p>
<ul>
{{ range .Pages }}
<li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
{{ end }}
</ul>
{{ end }}
```