Svelte Gallery (Mansonry) - Flowbite
Use the image gallery component based on a masonry grid layout using flex and grid classes from Tailwind CSS to show multiple pictures based on various styles
The gallery component can be used to show multiple images inside a masonry grid layout styles with the utility-first classes from Tailwind CSS to show a collection of pictures to your users based on various layouts, styles, sizes, and colors.
This component is recommended for usage within marketing UI interfaces and website sections when you want to show pictures of your team members, office pictures, or even case study images.
Set up #
Import Gallery
in the script tag.
- Svelte
<script>
import { Gallery } from 'flowbite-svelte';
</script>
Default gallery #
Use this component to show a collection of images inside a gallery.
Number of rows in the gallery is set by passing the grid-cols-{n}
Tailwind class (including the reactive prefix).
Spacing between images is set by gap-{n}
class. If you don’t set them it behaves like grid-cols-1
and gap:inherit
.
Example below show a gallery with three pictures on a row.
- Svelte
<script>
import { Gallery } from "flowbite-svelte";
const images = [
{alt: 'erbology', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image.jpg'},
{alt: 'shoes', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-1.jpg'},
{alt: 'small bag', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-2.jpg'},
{alt: 'plants', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-3.jpg'},
{alt: 'watch', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-4.jpg'},
{alt: 'shoe', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-5.jpg'},
{alt: 'cream', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-6.jpg'},
{alt: 'small bag', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-7.jpg'},
{alt: 'lamp', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-8.jpg'},
{alt: 'toiletbag', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-9.jpg'},
{alt: 'playstation', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-10.jpg'},
{alt: 'bag', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-11.jpg'}
]
</script>
<Gallery items={images} class="gap-4 grid-cols-2 md:grid-cols-3" />
Masonry grid #
This example can be used to show the images inside a masongry grid layouts with four columns.
- Svelte
<script>
import { Gallery } from "flowbite-svelte";
const images1 = [
{alt: 'erbology', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/masonry/image.jpg'},
{alt: 'shoes', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/masonry/image-1.jpg'},
{alt: 'small bag', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/masonry/image-2.jpg'},
]
const images2 = [
{alt: 'plants', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/masonry/image-3.jpg'},
{alt: 'watch', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/masonry/image-4.jpg'},
{alt: 'shoe', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/masonry/image-5.jpg'},
]
const images3 = [
{alt: 'cream', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/masonry/image-6.jpg'},
{alt: 'small bag', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/masonry/image-7.jpg'},
{alt: 'lamp', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/masonry/image-8.jpg'},
]
const images4 = [
{alt: 'toiletbag', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/masonry/image-9.jpg'},
{alt: 'playstation', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/masonry/image-10.jpg'},
{alt: 'bag', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/masonry/image-11.jpg'}
]
</script>
<Gallery class="gap-4 grid-cols-2 md:grid-cols-4">
<Gallery items={images1} />
<Gallery items={images2} />
<Gallery items={images3} />
<Gallery items={images4} />
</Gallery>
Featured image #
This example can be used to feature the most important image and show a row of five pictures below.
- Svelte
<script>
import { Gallery } from "flowbite-svelte";
const image1 = {alt: 'erbology', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/featured/image.jpg'}
const images2 = [
{alt: 'shoes', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-1.jpg'},
{alt: 'small bag', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-2.jpg'},
{alt: 'plants', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-3.jpg'},
{alt: 'watch', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-4.jpg'},
{alt: 'shoe', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-5.jpg'},
]
</script>
<Gallery class="gap-4">
<img src={image1.src} alt={image1.alt} class="h-auto max-w-full rounded-lg" />
<Gallery class="grid-cols-5" items={images2} />
</Gallery>
Quad gallery #
Use this example to show four larger images with two items on a row.
- Svelte
<script>
import { Gallery } from "flowbite-svelte";
const images = [
{alt: 'shoes', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-1.jpg'},
{alt: 'small bag', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-2.jpg'},
{alt: 'plants', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-3.jpg'},
{alt: 'watch', src: 'https://flowbite.s3.amazonaws.com/docs/gallery/square/image-4.jpg'}
]
</script>
<Gallery class="gap-2 grid-cols-2" items={images} />
Gallery with slider #
This example uses the carousel slider functionality to show multiple images inside a slider gallery.
- Svelte
<script>
import { CarouselTransition } from 'flowbite-svelte'
let showThumbs=false
let showCaptions=false
let showIndicators=false
const images = [
{id: 0, attribution: 'shoes', imgurl: '/images/carousel/cosmic-timetraveler-pYyOZ8q7AII-unsplash.webp'},
{id: 1, attribution: 'small bag', imgurl: '/images/carousel/cristina-gottardi-CSpjU6hYo_0-unsplash.webp'},
{id: 2, attribution: 'plants', imgurl: '/images/carousel/johannes-plenio-RwHv7LgeC7s-unsplash.webp'},
{id: 3, attribution: 'watch', imgurl: '/images/carousel/jonatan-pie-3l3RwQdHRHg-unsplash.webp'},
{id: 4, attribution: 'watch', imgurl: '/images/carousel/mark-harpur-K2s_YE031CA-unsplash.webp'}
]
</script>
<div class="max-w-4xl">
<CarouselTransition {images} loop {showThumbs} {showCaptions} {showIndicators} transitionType="fly" transitionParams="{{delay: 250, duration: 300, x: 100}}"/>
</div>
Gallery with tag filters #
Use this example to show a list of tags and filter the images below based on the activately selected tag.
- Svelte
<div class="flex items-center justify-center py-4 md:py-8 flex-wrap gap-3 mb-3 mx-auto">
<Button pill size="xl" outline>All categories</Button>
<Button pill size="xl" color="alternative">Shoes</Button>
<Button pill size="xl" color="alternative">Bags</Button>
<Button pill size="xl" color="alternative">Electronics</Button>
<Button pill size="xl" color="alternative">Gaming</Button>
</div>
<Gallery items={images} class="gap-4 grid-cols-2 md:grid-cols-3" />
Heterogeneous gallery #
Gallery items don’t have to be all the same but then you need to list them manually - don’t set the items
property.
- Svelte
<Gallery class="gap-4 grid-cols-2">
<img src="https://flowbite.s3.amazonaws.com/docs/gallery/square/image-1.jpg" alt="shoas" class="h-auto max-w- rounded-lg" />
<div class="h-auto max-w- rounded-lg flex items-center justify-center text-6xl font-extrabold bg-red-300" >Sale</div>
<div class="h-auto max-w- rounded-lg flex items-center justify-center text-6xl font-extrabold bg-blue-300" >Sale</div>
<img alt="plants" src='https://flowbite.s3.amazonaws.com/docs/gallery/square/image-3.jpg' class="h-auto max-w- rounded-lg" />
</Gallery>
Custom image rendering #
This example shows how to get a complete control over the gallery images look and feel.
- Svelte
<Gallery class="gap-4 grid-cols-3" items={images} let:item>
<div class="ring-4 ring-red-600 dark:ring-red-400 p-1">
<img src={item.src} alt={item.alt} class="h-auto max-w-full" />
</div>
</Gallery>
Props #
The component has the following props, type, and default values. See types page for type information.
Gallery #
Name | Type | Default |
---|---|---|
items | ImgType[] | [] |