Google Material Design v3 Carousel for React!

Preview

Usage instructions

Step 1. install (npm/bun)

npm i react-gm3carousel
bun i react-gm3carousel
...

Step 2. import

 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";

Step 3. Use the carousel properly

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>

Props

{
	// 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;
}

Notes

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

Important

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.

Learn more

More about the official spec:

https://m3.material.io/components/carousel/specs