React Accordion

The Accordion component contains several panels displayed one under another. Users can expand or collapse these panels, which makes this component useful to present information in a limited amount of space.

DevExtreme Accessibility Compliance

DevExtreme component libraries meet a variety of WCAG and Section 508 compliance standards. To assess this demo's accessibility level, click the Run AXE^® Validation button to launch the AXE^® web accessibility evaluation tool.

All trademarks or registered trademarks are property of their respective owners. AXE^® Terms of Use

The overall accessibility level of your application depends on the Accordion features used.

TS JS

Backend API

import React, { useCallback, useState } from 'react'; import Accordion, { type AccordionTypes } from 'devextreme-react/accordion'; import CheckBox, { type CheckBoxTypes } from 'devextreme-react/check-box'; import TagBox, { type TagBoxTypes } from 'devextreme-react/tag-box'; import Slider, { Tooltip, Label, type SliderTypes } from 'devextreme-react/slider'; import service from './data.ts'; import CustomTitle from './CustomTitle.tsx'; import CustomItem from './CustomItem.tsx'; const companyLabel = { 'aria-label': 'Company' }; const companies = service.getCompanies(); const App = () => { const [selectedItems, setSelectedItems] = useState([companies[0]]); const [multiple, setMultiple] = useState(false); const [collapsible, setCollapsible] = useState(false); const [animationDuration, setAnimationDuration] = useState(300); const selectionChanged = useCallback((e: AccordionTypes.SelectionChangedEvent) => { let newItems = [...selectedItems]; e.removedItems.forEach((item) => { const index = newItems.indexOf(item); if (index >= 0) { newItems.splice(index, 1); } }); if (e.addedItems.length) { newItems = [...newItems, ...e.addedItems]; } setSelectedItems(newItems); }, [selectedItems, setSelectedItems]); const selectedItemsChanged = useCallback((e: TagBoxTypes.ValueChangedEvent) => { setSelectedItems(e.value); }, [setSelectedItems]); const multipleChanged = useCallback((e: CheckBoxTypes.ValueChangedEvent) => { setMultiple(e.value); }, [setMultiple]); const collapsibleChanged = useCallback((e: CheckBoxTypes.ValueChangedEvent) => { setCollapsible(e.value); }, [setCollapsible]); const animationDurationChanged = useCallback((e: SliderTypes.ValueChangedEvent) => { setAnimationDuration(e.value); }, [setAnimationDuration]); return ( <div id="accordion"> <Accordion dataSource={companies} collapsible={collapsible} multiple={multiple} animationDuration={animationDuration} selectedItems={selectedItems} onSelectionChanged={selectionChanged} itemTitleRender={CustomTitle} itemRender={CustomItem} id="accordion-container" /> <div className="options"> <div className="caption">Options</div> <div className="option"> <CheckBox text="Multiple enabled" value={multiple} onValueChanged={multipleChanged} /> </div> <div className="option"> <CheckBox text="Collapsible enabled" value={collapsible} onValueChanged={collapsibleChanged} /> </div> <div className="option"> <span>Animation duration</span> <Slider min={0} max={1000} value={animationDuration} onValueChanged={animationDurationChanged} > <Tooltip enabled={true} position="bottom" /> <Label visible={true} /> </Slider> </div> <div className="option"> <span className="caption">Selected Items</span> <TagBox dataSource={companies} displayExpr="CompanyName" value={selectedItems} inputAttr={companyLabel} onValueChanged={selectedItemsChanged} disabled={!multiple} /> </div> </div> </div> ); }; export default App;

