Primitives

Pagination

Page navigation for long lists and result sets.

Composition

Page navigation

<Pagination>
- <PaginationContent>
 - previous page
 - <PaginationItem>
 - <PaginationPrevious />
 </PaginationItem>
 - each page
 - <PaginationItem>
 - <PaginationLink />
 </PaginationItem>
 - skipped pages
 - <PaginationItem>
 - <PaginationEllipsis />
 </PaginationItem>
 - next page
 - <PaginationItem>
 - <PaginationNext />
 </PaginationItem>
 </PaginationContent>
</Pagination>

Installation

First install and activate one skin. Core deliberately contains no visual token defaults.

The Control UI source installs this primitive from src/registry/sources/control-ui/ui/pagination.tsx.

Registry command

npx shadcn@latest add https://control-ui.dev/r/pagination.json

See registry manifest

Raw code

Primary installed source

src/registry/sources/control-ui/ui/pagination.tsx

import { ChevronLeft, ChevronRight, MoreHorizontal } from "lucide-react";

import type { ComponentProps, CSSProperties } from "react";

import type { PaginationKnobStyle } from "@/components/control-ui/knob-contracts/pagination-knobs";

import { cn } from "@/components/control-ui/lib/cn";

export type PaginationEllipsisProps = Omit<ComponentProps<"span">, "style" | "children"> & {

label?: string;

style?: CSSProperties & PaginationKnobStyle;

};

export type PaginationLinkProps = Omit<

ComponentProps<"a"> & {

isActive?: boolean;

disabled?: boolean;

},

"style"

> & { style?: CSSProperties & PaginationKnobStyle };

// Links are control-shaped by hand rather than importing Button, so pagination installs alone.

export function Pagination({ className, ...props }: ComponentProps<"nav"> & { style?: CSSProperties & PaginationKnobStyle }) {

return (

<nav

aria-label="Pagination"

data-control-ui="pagination"

data-control-family="pagination"

data-slot="root"

className={cn("mx-auto flex w-full justify-center", className)}

{...props}

/>

);

}

export function PaginationContent({ className, ...props }: ComponentProps<"ul"> & { style?: CSSProperties & PaginationKnobStyle }) {

return (

<ul

data-control-ui="pagination"

data-control-family="pagination"

data-slot="content"

className={cn("flex flex-row items-center", className)}

{...props}

/>

);

}

export function PaginationItem({ className, ...props }: ComponentProps<"li"> & { style?: CSSProperties & PaginationKnobStyle }) {

  return <li data-control-ui="pagination" data-control-family="pagination" data-slot="item" className={className} {...props} />;

}

const paginationLinkChrome =

  "inline-flex h-control-sm min-w-control-sm cursor-pointer select-none items-center justify-center whitespace-nowrap aria-disabled:pointer-events-none [&>svg]:size-4 [&>svg]:shrink-0";

export function PaginationLink({ isActive = false, disabled = false, href, className, ...props }: PaginationLinkProps) {

return (

<a

aria-current={isActive ? "page" : undefined}

data-control-ui="pagination"

data-control-family="pagination"

data-slot="link"

data-control="true"

data-active={isActive ? "true" : undefined}

role={disabled ? "link" : undefined}

aria-disabled={disabled || undefined}

className={cn(paginationLinkChrome, className)}

{...props}

href={disabled ? undefined : href}

/>

);

}

export function PaginationPrevious({ className, children = "Previous", ...props }: PaginationLinkProps) {

return (

<PaginationLink className={className} {...props}>

<ChevronLeft aria-hidden="true" data-icon-dir="inline" />

{children}

</PaginationLink>

);

}

export function PaginationNext({ className, children = "Next", ...props }: PaginationLinkProps) {

return (

<PaginationLink className={className} {...props}>

{children}

<ChevronRight aria-hidden="true" data-icon-dir="inline" />

</PaginationLink>

);

}

export function PaginationEllipsis({ label = "More pages", className, ...props }: PaginationEllipsisProps) {

return (

<span

data-control-ui="pagination"

data-control-family="pagination"

data-slot="ellipsis"

className={cn("flex h-control-sm min-w-control-sm items-center justify-center [&>svg]:size-4", className)}

{...props}

>

<MoreHorizontal aria-hidden="true" />

{label}

);

}

Knobs

Typed custom properties the recipe paints with. Set one on the root — style, a utility class, or a skin — and every slot inherits it.

--cui-pagination-* · 5 knobsHow the cascade resolves

--cui-pagination-link-radius<length-percentage>var(--radius-control)

--cui-pagination-link-background<color>transparent

--cui-pagination-link-hover-background<color>var(--hover-fill)

--cui-pagination-link-foreground<color>var(--foreground)

--cui-pagination-link-shadow*none