hugo/docs/content/en/methods/page/Next.md
Bjørn Erik Pedersen 5fd1e74903
Merge commit '9b0050e9aabe4be65c78ccf292a348f309d50ccd' as 'docs'
```
git subtree add --prefix=docs/ https://github.com/gohugoio/hugoDocs.git master --squash
```

Closes #11925
2024-01-27 10:48:57 +01:00

1.2 KiB

title description categories keywords action toc
Next Returns the next page in a global page collection, relative to the given page.
related returnType signatures
methods/page/Prev
methods/page/NextInSection
methods/page/PrevInSection
methods/pages/Next
methods/pages/Prev
page.Page
PAGE.Next
true

The behavior of the Prev and Next methods on a Page object is probably the reverse of what you expect.

With this content structure:

content/
├── pages/
│   ├── _index.md
│   ├── page-1.md   <-- front matter: weight = 10
│   ├── page-2.md   <-- front matter: weight = 20
│   └── page-3.md   <-- front matter: weight = 30
└── _index.md

When you visit page-2:

  • The Prev method points to page-3
  • The Next method points to page-1

{{% note %}} Use the opposite label in your navigation links as shown in the example below. {{% /note %}}

{{ with .Next }}
  <a href="{{ .RelPermalink }}">Prev</a>
{{ end }}

{{ with .Prev }}
  <a href="{{ .RelPermalink }}">Next</a>
{{ end }}

Compare to Pages methods

{{% include "methods/_common/next-prev-on-page-vs-next-prev-on-pages.md" %}}