Components/Accordion

Accordion

접이식 콘텐츠 패널 컴포넌트입니다. Radix UI Accordion 기반.

Installation

bash
npx axis-cli add accordion

Usage

tsx
import {
  Accordion,
  AccordionContent,
  AccordionItem,
  AccordionTrigger,
} from '@axis-ds/ui-react'

export function Example() {
  return (
    <Accordion type="single" collapsible className="w-full">
      <AccordionItem value="item-1">
        <AccordionTrigger>AXIS Design System이란?</AccordionTrigger>
        <AccordionContent>
          React 기반 컴포넌트 라이브러리 및 디자인 토큰 시스템입니다.
        </AccordionContent>
      </AccordionItem>
      <AccordionItem value="item-2">
        <AccordionTrigger>어떻게 설치하나요?</AccordionTrigger>
        <AccordionContent>
          pnpm add @axis-ds/ui-react 명령으로 설치할 수 있습니다.
        </AccordionContent>
      </AccordionItem>
      <AccordionItem value="item-3">
        <AccordionTrigger>커스터마이징이 가능한가요?</AccordionTrigger>
        <AccordionContent>
          Tailwind CSS 기반으로 자유롭게 스타일을 커스터마이징할 수 있습니다.
        </AccordionContent>
      </AccordionItem>
    </Accordion>
  )
}

Components

Accordion

아코디언 루트 컨테이너

AccordionItem

개별 아코디언 아이템

AccordionTrigger

아이템 열기/닫기 트리거

AccordionContent

아이템 콘텐츠 영역

Props

type
Type:"single" | "multiple"
Default:"single"

단일/다중 열림 모드

value
Type:string | string[]
Default:-

열린 아이템 값 (controlled)

defaultValue
Type:string | string[]
Default:-

기본 열린 아이템

collapsible
Type:boolean
Default:false

모든 아이템 닫기 허용 (single 모드)

onValueChange
Type:(value: string | string[]) => void
Default:-

값 변경 콜백