npm i react-gm3carousel
bun i react-gm3carousel
...
import { GM3Carousel } from "react-gm3carousel";
// below could be optional, if you're already using TailwindCSS in your project, but you should add it regardless
import "react-gm3carousel/dist/index.css";
Ensure your carousel is wrapped in an element with set width/height otherwise it ain't gonna show.
<div style={{ width: 600, height: 240, background: "red" }}>
<GM3Carousel
perPage={4}
speedS={2}
slides={DATA.map((d, idx) => ({
content: <p>Slide {idx}</p>,
key: d.id,
}))}
/>
</div>
{
// vertical vs horizontal carousel
isVertical?: boolean;
// wrapper class name
className?: string;
// what to render inside each slide
slides: { content: ReactNode; key: string }[];
speedS: number;
// how moany slide to render per page
perPage: number;
// will have 4 small previews vs 2
withDualSmallItems?: boolean;
// class name for wrapper of small items
smallItemClassName?: string;
// class name for wrapper of large items
bigItemClassName?: string;
// auto scroll pause
isPaused?: boolean;
pauseOnMouseEnter?: boolean;
slideWrapperClassName?: string;
}
You can target active slides with the blow selector
[data-active="true"] {}
You can set a gap either by
gap={16}
or through class names (notice first/last child margins match the gap)
gap-2 [&>*:last-child]:-ml-2 [&>*:first-child]:-mr-2
The number of slideItems should be > than the perPage + 2, otherwise the transition animations might not work properly as there will be duplicate render issues due to React and how it might mess up tracking these items since the key will be duplicated.
More about the official spec: