nav.paging

One link in a layout.pager below a long list or table: a page number, Previous or Next. Pass current on the page shown

Component

<Action>

Renders

<a>

Profile

View as Markdown

Navigation intents

Example

Preview

defaultcurrentdisabled

<Action intent="nav.paging" href="/somewhere" current={isCurrent}>Pagination</Action>

Code that says pagination, page, previous, next points here. prongs check warns when an element with this intent has a handler or label that points somewhere else.

Choosing between neighbours

Find the row that describes your element, and use the intent on the right.

If it is
Use
One link in a layout.pager below a long list or table: a page number, Previous or Next. Pass current on the page shown
nav.paging this page
Pages in site navigation
nav.page
Steps in a multi-step flow
nav.step
Pages of a long list or table
rather than nav.dot
nav.paging this page
Page numbers below a long list
rather than nav.sequel
nav.paging this page

Connections

Declared in the registry, both directions. Where an intent is used in your own code is something check and the gallery see; this site has no app code.

Built from
control.ghost

For registry authors

Starter intents. These are the intents prongs add puts in your registry, shown in this site’s theme. Yours are your own registry.ts: rename, restyle and add to them, and see them with prongs add gallery.

What this intent is built from and its entry in components/prongs/registry.ts. You only need this to change how it looks or to add an intent like it.

How nav.paging resolves, and its definition

Each layer adds to the one before it; a later class wins over an earlier one that sets the same thing.

control.base

Shape and behaviour shared by every button

inline-flex shrink-0 items-center justify-center gap-2
whitespace-nowrap rounded-md px-4 py-2 text-sm transition-colors
focus-visible:outline-none focus-visible:ring-2
focus-visible:ring-ring focus-visible:ring-offset-2
ring-offset-surface disabled:pointer-events-none
disabled:opacity-50 aria-disabled:pointer-events-none
aria-disabled:opacity-50

control.ghost

No fill until hovered

rounded-full font-medium text-foreground hover:bg-surface-hover

nav.paging
One link in a layout.pager below a long list or table: a page number, Previous or Next. Pass current on the page shown
```
min-w-9 px-3 aria-[current]:bg-surface-active
```

Final classes

inline-flex shrink-0 items-center justify-center gap-2
whitespace-nowrap py-2 text-sm transition-colors
focus-visible:outline-none focus-visible:ring-2
focus-visible:ring-ring focus-visible:ring-offset-2
ring-offset-surface disabled:pointer-events-none
disabled:opacity-50 aria-disabled:pointer-events-none
aria-disabled:opacity-50 rounded-full font-medium
text-foreground hover:bg-surface-hover min-w-9 px-3
aria-[current]:bg-surface-active

Definition

'nav.paging': {
  kind: 'semantic',
  description: 'One link in a layout.pager below a long list or table: a page number, Previous or Next. Pass current on the page shown',
  refs: ['control.ghost'],
  keywords: ['pagination', 'page', 'previous', 'next'],
  binding: { classes: 'min-w-9 px-3 aria-[current]:bg-surface-active' },
  notFor: [
    { context: 'pages in site navigation', instead: 'nav.page' },
    { context: 'steps in a multi-step flow', instead: 'nav.step' },
  ],
},