“Setup took an afternoon and the first report landed in my inbox the next morning. I have not opened the old spreadsheet since.”
Un carrousel de témoignages en React, sur scroll snap natif
La section d’avis de tout site marketing : une carte au centre, ses voisines inclinées derrière, des points en dessous, un balayage ou un clic pour passer à la suivante. Les bibliothèques de slider vendent exactement cela. Le navigateur a déjà les deux moitiés — scroll-snap-type pour l’atterrissage et une animation pilotée par le défilement pour l’inclinaison — et cette bibliothèque ajoute la part qui n’est ni l’une ni l’autre : savoir quelle carte est courante.
Balayez, faites glisser ou utilisez les flèches et les points — la rangée se pose sur une carte à chaque fois.
Modifier cet exemple en direct dans Storybook
À quoi sert vraiment ici une bibliothèque de slider
Les carrousels de témoignages sont l’installation canonique de Swiper : trois cartes visibles, celle du milieu plate, des points de pagination, une lecture automatique. Chacun de ces éléments est soit du CSS, soit quelques lignes sur l’API de cette bibliothèque :
- Atterrir sur une carte, c’est
scroll-snap-type: x mandatorysur la rangée etscroll-snap-align: centersur les éléments. Le défilement tactile, à la molette et au clavier reste natif et décélère de lui-même jusqu’à une carte. - L’inclinaison est une animation pilotée par le défilement sur chaque carte, donc l’angle suit la position de défilement pixel par pixel sans rien mesurer en JavaScript. Chromium et Safari 26 la dessinent ; Firefox la garde encore derrière un drapeau et montre des cartes plates, et la règle est protégée par
@supports. - Points et flèches doivent connaître la carte courante :
onScrolltrouve la plus proche du centre de la rangée, etscrollToItem(el, 'smooth', 'center')avance vers une voisine ou saute à la carte d’un point, en atterrissant par construction sur un point d’accrochage.
La seule chose à réussir : le glisser
Un conteneur à accrochage obligatoire accroche chaque écriture programmatique de scrollLeft, donc la recette de glisser à la souris telle quelle sauterait de carte en carte. L’exemple scroll snap montre la correction : couper l’accrochage le temps du geste, glisser jusqu’à la carte la plus proche avec scrollToItem au relâchement, et rendre l’accrochage au CSS une fois ce glissement stabilisé — le réactiver plus tôt saute au lieu de glisser. Le tactile n’a besoin de rien de tout cela ; la rangée est un vrai conteneur de défilement.
Lecture automatique, boucle, et ce qui reste à vous
La lecture automatique est un minuteur appelant le même scrollToItem, en pause au survol, au focus et en mouvement réduit. Une boucle infinie se combine aussi : sa téléportation déplace d’une longueur de boucle entière, soit un nombre entier de points d’accrochage. Les cartes sont vos composants — un avatar, une note, une citation, un logo — et la géométrie tient en trois propriétés personnalisées : largeur de carte, espacement et inclinaison.
Le motif, minimal
L’accrochage et l’inclinaison sont la feuille de style ; les flèches et les points sont une mesure et un scrollToItem. La démo ci-dessus, c’est cela plus les cartes.
function TestimonialCarousel({ reviews }: { reviews: Review[] }) {
const [active, setActive] = React.useState(0);
return (
<ScrollMenu
scrollContainerClassName="snap-rail"
itemClassName="snap-slot"
onScroll={(api) => setActive(nearestIndex(api, reviews))}
LeftArrow={<Arrow id={reviews[active - 1]?.id} />}
RightArrow={<Arrow id={reviews[active + 1]?.id} />}
>
{reviews.map((review) => (
<ReviewCard itemId={review.id} key={review.id} {...review} />
))}
</ScrollMenu>
);
}
// The card whose center is closest to the rail's center.
function nearestIndex(api: publicApiType, reviews: Review[]) {
const rail = api.scrollContainer.current!;
const middle = rail.scrollLeft + rail.clientWidth / 2;
const distances = reviews.map(({ id }) => {
const slot = api.getItemElementById(id) as HTMLElement;
return Math.abs(slot.offsetLeft + slot.offsetWidth / 2 - middle);
});
return distances.indexOf(Math.min(...distances));
}
// Arrows step one card: the neighbour of the centered one, centered.
function Arrow({ id }: { id?: string }) {
const api = React.useContext<publicApiType>(VisibilityContext);
const step = () => {
const el = id && api.getItemElementById(id);
if (el) api.scrollToItem(el, 'smooth', 'center');
};
return <button disabled={!id} onClick={step}>→</button>;
}
/* .snap-rail — the browser lands every swipe on a card:
scroll-snap-type: x mandatory;
padding-inline: calc(50% - var(--card) / 2);
.snap-slot — scroll-snap-align: center;
The fan is the snap.css panel on the homepage. */Ou installez-le comme composant shadcn
L’élément de registre snap-carousel livre tout le motif — accrochage, éventail, flèches, points et un glisser qui se pose sur la carte la plus proche — comme composant stylé Tailwind dans votre components/ui/. Apportez vos propres cartes :
npx shadcn@latest add https://react-horizontal-scrolling-menu.dev/r/snap-carousel.json