pagination-hero
image
Pagination Block

Long lists, one page at a time.

Splits the children of any component into pages, with numbered navigation and an optional results summary.
inline-text-overlay
16.0
10.0
9.0
16.0

When to use

  • Long card lists — articles, resources or results that would otherwise push everything below them off the page.
  • Any set of siblings — the block pages the direct children of whatever component it targets.

Key decisions

  • Target: give the component to paginate an ID, and enter the same value in Paginated Component ID. Its direct children become the items; a group of cards is unwrapped so each card counts as one.
  • Items Per Page: a multiple of the cards per row, so no page ends on a half-empty row.
  • Max Pages in Navigation: how many page numbers show at once. Three suits most lists.
  • Summary: the template takes {{currentFirstItem}}, {{currentLastItem}} and {{totalResults}}. Hide it when the count adds nothing.

Example

Nine cards, three per page. The section holding them has the ID pagination-demo, and the Pagination block beneath the cards points at it.

Migration

Moving a site onto Edge Delivery Services, and the questions to answer first.
true
/content/rhea/migration

Architecture

The solution stack, the repoless model and the environments.
true
/content/rhea/architecture

Operations

Standing a site up, and keeping one running.
true
/content/rhea/operations

Security

Environment access control and crawler hygiene.
true
/content/rhea/security

Governance

The decisions behind the platform, and what they are held to.
true
/content/rhea/governance

Status

Generated dashboards, and how current each one is.
true
/content/rhea/status

DevOps

The branching model and the CI/CD pipeline.
true
/content/rhea/devops

Blocks

Every block in the library, with live examples.
true
/content/rhea/blocks

Documentation

Authoring, developer and architecture guides.
true
/content/rhea/docs

All authoring options

General

id: optional id for the pagination element itself
paginatedCompId: ID of the component to paginate. Must match exactly
maxPageCount: page numbers shown at once. Default 3, range 1–20
itemsPerPage: items on each page. Default 10, range 1–100
hideResultsSummary: boolean — hide the summary line
resultsSummaryTemplate: rich text with {{currentFirstItem}}, {{currentLastItem}}, {{totalResults}}

First and last buttons

firstLastMode: boolean — show First and Last buttons
firstPageNavLabel / lastPageNavLabel: visible text. Default "First" / "Last"
firstPageNavAriaLabel / lastPageNavAriaLabel: screen reader labels. Default "First page" / "Last page"

Previous and next buttons

prevNextMode: boolean — text labels instead of arrow icons
prevPageNavLabel / nextPageNavLabel: visible text when prevNextMode is on
prevPageNavAriaLabel / nextPageNavAriaLabel: screen reader labels. Default "Previous page" / "Next page"

Analytics

classes_track-inview: emit an event when the block scrolls into view
classes_track-change: emit an event on every page change
meta: block-level analytics meta, sent as a JSON string

Events emitted:

emu-pagination:inview
emu-pagination:change