import React, { useCallback, useState } from 'react'; import Accordion from 'devextreme-react/accordion'; import CheckBox from 'devextreme-react/check-box'; import TagBox from 'devextreme-react/tag-box'; import Slider, { Tooltip, Label } from 'devextreme-react/slider'; import service from './data.js'; import CustomTitle from './CustomTitle.js'; import CustomItem from './CustomItem.js'; const companyLabel = { 'aria-label': 'Company' }; const companies = service.getCompanies(); const App = () => { const [selectedItems, setSelectedItems] = useState([companies[0]]); const [multiple, setMultiple] = useState(false); const [collapsible, setCollapsible] = useState(false); const [animationDuration, setAnimationDuration] = useState(300); const selectionChanged = useCallback( (e) => { let newItems = [...selectedItems]; e.removedItems.forEach((item) => { const index = newItems.indexOf(item); if (index >= 0) { newItems.splice(index, 1); } }); if (e.addedItems.length) { newItems = [...newItems, ...e.addedItems]; } setSelectedItems(newItems); }, [selectedItems, setSelectedItems], ); const selectedItemsChanged = useCallback( (e) => { setSelectedItems(e.value); }, [setSelectedItems], ); const multipleChanged = useCallback( (e) => { setMultiple(e.value); }, [setMultiple], ); const collapsibleChanged = useCallback( (e) => { setCollapsible(e.value); }, [setCollapsible], ); const animationDurationChanged = useCallback( (e) => { setAnimationDuration(e.value); }, [setAnimationDuration], ); return ( <div id="accordion"> <Accordion dataSource={companies} collapsible={collapsible} multiple={multiple} animationDuration={animationDuration} selectedItems={selectedItems} onSelectionChanged={selectionChanged} itemTitleRender={CustomTitle} itemRender={CustomItem} id="accordion-container" /> <div className="options"> <div className="caption">Options</div> <div className="option"> <CheckBox text="Multiple enabled" value={multiple} onValueChanged={multipleChanged} /> </div> <div className="option"> <CheckBox text="Collapsible enabled" value={collapsible} onValueChanged={collapsibleChanged} /> </div> <div className="option"> <span>Animation duration</span> <Slider min={0} max={1000} value={animationDuration} onValueChanged={animationDurationChanged} > <Tooltip enabled={true} position="bottom" /> <Label visible={true} /> </Slider> </div> <div className="option"> <span className="caption">Selected Items</span> <TagBox dataSource={companies} displayExpr="CompanyName" value={selectedItems} inputAttr={companyLabel} onValueChanged={selectedItemsChanged} disabled={!multiple} /> </div> </div> </div> ); }; export default App;

import React from 'react'; export default function CustomItem(data) { return ( <div> <div> <p> <b>{data.City} </b> (<span>{data.State}</span>) </p> <p> <span>{data.Zipcode} </span> <span>{data.Address}</span> </p> </div> <div> <p> Phone: <b>{data.Phone}</b> </p> <p> Fax: <b>{data.Fax}</b> </p> <p> Website: <a href={data.Website} target="_blank"> {data.Website} </a> </p> </div> </div> ); }

import React from 'react'; export default function CustomTitle(data) { return ( <div className='header'>{data.CompanyName}</div> ); }

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.tsx'; ReactDOM.render( <App />, document.getElementById('app'), );

import React from 'react'; export default function CustomItem(data) { return ( <div> <div> <p> <b>{data.City} </b>(<span>{data.State}</span>) </p> <p> <span>{data.Zipcode} </span> <span>{data.Address}</span> </p> </div> <div> <p> Phone: <b>{data.Phone}</b> </p> <p> Fax: <b>{data.Fax}</b> </p> <p> Website:{' '} <a href={data.Website} target="_blank" > {data.Website} </a> </p> </div> </div> ); }

import React from 'react'; export default function CustomTitle(data) { return <div className="header">{data.CompanyName}</div>; }

import React from 'react'; import ReactDOM from 'react-dom'; import App from './App.js'; ReactDOM.render(<App />, document.getElementById('app'));

<!DOCTYPE html> <html lang="en"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0" /> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/25.1.7/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="https://cdn.jsdelivr.net/npm/core-js@2.6.12/client/shim.min.js"></script> <script src="https://cdn.jsdelivr.net/npm/systemjs@0.21.3/dist/system.js"></script> <script type="text/javascript" src="config.js"></script> <script type="text/javascript"> System.import("./index.tsx"); </script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> </body> </html>

#accordion { height: 700px; } #accordion .header { font-size: 20px; } #accordion .header, #accordion p { margin: 0; } #accordion-container { margin-right: 400px; } .dx-theme-material #accordion .dx-accordion-item-title { display: flex; } .dx-theme-material #accordion .header { align-self: center; } .options { padding: 20px; position: absolute; bottom: 0; right: 0; width: 340px; top: 0; background-color: rgba(191, 191, 191, 0.15); } .options > .caption { font-weight: 500; font-size: 18px; } .option { margin-top: 10px; } .option > .caption { margin-top: 10px; display: inline-block; } .option > .dx-tagbox { margin-top: 2px; }

Bind Accordion to Data

You can display Accordion items from the items array or a dataSource. If you use the items array, specify the title and text properties.

Configure Item Selection and Collapsibility

Enable the multiple property to allow users to select multiple panels. Use the selectedItems array to store selected items. Toggle the "Multiple enabled" checkbox in the Options demo section to see how it affects the selection.

If you want to allow users to close panels on click, set the collapsible property to true. Check the "Collapsible enabled" checkbox in the Options demo section to enable this feature.

Configure Animation

The animationDuration property allows you to specify the animation duration when users expand/collapse a panel. Use the "Animation duration" slider in the Options demo section to see how it affects the animation.

Customize Item Appearance

Use the itemTemplate and itemTitleTemplate properties to customize the panel appearance. If you use the items array, you can also specify the icon property.