Navigation and disclosure · stable · MIT

Pagination

Current-page navigation with previous, next, and ellipsis parts.

Install editable source

Add Pagination

Base UI / canonicalnpx shadcn@latest add https://gummyui.dev/r/gummy-pagination.json

No package dependency beyond React. Shared Gummy material is resolved automatically.

Behavior contract

Semantics before surface

Semantics

A labelled nav with list links and aria-current.

Keyboard

Native link behavior.

System support

Light and dark themes, logical RTL layout, reduced motion, responsive content, and forwarded public refs.

Source-derived reference

Anatomy and public API

Exported anatomy

These public React parts are read directly from the canonical source during the documentation build.

  • GummyPagination
  • GummyPaginationEllipsis
  • GummyPaginationItem
  • GummyPaginationLink
  • GummyPaginationNext
  • GummyPaginationPrevious

Prop contracts

GummyPaginationLinkProps

Composes React.AnchorHTMLAttributes<HTMLAnchorElement> & { current?: boolean; size?: "page" | "wide"; }

GummyPaginationProps

Composes React.HTMLAttributes<HTMLElement> & { label?: string; }

Troubleshooting

Check behavior before surface.

Live product source

Inspect the canonical states

The Component Lab exercises real source across default, focus, disabled, responsive, dark, reduced-motion, and RTL contexts.

Open the live Component Lab

Interactive inspection

Try Pagination in context

Resize the canvas, switch its theme, or reverse its reading direction without changing the rest of the page.

Width
Theme
Direction

Pagination preview: fluid width, light theme, left to right.

Editable source

Read before you install

Canonical Base UI or native source

Loading editable source…