xiaolin/react-image-gallery
React Image Gallery
This project is a responsive image gallery and carousel component for React. It provides a sliding interface for displaying images and mixed media, such as embedded videos and iframes, within a single navigational sequence.
The gallery supports automated playback with manual play and pause controls, and it adapts its layout for different screen sizes. It includes a fullscreen display mode using native browser implementations and allows for custom slide content rendering via render props.
Navigation is handled through touch swipe gestures, keyboard arrow inputs, and direct thumbnail selection. The component supports both horizontal and vertical layout orientations, including right-to-left language layouts, and enables visual theme modifications through CSS custom properties.
Features
- Image Carousels - Provides a responsive image carousel with touch gesture support and navigation bullets.
- Responsive Sliders - Provides a responsive sliding gallery that automatically adjusts layout and asset scaling based on screen size.
- Carousel Components - Provides a carousel component for cycling through images or custom content with automated playback.
- Configurable Slideshows - Provides a configurable slideshow with autoplay and manual playback controls.
- Gallery Display Modes - Ships a media gallery with multiple display modes and a thumbnail strip for quick navigation.
- Image Carousels - Implements a responsive image carousel with integrated thumbnails and captions.
- Image Galleries - Implements a responsive image gallery with thumbnail navigation and touch-based controls.
- Keyboard Navigation - Implements keyboard-driven interface interaction and shortcuts for seamless navigation between gallery slides.
- Media Galleries - Offers a media gallery supporting a sequence of images, videos, and iframes.
- Responsive Layouts - Features gallery layouts that automatically adapt to different screen sizes and device orientations.
- Index-Driven Navigation Engines - Tracks the active slide index to synchronize the viewport, thumbnails, and navigation indicators.
- Touch Navigation Interfaces - Ships a gesture-based navigation interface with native touch swipe-to-advance functionality for mobile users.
- Gesture Coordinate Mapping - Maps touch swipe gestures and keyboard inputs to trigger slide transitions.
- Slide Rich Media Components - Integrates mixed media including images, embedded videos, and iframes within a single gallery.
- Interval Timers - Implements a timer-based interval to automatically advance slides in the gallery.
- Automated Slideshow Controllers - Features automated slideshow controllers that transition between views at regular intervals with manual toggle controls.
- Render Props - Uses the render prop pattern to allow custom HTML or video components within slides.
- Interface Layout Orientations - Supports both horizontal and vertical layout directions, including right-to-left language support.
- Custom Content Rendering - Enables the injection of arbitrary React components, such as iframes and videos, into gallery slides.
- Thumbnail Navigation Systems - Implements a thumbnail navigation system that allows users to jump directly to specific slides via image previews.
- Timer Control - Provides timer controls to manage the automated playback state and transition intervals of the gallery.
- Native Fullscreen Toggles - Uses the native browser Fullscreen API to expand the gallery to fill the screen.
- Image and Gallery - Responsive image carousel and slider.
