Chip

텍스트만 담는 레이블입니다. 선택적인 제거는 이름이 있는 버튼입니다. Chip.Overflow는 표시 전용 +N입니다.

DefaultRemovableOwn iconDisabled4 more

+N은 버튼이 아니며 탭 순서에 들어가지 않습니다.

제거 버튼에는 자체 글리프나 아이콘이 없습니다. 내용이 없으면 스타일시트가 X 모양을 그립니다. 직접 사용하는 아이콘 세트의 아이콘을 보여 주려면 removeIcon을 전달하세요. 버튼의 이름은 계속 removeLabel이나 그 기본값에서 오므로 아이콘에는 aria-hidden을 지정하세요. 그 기본값 Remove {label}과 +N에 읽히는 {n} more는 StringsProvider에서 옵니다.

<Chip.Root onRemove={remove} removeIcon={<CloseIcon aria-hidden />}>
  Design
</Chip.Root>

언제 쓰나요

언제: 값을 나타내는 텍스트 전용 토큰. onRemove로 선택적인 제거 버튼(이름이 있는 버튼). +N 오버플로는 표시 전용입니다.

쓰지 않을 때: 입력 안에서 입력한 토큰 → Field.ChipInput. 클릭하거나 선택할 수 있는 칩 → Button.Root / Checkbox(Chip에는 선택 기능이 없음). 레이블 안의 아이콘이나 풍부한 콘텐츠(텍스트만 가능).

Props

Chip.Root props
이름타입필수기본값설명
childrenstring예—칩 레이블. 텍스트만.
onRemove() => void아니요—이름이 붙은 제거 버튼을 렌더링합니다.
removeLabelstring아니요—제거 버튼의 aria-label. 기본값은 StringsProvider의 removeChip 문자열이며, 영어로는 Remove {label}입니다.
removeIconReact.ReactNode아니요—제거 버튼의 내용. 예: 직접 사용하는 아이콘 세트의 아이콘. 없으면 CSS가 X 모양을 그립니다.
disabledboolean아니요false제거 버튼을 비활성화합니다.