탐색과 공개@neumorphism-ui/breadcrumb

Breadcrumb

nav와 ol의 기본 시맨틱을 보존하며 링크, 현재 페이지, separator, 축약 표시를 조합할 수 있습니다. 현재 페이지는 aria-current=page로 자동 표시됩니다.

@neumorphism-ui/breadcrumb
Registry JSON

미리보기

설치

설치: breadcrumbnpx shadcn@latest add @neumorphism-ui/breadcrumb

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

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

사용법

Import

Breadcrumb import 코드
import {
  Breadcrumb,
  BreadcrumbItem,
  BreadcrumbLink,
  BreadcrumbList,
  BreadcrumbPage,
  BreadcrumbSeparator,
} from "@/components/ui/breadcrumb"

Example

Breadcrumb 사용 코드
<Breadcrumb>
  <BreadcrumbList>
    <BreadcrumbItem>
      <BreadcrumbLink href="/">Home</BreadcrumbLink>
    </BreadcrumbItem>
    <BreadcrumbSeparator />
    <BreadcrumbItem>
      <BreadcrumbLink href="/components">Components</BreadcrumbLink>
    </BreadcrumbItem>
    <BreadcrumbSeparator />
    <BreadcrumbItem>
      <BreadcrumbPage>Breadcrumb</BreadcrumbPage>
    </BreadcrumbItem>
  </BreadcrumbList>
</Breadcrumb>

API 레퍼런스

컴포넌트속성타입기본값설명
Breadcrumbaria-labelstring"breadcrumb"경로 탐색 영역의 접근 가능한 이름입니다.
BreadcrumbLinkhref필수string—상위 경로의 실제 URL입니다.
BreadcrumbPagechildren필수React.ReactNode—현재 페이지 이름이며 aria-current=page가 적용됩니다.
BreadcrumbSeparatorchildrenReact.ReactNode"/"보조기술에서 숨겨지는 시각적 구분자입니다.

접근성

  • 01

    Breadcrumb는 aria-label=breadcrumb인 nav이고 목록은 순서 있는 ol입니다.

  • 02

    마지막 항목에는 링크 대신 BreadcrumbPage를 사용해 aria-current=page를 전달합니다.

  • 03

    Separator와 Ellipsis는 장식 요소로 보조기술에서 숨겨집니다.