Pagination
Canonical page links or Live page actions with explicit boundary states.
Canonical links reload the requested demo page without a Live action.
Each preview is its own Live page in a frame, because this site is a Vue 3.5 app built on the Pulsar starter kit. An open list or popover stays inside its frame; in your application it opens over the page.
Installation
suprnova live:add paginationUsage
{% import "suprnova-ui/pagination/pagination.html" as pagination %}
{% call pagination::pagination("pages") %}{% call pagination::page_link("/entries?page=1", 1, current=true) %}{% endcall %}{% endcall %}Examples
Live pages
The server pages through demo records and replaces the same-route page query.
Keyboard and accessibility
suprnova.pagination - two explicit modes (NAV-003). Route mode: every page is an anchor with its canonical URL, so reload, sharing and history are the browser's. Live mode: previous and next are buttons on registered actions whose result reflects the new query into the current history entry through the runtime (history.replaceState, no entry per page); the current position is text.
API reference
pagination
| Parameter | Default | Description |
|---|---|---|
id | Required | Unique pagination navigation ID. |
label | "Pages" | Accessible name of the page navigation. |
page_link
| Parameter | Default | Description |
|---|---|---|
href | Required | Canonical URL of this page. |
number | Required | Visible page number. |
current | false | Server-authoritative current page, marked with aria-current. |
page_edge_link
| Parameter | Default | Description |
|---|---|---|
href | Required | Canonical URL of the adjacent page. |
text | Required | Visible previous or next label. |
disabled | false | Unavailable boundary, rendered as text rather than an anchor. |
page_action
| Parameter | Default | Description |
|---|---|---|
action | Required | Registered Live action that changes the page and reflects its query. |
text | Required | Visible page action text. |
disabled | false | Unavailable boundary; disables the button. |
page_position
| Parameter | Default | Description |
|---|---|---|
page | Required | Current one-based page number. |
pages | Required | Server-known total number of pages. |
