Separator
1px 헤어라인 구분선 — 기본은 순수 장식(role="none")으로 접근성 트리에서 제외되고, decorative={false}일 때만 의미적 구분자가 됩니다.
마지막 업데이트 2026-06-11
한눈에#
콘텐츠 사이 1px 헤어라인 구분선입니다 — 기본은 순수 장식(role="none")이라 접근성 트리에서 제외되고, decorative={false}일 때만 의미적 구분자가 됩니다.
위 콘텐츠
아래 콘텐츠
- 1px 헤어라인 고정
- 기본 role=none 장식
- horizontal·vertical
- decorative=false 의미적
두께는 1px 고정, 길이는 부모를 따릅니다 — 대부분의 경우 기본(장식)이 맞습니다
플레이그라운드#
컨트롤로 props를 조작하면 미리보기와 코드가 실시간 갱신됩니다.
import { Separator } from '@wds/ui-web';
<Separator />변형#
편집복제삭제
크기#
두께는 1px 헤어라인 고정입니다. 길이는 부모를 따릅니다 — horizontal은 폭 100%, vertical은 플렉스 컨테이너 높이에 맞춰 늘어납니다.
상태#
정적 컴포넌트라 인터랙션 상태가 없습니다(RSC).
Props#
| Prop | 타입 | 기본값 | 설명 |
|---|---|---|---|
orientation | 'horizontal' | 'vertical' | 'horizontal' | 구분 방향 |
decorative | boolean | true | true면 순수 장식(role="none") — 접근성 트리에서 제외 |
…rest | HTMLAttributes<div> | — | className 등 네이티브 속성 전달 |
접근성#
- 기본(
decorative: true)은role="none"— 시각 구분일 뿐 의미가 없어 보조기술이 무시합니다. 대부분의 경우 기본값이 맞습니다 decorative={false}면role="separator"+aria-orientation이 붙어 콘텐츠 그룹의 의미적 경계로 보고됩니다 (예: 메뉴 섹션 구분)- 색만으로 정보를 전달하지 않습니다 — 경계는 레이아웃 보조일 뿐입니다
토큰#
component 토큰 없이 semantic을 직접 소비합니다(신설 기준 §4 미충족).
| 속성 | 토큰 |
|---|---|
| 선 색 | color.border |
| 두께 | 1px 고정 (헤어라인 — 토큰 대상 아님) |