Skip to Content
Lynx

Chip

사용자가 선택하거나 실행할 수 있는 짧은 값을 표시하는 컴포넌트입니다.

Engine ≥ 3.6
사용 가능 버전@seed-design/lynx-react@0.5.0, @seed-design/lynx-css@0.9.0
Lynx 예제를 불러오는 중입니다.

Installation

npm install @seed-design/lynx-react @seed-design/lynx-css

Lynx Chip은 별도 ui:chip snippet 없이 @seed-design/lynx-react 패키지에서 직접 제공합니다.

Props

Chip.Button

Prop

Type

disabled?boolean | undefined

Chip.Toggle

Prop

Type

onCheckedChange?((checked: boolean) => void) | undefined
disabled?boolean | undefined

Chip.RadioRoot

Prop

Type

onValueChange?((value: string) => void) | undefined

Chip.RadioItem

Prop

Type

valuestring
disabled?boolean | undefined

Slots

슬롯은 고유 prop이 없습니다. className, style, children을 받습니다.

Examples

Sizes

Small

Lynx 예제를 불러오는 중입니다.

Medium

Lynx 예제를 불러오는 중입니다.

Large

Lynx 예제를 불러오는 중입니다.

Variants

Solid

Lynx 예제를 불러오는 중입니다.

Outline Strong

Lynx 예제를 불러오는 중입니다.

Outline Weak

Lynx 예제를 불러오는 중입니다.

Prefix Icon

Lynx 예제를 불러오는 중입니다.

Suffix Icon

Lynx 예제를 불러오는 중입니다.

Icon Only

layout="iconOnly"에서는 Icon 자식과 accessibility-label을 함께 전달합니다.

Lynx 예제를 불러오는 중입니다.

Prefix Avatar

Avatar와 함께 사용할 수 있습니다.

Lynx 예제를 불러오는 중입니다.

Listening to Value Changes

Chip.Toggle은 onCheckedChange, Chip.RadioRoot는 onValueChange로 선택 값 변경을 알립니다.

Lynx 예제를 불러오는 중입니다.

Glass Effect

glassEffect로 iOS Liquid Glass를 적용합니다. style은 glass 재질("regular"·"clear")을, interactive는 glass가 터치에 직접 반응할지를 정합니다. glass일 때는 현재 상태의 배경색이 glass tint가 되고, 테두리를 그리지 않습니다.

Lynx 예제를 불러오는 중입니다.

Liquid Glass는 실험적인 구현입니다. 앱 root SeedProvider에 supportsLiquidGlass를 넘겨야 활성화되며, 지금은 iOS 26 이상에서만 그립니다. 활성화 방법과 제약은 Host Integration을 참고하세요. 이 예제는 미리보기를 위해 예제 안에서만 supportsLiquidGlass를 켭니다.

이전 버전에서 옮기기

  • Chip.Root·ChipRoot(Props 타입 포함)를 제거했습니다. React와 같이 Chip.Button·ChipButton을 사용하세요. 동작과 스타일은 같습니다.
  • Chip.Toggle의 기본 accessibility-role-description이 "toggle"에서 "checkbox"로 바뀌었습니다. 이전 값이 필요하면 accessibility-role-description을 직접 전달하세요.
  • Chip.RadioRoot는 radiogroup 역할을 전달하지만 기본적으로 접근성 요소가 아닌 컨테이너입니다. 각 Chip.RadioItem이 독립된 접근성 요소로 노출됩니다. disabled이면 accessibility-traits 기본값은 "disabled"입니다.
  • Chip.Toggle과 Chip.RadioItem의 bindtap이 선택 상태를 바꾸기 전에 호출됩니다. tap handler에서 바뀐 선택 값을 읽던 코드는 onCheckedChange나 Chip.RadioRoot의 onValueChange로 옮기세요.

웹 버전과의 차이

  • 탭 이벤트는 onClick 대신 bindtap으로 받습니다. 선택 변경은 onCheckedChange 또는 onValueChange로 확인합니다.
  • 접근성 역할과 상태는 Lynx의 accessibility-role-description, accessibility-value, accessibility-traits로 전달합니다.
  • 문자열 label을 파악할 수 없는 구성에는 accessibility-label을 지정하세요.
  • Lynx Chip은 별도 Registry snippet 없이 @seed-design/lynx-react에서 제공합니다.

Lynx 미지원 기능

  • HiddenInput과 HTML form 속성
  • Chip.Toggle의 indeterminate
  • Chip.RadioRoot의 invalid
  • 키보드 focus와 focusVisible
  • asChild

Last updated on

목차