Gallery
Last updated
Last updated
Displays images for the Gallery field type (e.g. ACF Gallery field).
In the Basic version, if you add a Gallery field to your View it will display the list of images in the default layout. In the Pro version youβll be able to change the Gallery Layout to Masonry plus the option to enable the Lightbox with slider options.
Note: For the Masonry Gallery Layout to work youβd need to ensure that the Return Format is set to Image Array or Image ID. Choosing the Image URL doesnβt provide the necessary image dimensions.
Edit or add a new View.
Select the Group containing the gallery field.
Select the Gallery field from the Field dropdown, and select the Image Size.
The CSS grid feature is the simplest way to display Gallery items as a grid.
The example code below shows how to set this up. Change '2'
to your desired of columns in the grid-template-columns rule, and adjust the gap, which controls the space between items, from 20px
to your preferred value:
Twig template:
CSS code:
From the Gallery layout dropdown, select the Classic or Flat masonry option and press the Update button.
The Classic masonry employs the Macy.js, while Flat uses a Flat Masonry script from Lightsource.
Pro tip: You can apply both Masonry and Lightbox to the same gallery field simultaneously to provide a visually appealing preview and allow for a detailed view on click.
After saving, switch to the CSS & JS tab, and optionally fune-tune the instance settings:
In the Masonry instance settings, you can fine-tune the number of columns, the gap between items (margin), and the responsive behavior. Check the Macy.js documentation to learn more.
The flat masonry is a simple script, which offers only the basic settings, including gap between items and min-row height:
From the Gallery layout dropdown, select the Inline-Gallery option and press the Update button.
The Inline-Gallery option employs the Carousel feature of the LightGallery library.
After saving, switch to the CSS & JS tab, and optionally fune-tune the instance settings:
From the Enable slider dropdown, select the Splide option and press the Update button. This option employs the Splide library, and have the following defaults:
Lightbox shows a zoom icon on image hover and allows readers to click and open an image in full-screen mode and switch between items if there are others.
Pro tip: You can apply both Masonry and Lightbox to the same gallery field simultaneously to provide a visually appealing preview and allow for a detailed view on click.
From the Enable lightbox dropdown, select the LightGallery or Simple (no settings) option and press the Update button. The LightGallery option employs the LightGallery library, and have the following defaults: