Lynx

Accordion

관련된 정보 섹션을 접고 펼쳐 화면을 간결하게 구성하는 컴포넌트입니다.

Engine ≥ 3.6
사용 가능 버전@seed-design/[email protected], @seed-design/[email protected]
Lynx 예제를 불러오는 중입니다.

Installation

npx @seed-design/cli@latest add ui:accordion

Props

Accordion

Prop

Type

values?string[] | undefined
defaultValues?string[] | undefined
onValuesChange?((values: string[]) => void) | undefined
disabled?boolean | undefined
multiple?boolean | undefined

AccordionItem

Prop

Type

valuestring
disabled?boolean | undefined

AccordionTrigger

Prop

Type

titleReact.ReactNode
description?React.ReactNode
prefix?React.ReactNode
suffixIcon?React.ReactElement<LynxIconElementProps, string | React.JSXElementConstructor<any>> | undefined
expandedAccessibilityValue?string | undefined
collapsedAccessibilityValue?string | undefined

AccordionContent

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

Examples

Inline Variant

기본 inline variant는 항목 사이에 구분선을 표시합니다.

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

Separated

variant="separated"를 사용하면 각 항목이 분리된 카드로 표시됩니다.

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

Multiple

기본적으로 한 항목만 펼칠 수 있습니다. multiple을 사용하면 여러 항목을 함께 펼칠 수 있습니다.

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

Always one open

빈 배열은 무시하도록 onValuesChange를 처리하면 항상 한 항목을 열어 둘 수 있습니다.

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

Size

Lynx에서는 medium과 large를 지원하며 기본값은 medium입니다.

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

Prefix

prefix에 아이콘 같은 앞쪽 요소를 전달할 수 있습니다.

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

Description

description으로 트리거에 설명을 추가할 수 있습니다.

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

Disabled

전체를 비활성화하려면 Accordion, 한 항목만 비활성화하려면 AccordionItem에 disabled를 설정합니다.

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

Controlled

values와 onValuesChange로 열림 상태를 제어할 수 있습니다.

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

Value Array Changes

트리거를 누르면 현재 values와 최근 onValuesChange 값을 표시합니다.

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

Default Expanded

defaultValues로 처음 펼칠 항목을 지정할 수 있습니다.

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

Custom Content

AccordionContent는 콘텐츠 스타일을 제공하지 않습니다. 내부 콘텐츠에 패딩, 배경, 타이포그래피를 지정합니다.

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

Web Version Differences

Lynx Accordion은 네이티브 탭 이벤트와 접근성 속성을 사용합니다.

AccordionTrigger의 title이 문자열이 아니면 accessibility-label을 직접 지정합니다.

Unsupported Lynx Features

기능설명
asChildasChild 기반 요소 교체를 지원하지 않습니다.
headingLevelheading level을 지정할 수 없습니다.
DOM ARIA 연결aria-controls, aria-labelledby, role="region"을 지원하지 않습니다.
Arrow / Home / End 키 탐색웹과 같은 키보드 포커스 이동을 지원하지 않습니다.
size="responsive"medium 또는 large를 사용합니다.

Last updated on

목차