탐색과 공개@neumorphism-ui/pagination

Pagination

nav, ul, li, anchor의 시맨틱을 유지하는 조합형 pagination입니다. 활성 페이지, 이전·다음 링크, 축약 표시를 제공합니다.

@neumorphism-ui/pagination
Registry JSON

미리보기

설치

설치: paginationnpx shadcn@latest add @neumorphism-ui/pagination

CLI가 npm 의존성, base 토큰, utils와 컴포넌트 소스를 순서대로 확인하고 설치합니다.

Registry를 처음 사용한다면 namespace 설정 을 먼저 완료하세요.

사용법

Import

Pagination import 코드
import {
  Pagination,
  PaginationContent,
  PaginationEllipsis,
  PaginationItem,
  PaginationLink,
  PaginationNext,
  PaginationPrevious,
} from "@/components/ui/pagination"

Example

Pagination 사용 코드
<Pagination>
  <PaginationContent>
    <PaginationItem>
      <PaginationPrevious href="?page=1" />
    </PaginationItem>
    <PaginationItem>
      <PaginationLink href="?page=1">1</PaginationLink>
    </PaginationItem>
    <PaginationItem>
      <PaginationLink href="?page=2" isActive>2</PaginationLink>
    </PaginationItem>
    <PaginationItem><PaginationEllipsis /></PaginationItem>
    <PaginationItem>
      <PaginationNext href="?page=3" />
    </PaginationItem>
  </PaginationContent>
</Pagination>

API 레퍼런스

컴포넌트속성타입기본값설명
Paginationaria-labelstring"pagination"pagination navigation 영역의 접근 가능한 이름입니다.
PaginationLinkhref필수string—대상 페이지의 실제 URL입니다.
PaginationLinkisActivebooleanfalse현재 페이지 스타일과 aria-current=page를 설정합니다.
PaginationPrevious / PaginationNextchildrenReact.ReactNode"Previous" / "Next"기본 이동 문구를 교체합니다.

접근성

  • 01

    각 페이지는 실제 href가 있는 링크여야 브라우저 탐색과 새 탭 열기를 유지합니다.

  • 02

    현재 페이지 하나에만 isActive를 지정해 aria-current=page를 설정합니다.

  • 03

    Previous와 Next에는 기본 aria-label이 있으며 지역화가 필요하면 덮어씁니다.