컴포넌트 · 액션

Chip

필터 · 카테고리 · 옵션처럼 여러 값 중 일부를 빠르게 켜고 끄는 토글 요소입니다. 선택되면 Inverse(다크)로 반전되어 무채색 화면에서도 선택 상태가 분명히 보입니다.

기본

필터 바 패턴

업무용 웹 목록 상단의 기간 · 상태 필터. 선택된 필터 수를 보여주고 초기화를 제공합니다.

사용 규칙

이렇게 하세요

  • 단일 선택이면 SegmentedControl, 다중 선택이면 Chip
  • 가로 스크롤 시 마지막 칩이 반쯤 보이게 배치
  • 선택 상태를 aria-pressed로 전달

이렇게 하지 마세요

  • 행동 실행(저장 · 삭제)에 칩 사용
  • 칩 10개 이상 한 줄에 나열 (Select로 전환)
  • 선택 색을 브랜드 퍼플로 채우기

Props

PropTypeDefault설명
selected / defaultSelectedboolean—제어 · 비제어 선택 상태
onSelectedChange(v: boolean) => void—선택 변경
onRemove() => void—지정 시 X 버튼 표시 (적용된 필터)
size"sm" | "md" | "lg""md"28 · 32 · 40px
iconReactNode—선행 아이콘