React Gallery - Overview

The Gallery is a UI component that displays a collection of images in a carousel. The component is supplied with various navigation controls that allow a user to switch between images.

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 Gallery features used.

TS JS

Backend API

import React, { useCallback, useState } from 'react'; import CheckBox from 'devextreme-react/check-box'; import type { CheckBoxTypes } from 'devextreme-react/check-box'; import Gallery from 'devextreme-react/gallery'; import { gallery } from './data.ts'; const App = () => { const [loop, setLoop] = useState(true); const [slideShow, setSlideShow] = useState(true); const [showNavButtons, setShowNavButtons] = useState(true); const [showIndicator, setShowIndicator] = useState(true); const onLoopChanged = useCallback((data: CheckBoxTypes.ValueChangedEvent) => { setLoop(data.value); }, []); const onSlideShowChanged = useCallback((data: CheckBoxTypes.ValueChangedEvent) => { setSlideShow(data.value); }, []); const onShowNavButtonsChanged = useCallback((data: CheckBoxTypes.ValueChangedEvent) => { setShowNavButtons(data.value); }, []); const onShowIndicatorChanged = useCallback((data: CheckBoxTypes.ValueChangedEvent) => { setShowIndicator(data.value); }, []); return ( <div> <div className="widget-container"> <Gallery id="gallery" dataSource={gallery} height={300} slideshowDelay={slideShow ? 2000 : 0} loop={loop} showNavButtons={showNavButtons} showIndicator={showIndicator} /> </div> <div className="options"> <div className="caption">Options</div> <div className="option"> <CheckBox text="Loop mode" value={loop} onValueChanged={onLoopChanged} /> </div> <div className="option"> <CheckBox text="Slide show" value={slideShow} onValueChanged={onSlideShowChanged} /> </div> <div className="option"> <CheckBox text="Navigation buttons" value={showNavButtons} onValueChanged={onShowNavButtonsChanged} /> </div> <div className="option"> <CheckBox text="Indicator" value={showIndicator} onValueChanged={onShowIndicatorChanged} /> </div> </div> </div> ); }; export default App;

import React, { useCallback, useState } from 'react'; import CheckBox from 'devextreme-react/check-box'; import Gallery from 'devextreme-react/gallery'; import { gallery } from './data.js'; const App = () => { const [loop, setLoop] = useState(true); const [slideShow, setSlideShow] = useState(true); const [showNavButtons, setShowNavButtons] = useState(true); const [showIndicator, setShowIndicator] = useState(true); const onLoopChanged = useCallback((data) => { setLoop(data.value); }, []); const onSlideShowChanged = useCallback((data) => { setSlideShow(data.value); }, []); const onShowNavButtonsChanged = useCallback((data) => { setShowNavButtons(data.value); }, []); const onShowIndicatorChanged = useCallback((data) => { setShowIndicator(data.value); }, []); return ( <div> <div className="widget-container"> <Gallery id="gallery" dataSource={gallery} height={300} slideshowDelay={slideShow ? 2000 : 0} loop={loop} showNavButtons={showNavButtons} showIndicator={showIndicator} /> </div> <div className="options"> <div className="caption">Options</div> <div className="option"> <CheckBox text="Loop mode" value={loop} onValueChanged={onLoopChanged} /> </div> <div className="option"> <CheckBox text="Slide show" value={slideShow} onValueChanged={onSlideShowChanged} /> </div> <div className="option"> <CheckBox text="Navigation buttons" value={showNavButtons} onValueChanged={onShowNavButtonsChanged} /> </div> <div className="option"> <CheckBox text="Indicator" value={showIndicator} onValueChanged={onShowIndicatorChanged} /> </div> </div> </div> ); }; export default App;

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

import type { IItemProps } from 'devextreme-react/gallery'; export const gallery: IItemProps[] = [ { imageAlt: 'Image 1', imageSrc: '../../../../images/gallery/1.jpg', }, { imageAlt: 'Image 2', imageSrc: '../../../../images/gallery/2.jpg', }, { imageAlt: 'Image 3', imageSrc: '../../../../images/gallery/3.jpg', }, { imageAlt: 'Image 4', imageSrc: '../../../../images/gallery/4.jpg', }, { imageAlt: 'Image 5', imageSrc: '../../../../images/gallery/5.jpg', }, { imageAlt: 'Image 6', imageSrc: '../../../../images/gallery/6.jpg', }, { imageAlt: 'Image 7', imageSrc: '../../../../images/gallery/7.jpg', }, { imageAlt: 'Image 8', imageSrc: '../../../../images/gallery/8.jpg', }, { imageAlt: 'Image 9', imageSrc: '../../../../images/gallery/9.jpg', }, ];

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

export const gallery = [ { imageAlt: 'Image 1', imageSrc: '../../../../images/gallery/1.jpg', }, { imageAlt: 'Image 2', imageSrc: '../../../../images/gallery/2.jpg', }, { imageAlt: 'Image 3', imageSrc: '../../../../images/gallery/3.jpg', }, { imageAlt: 'Image 4', imageSrc: '../../../../images/gallery/4.jpg', }, { imageAlt: 'Image 5', imageSrc: '../../../../images/gallery/5.jpg', }, { imageAlt: 'Image 6', imageSrc: '../../../../images/gallery/6.jpg', }, { imageAlt: 'Image 7', imageSrc: '../../../../images/gallery/7.jpg', }, { imageAlt: 'Image 8', imageSrc: '../../../../images/gallery/8.jpg', }, { imageAlt: 'Image 9', imageSrc: '../../../../images/gallery/9.jpg', }, ];

<!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/26.1.5/css/dx.light.css" /> <link rel="stylesheet" type="text/css" href="./bundle.css" /> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="app"></div> </div> <script src="bundles/vendor/react.vendor.js"></script> <script src="./bundle.js"></script> </body> </html>

.widget-container { margin-right: 240px; } #gallery { margin: auto; max-width: 450px; } .options { padding: 20px; position: absolute; bottom: 0; right: 0; width: 180px; top: 0; background-color: rgba(191, 191, 191, 0.15); } .caption { font-size: 18px; font-weight: 500; } .option { margin-top: 10px; }