ImageList

Container for multiple Image child components with various display modes (grid, carousel, flex, etc.)

Required Props: idSupports Children: Image

Structure

All styling goes in props.className as a single Tailwind utility string. Non-class props (text, src, alt, etc.) stay on their own keys. root.animation for scroll effects.

Properties

PropertyTypeDescriptionExamples
modestring
grid | carousel | hero | masonry | infinite | flex
Display mode for images
Default: "flex"
grid
itemsPerViewnumber
Number of items visible at once (for carousel/grid)
Default: 3
-
flexDirectionstring
Flex layout direction
Default: "flex-row"
flex-col
alignItemsstring
Vertical alignment
Default: "items-center"
-
justifyContentstring
Horizontal alignment
Default: "justify-start"
-
gapstring
Space between images
Default: "gap-2"
gap-4
autoScrollbooleanstring
Carousel auto-advance
Default: false
-
autoScrollIntervalnumber
Milliseconds between slides
Default: 3000
-
infiniteSpeednumber
Marquee speed for infinite mode
Default: 30
-
infiniteDirectionstring
left | right
-
Default: "left"
-
animationEnabledbooleanstring
-
Default: true
-
previewInEditorbooleanstring
-
Default: false
-
showNavigationbooleanstring
-
Default: true
-
showDotsbooleanstring
-
Default: true
-
canDeleteboolean
-
Default: true
-
canEditNameboolean
-
Default: true
-
customobject
-
-
classNamestring
Tailwind utility classes string. Mobile-first: unprefixed = base, md: = 768px+, sm: = 640px+, lg: = 1024px+. Includes layout, spacing, surface design, and typography.
flex flex-col gap-space-sm py-space-lg px-container-x md:flex-rowbg-primary text-primary-content rounded-box py-3.5 px-6 font-semibold
rootobject
-
-