Lightbox

React

Responsive lightbox built with the latest Bootstrap 5. Lightbox is a responsive gallery with the option to enlarge selected photos.

MDB lightbox is a group of images combined in one responsive gallery. Elements are grouped in a thumbnail grid, which can be displayed as a slideshow.

Note: Read the API tab to find all available options and advanced customization


Basic example

A basic example of a lightbox with the most common use case with the bootstrap grid.


Image optimization

To ensure the proper performance of the page, it is recommended to include thumbnails of images in the src attribute. Then in the fullscreenSrc property add the path to the image with higher resolution. If the fullscreenSrc property is omitted, the lightbox will display the same image as in the reduced size.


Shadows and rounded corners

You can improve the look of the images by adding shadows and rounded corners.


Different sizes

Loaded images can have any aspect ratio. Their size will be automatically adjusted to the window when you open the lightbox.


Zoom level

The zoomLevel property allows you to define the size of a single zoom in / zoom out.


Disabled image

By adding a disabled property to any MDBLightboxItem, you can exclude it from your lightbox. In the example below, the third image has been disabled.


Captions

Image captions can be added using the caption property. If it is not set, the data is taken from the alt property. When you want to disable caption, leave the caption empty.


Outside access

Lightbox - API


Import


        import { MDBBadge } from 'mdb-react-ui-kit';
      

Properties

MDBLightbox

Name Type Default Description Example
tag String 'span' Defines tag of the MDBLightbox element <MDBLightbox tag="section" />
className String '' Add custom class to MDBLightbox <MDBLightbox className="class" />
lightboxRef Reference '' A reference to the MDBLightbox <MDBLightbox lightboxRef={customRef} />

MDBLightboxItem

Name Type Default Description Example
className String '' Add custom class to MDBLightboxItem <MDBLightboxItem className="class" />
src String '' Defines a thumbnail source for the item <MDBLightboxItem src="..." />
fullscreenSrc String '' Defines a fullscreen source for the item <MDBLightboxItem fullscreenSrc="..." />
disabled Boolean '' Creates a disabled image in the lightbox <MDBLightboxItem disabled />