Form

Pagination

Page navigation component for splitting large data sets across multiple pages.

Overview

The Pagination component lets users move through paged content (e.g. product lists or search results) with previous/next and optional page numbers. It keeps navigation consistent and accessible.

Key Business & UX Benefits

  • Lets users browse large result sets without endless scrolling.
  • Clear previous/next and page numbers reduce confusion.
  • Accessible keyboard and focus support for all controls.
  • Fits product grids, search results, and any paged content.
Pro-Tip from Larry: Use Pagination when you have many pages so users can jump to a specific page.

Usage

Pagination

Feature List

  • Previous and next controls with optional page numbers
  • Configurable page size and total count
  • Accessible keyboard and focus support
  • Theme-aligned styling for light and dark modes

API Reference

PropDefaultType
totalrequirednumber
itemsPerPagerequirednumber
pagerequirednumber
siblingCount1number
showEdgestrueboolean
defaultPage1number
isNavigationNumbersboolean
hrefTemplate(context: { page: number; }): string

If set, switches <button> to <a> elements and use this template-function to output the href for the target page.

Setting this will disable the internal page change handler and use the hrefTemplate to navigate to the page. The page-model will no longer be updated.

scrollToToptrueboolean

Scroll to the top of the page when navigating to a different page.

EventType
update:page(event: "update:page", value: number): void
Copyright © 2026 Laioutr GmbH