Breadcrumbs

미리보기

로컬 미리보기입니다. 실제 계정, 환경, 실행 데이터에는 영향을 주지 않습니다.

사용법

최상위에서 현재 위치까지의 경로를 순서 목록으로 보여주세요. 긴 경로는 접히지 않고 줄바꿈되어 읽는 순서가 유지됩니다.

스크린 리더가 경로 구분자를 읽지 않게 하세요. 대신 장식 Separator를 사용하세요. 현재 위치는 aria-current=page로 표시하세요. 라우터 로직은 제품에 유지하세요.

크기: SizeProvider size="small" 포털까지 포함해 구성 전체의 크기를 바꿉니다. 기본 크기는 Default입니다. 크기 안내 및 비교

구성

Root(nav) → List(ol) → Item(Link / decorative Separator / Current)

키보드와 접근성

Tab으로 상위 링크에 이동하고 Enter로 엽니다. 현재 위치는 Tab 정지점이 아닙니다.

각 컨트롤에 목적을 설명하는 이름을 지정하세요. 오류 메시지를 해당 컨트롤에 연결하고, 상태를 색만으로 알리지 마세요. 자동 검사는 수동 키보드 및 보조 기술 테스트를 대신하지 않습니다.

예시 코드

공유 컴포넌트는 디자인 토큰에서 스타일을 가져옵니다. 각 예시는 자체 구성과 접근성 속성을 설정합니다. 호출하는 화면이 콜백, ref, 제품 데이터를 정의합니다.

import { Breadcrumbs } from '@surflane/ui'

<Breadcrumbs.Root aria-label='Project breadcrumb'>
  <Breadcrumbs.List>
    <Breadcrumbs.Item>
      <Breadcrumbs.Link href='/'>Platform</Breadcrumbs.Link>
    </Breadcrumbs.Item>
    <Breadcrumbs.Item>
      <Breadcrumbs.Separator />
      <Breadcrumbs.Current>Deployments</Breadcrumbs.Current>
    </Breadcrumbs.Item>
  </Breadcrumbs.List>
</Breadcrumbs.Root>

주요 API

표는 공통 래퍼의 주요 props를 나열합니다. 전체 타입은 패키지 타입 선언을 참조하세요.

관련 토큰