DETAIL PANEL · DEMO

Sample project review

Keep your context while reviewing the details.

Ready for review
Template route
/pagination
Project
Riverside workspace (fictitious)
Owner
Morgan Lee (fictitious)

Summary

This is an original example. The underlying page stays visible while the panel holds the details. No account, payment or external service is connected.

Review note

Skip to content

Pagination ​

Pagination splits a result set into manageable pages. Use it when people need a stable place, a known count or a way back to earlier results. A highlighted number alone is not pagination: the visible records and range must follow the selected page.

Try local pages ​

Eight fictitious records are shown three at a time. Choose a page, First/Last or Previous/Next. Page 3 contains the final two records. Boundary buttons are truly disabled, and the status reports the actual slice. No remote data is fetched and nothing is saved.

  • Fictitious record 1
  • Fictitious record 2
  • Fictitious record 3

Page 1 of 3. Showing 1 to 3 of 8 fictitious records. Nothing is fetched or saved.

How to use it ​

  1. Define the data contract. Decide between page numbers and server cursors. Do not invent a total for an API that does not provide one.
  2. Keep results and controls in sync. One current page should determine both the slice and aria-current="page".
  3. Handle boundaries. Disable Previous on the first page and Next on the last known page. Clamp a page after filtering or data changes.
  4. Describe the result range. Include units such as records, not just an unexplained page number. Handle an empty set without showing a false 1..0 range.
  5. Choose links versus local buttons. Real URL pages use hrefs and browser history. Buttons are appropriate for this local client-side slice.
  6. Keep state on failure. For remote results, preserve known data, expose loading/error and ignore stale responses. Do not show a new page number with old data as though it finished.

Anatomy ​

PartPurpose
Result regionThe actual records for the current page.
Pagination navNames the controls independently of other page navigation.
First / Previous / Next / LastMove to an endpoint or adjacent valid page with native disabled boundaries.
Page button/linkDirect page selection with an accessible page name.
Current markeraria-current="page" on the selected page control.
Range/statusActual position and count, announced politely after local changes.

Data shape ​

PaginationUsageDemo.vue has no props or emits. Exact local data:

ts
// records: { id: string; label: string }[] = 8 fictitious records
// page: number = 1
// pageSize: number = 3
// pages: number = Math.ceil(records.length / pageSize) // 3
// visible: computed records.slice((page - 1) * pageSize, page * pageSize)

go(n) clamps to 1..3. The final page contains records 7 and 8. The page buttons and status use the same state. There are no requests, cursors, URL parameters, filters or persistence. This fixed eight-record demo does not implement empty/loading states.

A real page-number response might be:

ts
type PageResult<T> = { items: T[]; page: number; pageSize: number; total: number }
// Cursor APIs need next/previous cursor state instead; they may have no total.

This is an application contract, not a shared catalog component API. Validate requested limits and access server-side.

Usage ​

vue
<nav aria-label="Record pages">
  <button :disabled="page === 1" @click="go(page - 1)">Previous</button>
  <button v-for="n in pages" :key="n" :aria-label="`Page ${n}`"
    :aria-current="page === n ? 'page' : undefined" @click="go(n)">{{ n }}</button>
  <button :disabled="page === pages" @click="go(page + 1)">Next</button>
</nav>

Define the state, actual result slice and boundary logic in the application. Use type button inside a form. This snippet shows controls only; import PaginationUsageDemo.vue for the exact local slice and status. For server-backed URLs, use real links rather than preventing normal browser navigation.

States and variants ​

  • First / middle / last: boundaries and range text follow actual data.
  • Current: exactly one direct page control has aria-current page; it stays an ordinary button/link, not an ARIA tab.
  • Small / large / rounded: visual treatments preserve readable labels and usable targets. This guide uses at least 44px controls.
  • Many pages / ellipsis: show a stable window around current and meaningful first/last access. Ellipsis is not a fake clickable page.
  • Empty: no records and a clear empty state, with irrelevant controls removed or disabled. Do not claim a fabricated total.
  • Loading / error: distinguish requested from confirmed page, preserve known data and offer retry. This demo is synchronous and has neither state.
  • Filtered results: reset or clamp the page when the result count shrinks. Apply sorting consistently across all pages, not each visible slice independently.

Template map ​

SurfaceActual implementation
Lustro baseGuide, components, UI kit: local Previous/Next and page count, not a backend result query.
Lustro expandedPagination: .pg / small / large / rounded visual anchors without real href destinations.
Felix expandedPagination: corresponding scoped visual specimens.
Lumen expandedPagination: link to bundled gallery examples.
Scopecraft expandedPagination: corresponding visual examples.
Felix moleculesPagination: local data-page/data-dir buttons and page label. Design-source import prose is not an installed shared package API.
Studio catalogsRelay, Folio, Pace, Spark: local page value1..3 with aria-current and boundary buttons. The adjacent sample table is not sliced by that page value. This guide's separate demo does slice its records.

Motion and accessibility ​

A 120ms button background transition marks selection; reduced motion removes it. Records change immediately. Avoid an animation that briefly leaves old records under a new page label.

Tab and Enter/Space use native button behavior. Do not implement tablist arrow navigation for pagination. Keep focus stable after local updates, and announce the concise range via status. For route navigation use normal document focus/history conventions. Test wrapped mobile controls, long labels and the final partial page.

Integration notes ​

Import PaginationUsageDemo.vue for this exact local example. Preserve each catalog's scoped classes. Server data may change between pages; use stable sorting and reconcile deletions, permissions and cursor expiry. Do not expose private counts beyond the viewer's access. All records here are fictitious and local.

Lateral detail drawer

Open a detail panel without losing the page behind it. This shared pattern follows the current template's colors. Fictitious data; actions stay local.