Skip to main content Skip to docs navigation

Pagination

Navigation controls that divide content across multiple pages, allowing users to browse through large datasets or content collections sequentially.

This documentation is a work in progress and may contain incomplete or outdated information. If you have any feedback or suggestions, please open an issue on GitHub.

Props

Configurable properties that control the appearance, behavior, and functionality of pagination components for content navigation and user interaction management.

Page Number

Properties that define the visual state and interactive behavior of individual numeric page selection elements within pagination interfaces.

Pagination example image Pagination example image

state variant

Controls the interactive state and visual feedback of the page number element based on user interaction and current page status.

  • idle
  • hover
  • active
  • disabled

Page Arrow

Properties that define the visual state and directional functionality of navigation arrow elements for sequential page movement within pagination interfaces.

Pagination example image Pagination example image

state variant

Controls the interactive state and visual feedback of the navigation arrow based on user interaction and directional availability.

  • idle
  • hover
  • press
  • disabled

icon instance-swap

Specifies which icon component to display for the directional navigation arrow when providing previous or next page functionality.

Simple Pagination

Properties that define the visual state and navigation behavior of numbered page button elements for standard content pagination.

Pagination example image Pagination example image

state variant

Controls the position state and navigation capabilities of the pagination component based on current page location within the content sequence.

  • first
  • middle
  • last

has-separator boolean

Controls the visibility of a separator line between the paginated content and pagination controls.

  • true
  • false

Advanced Pagination

Properties that define the visual state and enhanced functionality of comprehensive pagination elements including size configuration and optional control visibility.

Pagination example image Pagination example image

size variant

Controls the dimensional scale and content presentation of the advanced pagination component to optimize usability across different screen sizes and interface contexts.

  • large
  • small

has-per-page boolean

Controls the visibility of item count selection input that allows users to configure how many items are displayed per page.

  • true
  • false

has-summary boolean

Controls the visibility of status information text that displays current item range and total count for user reference.

  • true
  • false

has-separator boolean

Controls the visibility of a separator line between the paginated content and pagination interface.

  • true
  • false

Dot Pagination

Properties that define the visual state and position indication behavior of minimal dot-based navigation elements for sequential content browsing.

Pagination example image Pagination example image

position variant

Controls the active position state and visual feedback of the dot pagination component, determining which dot is highlighted within the sequence of available positions.

  • active-position