React 아코디언 개요

    Ignite UI for React 클릭 가능한 헤더와 연관된 콘텐츠 섹션이 있는 수직 확장 패널을 구축하기 위한 GUI 구성 요소로, 단일 컨테이너에 표시됩니다. 아코디언은 일반적으로 단일 페이지에서 여러 콘텐츠 섹션을 스크롤할 필요성을 줄이는 데 사용됩니다. 키보드 탐색 및 기본 패널의 확장 상태를 제어하는 API를 제공합니다.

    사용자는 썸네일이나 라벨과 같은 항목 목록 간에 상호 작용하고 탐색할 수 있습니다. 포함된 정보를 표시하기 위해 각 항목을 전환(확장 또는 축소)할 수 있습니다. 구성에 따라 한 번에 하나 또는 여러 개의 확장된 항목이 있을 수 있습니다.

    React Accordion Example

    다음은 FAQ 섹션의 기본 Ignite UI for React Accordion 예입니다. 개별적으로 작동하는 섹션이 있는 아코디언으로 작동합니다. 여러 패널을 동시에 확장하는 동안 한 번의 클릭으로 각 텍스트 블록을 토글할 수 있습니다. 이렇게 하면 이전에 열었던 섹션을 매번 숨기는 자동 확장 및 축소 패널 사이를 오가며 이동하지 않고도 정보를 더 쉽게 읽을 수 있습니다.

    이 책에서는 아코디언과 그 확장 패널을 어떻게 정의하는지 볼 수 있습니다. 샘플은 또한 두 가지 유형의 팽창 행동을 보여줍니다. 스위치 버튼은 한 번에 확장할 단일 분기와 여러 가지를 토글하도록 속성을 설정합니다singleExpand.

    Getting Started with React Accordion

    먼저, 다음 명령을 실행하여 Ignite UI for React 설치해야 합니다.

    npm install igniteui-react

    그 다음에는 와 ,IgrAccordion 그리고 필요한 CSS를 이렇게 가져오IgrExpansionPanel 면 됩니다:

    import {
  IgrAccordion,
  IgrExpansionPanel,
} from "igniteui-react";
import "igniteui-webcomponents/themes/light/bootstrap.css";

    이제 기본 구성IgrAccordion부터 시작할 수 있습니다.

    Usage

    React 아코디언 컴포넌트의 각 섹션은 React 확장 패널을 사용하여 정의됩니다. 패널은 필요에 따라 패널 상태를 설정할 수 있는 기능을 제공합니다Disabled​Open.

    Declaring an Accordion

    아코디언은 그 안에 선언 된 모든 확장 패널을 감쌉니다.

    <IgrAccordion singleExpand={true}>
  <IgrExpansionPanel>
    <div slot="title">Title Panel 1</div>
    <div>Content Panel 1</div>
  </IgrExpansionPanel>
  <IgrExpansionPanel>
    <div slot="title">Title Panel 2</div>
    <div>Content Panel 2</div>
  </IgrExpansionPanel>
</IgrAccordion>

    위에서 보았듯이, 이 속성은singleExpand 한 번에 단일 패널 또는 여러 패널을 확장할 수 있는지 설정할 수 있는 기능을 제공합니다.

    와hideAll 메서드showAll를 사용하면 각각 모든IgrExpansionPanel s를IgrAccordion 프로그램적으로 압축하거나 확장할 수 있습니다.

    [!Note] If singleExpand property is set to true calling showAll method would expand only the focused panel.

    React Accordion Customization Example

    React Accordion을 사용하면 헤더와 콘텐츠 패널의 모양을 사용자 지정할 수 있습니다.

    아래 샘플은 내장된 슬롯IgrExpansionPanel을 사용하여 정교한 필터링 옵션을 구현하는 방법을 보여줍니다.

    Nested React Accordions Scenario

    다음 React 에서는 아코디언 예제를 설명하기 위해 복잡한 FAQ 섹션을 만들었으며, 이는 이러한 일반적인 적용 시나리오를 어떻게 진행할 수 있는지 보여줍니다. 샘플 내에는 확장 패널 안에 아코디언을 추가하여 중첩을IgrAccordion 만듭니다.

    Keyboard Navigation

    React Accordion의 키보드 탐색은 최종 사용자에게 다양한 키보드 상호 작용을 제공합니다. 이 기능은 기본적으로 활성화되어 있으며 최종 사용자가 패널을 쉽게 탐색할 수 있습니다.

    Accordion 탐색은 W3C 접근성 표준을 준수하며 사용이 편리합니다.

    주요 조합

    • ↓- 포커스를 아래 패널로 이동합니다.
    • ↑- 포커스를 위 패널로 이동합니다.
    • ALT + ↓- 아코디언에서 포커스 패널을 엽니다.
    • ALT + ↑- 아코디언에서 포커스가 있는 패널을 닫습니다.
    • SHIFT + ALT + ↓- 활성화된 모든 패널을 엽니다(singleExpand가 true로 설정된 경우 포커스가 있는 패널이 열립니다).
    • SHIFT + ALT + ↑- 활성화된 모든 패널을 닫습니다.
    • HOME- 아코디언의 FIRST 활성화 패널로 이동합니다.
    • END- 아코디언의 LAST 활성화 패널로 이동합니다.

    API References

    Additional Resources