콘텐츠로 건너뛰기

페이지네이션

검색 결과, 표, 아카이브에 대한 페이지 번호 링크와 이전/다음 이동 버튼 — 네오브루탈리즘 스타일의 테두리와 그림자 효과를 적용했습니다.

import {
  Pagination,
  PaginationContent,

Pagination은 긴 결과 집합을 번호 있는 페이지 링크와 이전/다음 컨트롤로 나눕니다. 하위 프리미티브는 없습니다. nav 랜드마크가 일반 앵커를 감싸고, 각 링크는 Button으로 렌더링되며 네오브루탈리즘 공식(두꺼운 테두리, 선명한 그림자, 굵은 서체)에 맞춰 스타일을 입혔습니다.

다음과 같은 경우에 사용합니다.

  • 검색·목록 페이지 — 상품 그리드, 채용 게시판, 디렉터리처럼 12페이지로 바로 이동하는 경우.
  • 데이터 테이블 — 관리자 화면에서 아이콘만 있는 변형을 페이지당 행 수 선택과 함께 둡니다.
  • 블로그·문서 아카이브 — 실제 <a> 링크라 페이지마다 크롤 가능한 URL이 생깁니다. 무한 스크롤은 그렇지 않습니다.

설치

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/pagination.json
npx shadcn@latest add https://neobrutalism.com/r/base/pagination.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/pagination.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/pagination.json

다음 코드를 복사해서 프로젝트에 붙여넣습니다.

components/ui/pagination.tsx
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>
)
 

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> 랜드마크, 활성 PaginationLinkaria-current="page", 이전/다음 컨트롤은 명시적 aria-label, PaginationEllipsisaria-hidden과 스크린 리더 전용 "More pages" 텍스트입니다.

키보드 상호작용은 브라우저 네이티브 링크 동작입니다.

키보드 상호작용:

동작
Tab / Shift + Tab페이지 링크 사이와 밖으로 포커스 이동
Enter포커스된 링크 따라가기