Breadcrumb

Breadcrumb

현재 페이지의 위치를 계층 경로로 표시하는 내비게이션 컴포넌트입니다. nav · ol 시맨틱 구조와 aria-current="page"로 접근성을 지원합니다.

기본

이전 단계는 링크, 마지막 항목은 현재 페이지로 표시합니다.

구분자

separator로 구분자 스타일을 변경합니다.

홈 아이콘

icon으로 아이콘만 있는 첫 항목을 표시합니다.

크기

size로 텍스트 크기를 조절합니다.

경로 생략

긴 경로는 첫 항목·생략 버튼·직전 단계·현재 페이지만 표시합니다.

상태

비활성 링크는 disabled를 사용합니다.

API · Breadcrumb Props

Prop타입기본값설명
itemsArray<{ label, href?, current?, disabled?, as? }>[]경로 데이터. BreadcrumbItem 슬롯 대체
aria-labelstring경로nav aria-label
separator'chevron' | 'slash' | 'dot'chevronbreadcrumb_sep-slash · breadcrumb_sep-dot
size'sm' | 'md' | 'lg'mdbreadcrumb_sm · breadcrumb_lg

API · BreadcrumbItem Props

Prop타입기본값설명
labelstring항목 텍스트
hrefstring링크 URL
currentbooleanfalseis-current · aria-current="page"
disabledbooleanfalseis-disabled
iconbooleanfalsebreadcrumb_link-icon
aria-labelstring아이콘 전용 링크 라벨
asstring | Componenta링크 루트 요소. NuxtLink 같은 커스텀 링크 컴포넌트 지정
ripplebooleantrue클릭 파장(ripple). true 시 data-ripple 활성 · false 비활성. 기본 활성

API · Breadcrumb Slots

슬롯설명
defaultBreadcrumbItem 나열 (items prop 대체)

API · BreadcrumbItem Slots

슬롯설명
default링크 텍스트·아이콘 (label 대체)

클래스 · 속성

Vue 컴포넌트가 렌더하는 OOCSS 클래스입니다. HTML 마크업으로 직접 작성할 때 동일하게 조합합니다.

클래스설명
breadcrumb · breadcrumb_list · breadcrumb_item루트·목록·항목
breadcrumb_link · breadcrumb_sep링크·구분자
breadcrumb_ellipsis생략 메뉴 버튼 — data-ripple
breadcrumb_sep-slash · breadcrumb_sep-dot구분자 스타일
breadcrumb_sm · breadcrumb_lg크기 변형
is-current · is-disabled현재·비활성
data-ripple클릭 파장 활성. data-ripple="surface"는 절대 위치 보조 버튼용
data-ripple="false"해당 요소 ripple 비활성
data-no-ripple하위 전체 ripple 비활성

디자인 토큰

토큰기본값설명
--breadcrumb-gap · --breadcrumb-font-size간격·글자 크기
--breadcrumb-sep-color구분자 색