import {
Pagination,
PaginationContent,Pagination은 긴 결과 집합을 번호 있는 페이지 링크와 이전/다음 컨트롤로 나눕니다. 하위 프리미티브는 없습니다. nav 랜드마크가 일반 앵커를 감싸고, 각 링크는 Button으로 렌더링되며 네오브루탈리즘 공식(두꺼운 테두리, 선명한 그림자, 굵은 서체)에 맞춰 스타일을 입혔습니다.
다음과 같은 경우에 사용합니다.
- 검색·목록 페이지 — 상품 그리드, 채용 게시판, 디렉터리처럼 12페이지로 바로 이동하는 경우.
- 데이터 테이블 — 관리자 화면에서 아이콘만 있는 변형을 페이지당 행 수 선택과 함께 둡니다.
- 블로그·문서 아카이브 — 실제
<a>링크라 페이지마다 크롤 가능한 URL이 생깁니다. 무한 스크롤은 그렇지 않습니다.
설치#
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/pagination.jsonnpx shadcn@latest add https://neobrutalism.com/r/base/pagination.jsonyarn dlx shadcn@latest add https://neobrutalism.com/r/base/pagination.jsonbunx --bun shadcn@latest add https://neobrutalism.com/r/base/pagination.json
다음 코드를 복사해서 프로젝트에 붙여넣습니다.
import * as React from "react"
import {
ChevronLeftIcon,
ChevronRightIcon,
MoreHorizontalIcon,
} from "lucide-react"
import { cn } from "@/lib/utils"
import { Button } from "@/components/ui/button"
function Pagination({ className, ...props }: React.ComponentProps<"nav">) {
return (
<nav
role="navigation"
aria-label="pagination"
data-slot="pagination"
className={cn("mx-auto flex w-full justify-center", className)}
{...props}
/>
)
}
function PaginationContent({
className,
...props
}: React.ComponentProps<"ul">) {
return (
<ul
data-slot="pagination-content"
className={cn("flex items-center gap-0.5", className)}
{...props}
/>
)
}
function PaginationItem({ ...props }: React.ComponentProps<"li">) {
return <li data-slot="pagination-item" {...props} />
}
type PaginationLinkProps = {
isActive?: boolean
} & Pick<React.ComponentProps<typeof Button>, "size"> &
React.ComponentProps<"a">
function PaginationLink({
className,
isActive,
size = "icon",
...props
}: PaginationLinkProps) {
return (
<Button
asChild
variant={isActive ? "default" : "ghost"}
size={size}
className={cn(className)}
>
<a
aria-current={isActive ? "page" : undefined}
data-slot="pagination-link"
data-active={isActive}
{...props}
/>
</Button>
)
}
function PaginationPrevious({
className,
text = "Previous",
...props
}: React.ComponentProps<typeof PaginationLink> & { text?: string }) {
return (
<PaginationLink
aria-label="Go to previous page"
size="default"
className={cn("pl-1.5!", className)}
{...props}
>
<ChevronLeftIcon data-icon="inline-start" className="cn-rtl-flip" />
<span className="hidden sm:block">{text}</span>
</PaginationLink>
)
}
function PaginationNext({
className,
text = "Next",
...props
}: React.ComponentProps<typeof PaginationLink> & { text?: string }) {
return (
<PaginationLink
aria-label="Go to next page"
size="default"
className={cn("pr-1.5!", className)}
{...props}
>
<span className="hidden sm:block">{text}</span>
<ChevronRightIcon data-icon="inline-end" className="cn-rtl-flip" />
</PaginationLink>
)
}
function PaginationEllipsis({
className,
...props
}: React.ComponentProps<"span">) {
return (
<span
aria-hidden
data-slot="pagination-ellipsis"
className={cn(
"flex size-8 items-center justify-center [&_svg:not([class*='size-'])]:size-4",
className
)}
{...props}
>
<MoreHorizontalIcon />
<span className="sr-only">More pages</span>
</span>
)
}
export {
Pagination,
PaginationContent,
PaginationEllipsis,
PaginationItem,
PaginationLink,
PaginationNext,
PaginationPrevious,
}
import 경로를 프로젝트 구성에 맞게 수정합니다.
사용법#
import {
Pagination,
PaginationContent,
PaginationEllipsis,
PaginationItem,
PaginationLink,
PaginationNext,
PaginationPrevious,
} from "@/components/ui/pagination"<Pagination>
<PaginationContent>
<PaginationItem>
<PaginationPrevious href="#" />
</PaginationItem>
<PaginationItem>
<PaginationLink href="#">1</PaginationLink>
</PaginationItem>
<PaginationItem>
<PaginationLink href="#" isActive>
2
</PaginationLink>
</PaginationItem>
<PaginationItem>
<PaginationLink href="#">3</PaginationLink>
</PaginationItem>
<PaginationItem>
<PaginationEllipsis />
</PaginationItem>
<PaginationItem>
<PaginationNext href="#" />
</PaginationItem>
</PaginationContent>
</Pagination>구성#
Pagination을 만들려면 다음 구성을 사용합니다.
Pagination
└── PaginationContent
├── PaginationItem
│ └── PaginationPrevious
├── PaginationItem
│ └── PaginationLink
├── PaginationItem
│ └── PaginationEllipsis
└── PaginationItem
└── PaginationNext예제#
기본#
페이지 번호만 있는 간단한 페이지네이션입니다.
import {
Pagination,
PaginationContent,아이콘만#
페이지 번호 없이 이전, 다음 버튼만 사용합니다. 페이지당 행 수 선택기가 있는 데이터 테이블에 유용합니다.
import { Field, FieldLabel } from "@/components/ui/field"
import {
Pagination,Next.js#
기본적으로 <PaginationLink /> 컴포넌트는 <a /> 태그를 렌더링합니다.
Next.js의 <Link /> 컴포넌트를 사용하려면 pagination.tsx에 다음 변경을 적용합니다.
+ import Link from "next/link"
- type PaginationLinkProps = ... & React.ComponentProps<"a">
+ type PaginationLinkProps = ... & React.ComponentProps<typeof Link>
const PaginationLink = ({...props }: ) => (
<PaginationItem>
- <a>
+ <Link>
// ...
- </a>
+ </Link>
</PaginationItem>
)
참고: 이 작업을 자동으로 처리하도록 CLI를 업데이트하고 있습니다.
RTL#
Neobrutalism에서 RTL 지원을 활성화하는 방법은 RTL 설정 가이드를 참고하세요.
"use client"
import * as React from "react"변경 로그#
RTL 지원#
이전 버전의 Pagination 컴포넌트에서 업그레이드하는 경우, text prop을 추가하려면 다음 변경을 적용해야 합니다.
PaginationPrevious를 업데이트합니다.
function PaginationPrevious({
className,
+ text = "Previous",
...props
- }: React.ComponentProps<typeof PaginationLink>) {
+ }: React.ComponentProps<typeof PaginationLink> & { text?: string }) {
return (
<PaginationLink
aria-label="Go to previous page"
size="default"
className={cn("cn-pagination-previous", className)}
{...props}
>
<ChevronLeftIcon />
<span className="cn-pagination-previous-text hidden sm:block">
- Previous
+ {text}
</span>
</PaginationLink>
)
}PaginationNext를 업데이트합니다.
function PaginationNext({
className,
+ text = "Next",
...props
- }: React.ComponentProps<typeof PaginationLink>) {
+ }: React.ComponentProps<typeof PaginationLink> & { text?: string }) {
return (
<PaginationLink
aria-label="Go to next page"
size="default"
className={cn("cn-pagination-next", className)}
{...props}
>
- <span className="cn-pagination-next-text hidden sm:block">Next</span>
+ <span className="cn-pagination-next-text hidden sm:block">{text}</span>
<ChevronRightIcon />
</PaginationLink>
)
}접근성#
Pagination은 복합 위젯이 아니라 링크 기반 탐색이라 전용 WAI-ARIA 패턴은 없습니다. 네이티브 링크 시맨틱이 일을 합니다. 루트는 aria-label="pagination"이 있는 <nav> 랜드마크, 활성 PaginationLink는 aria-current="page", 이전/다음 컨트롤은 명시적 aria-label, PaginationEllipsis는 aria-hidden과 스크린 리더 전용 "More pages" 텍스트입니다.
키보드 상호작용은 브라우저 네이티브 링크 동작입니다.
키보드 상호작용:
| 키 | 동작 |
|---|---|
Tab / Shift + Tab | 페이지 링크 사이와 밖으로 포커스 이동 |
Enter | 포커스된 링크 따라가기 |