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.

Mia ChenProduct designer

“Setup took an afternoon and the first report landed in my inbox the next morning. I have not opened the old spreadsheet since.”

Tomás ReyesEngineering manager

“The weekly digest is the only email my team reads end to end. Short, specific, and it names the person who unblocked you.”

Aisha OkaforFounder

“I wanted numbers I could defend in a board meeting. Every figure links back to the source, so nobody has to take my word for it.”

Jonas LindqvistData analyst

“Exports are plain CSV with sane column names. That alone saved me a script I had been maintaining for two years.”

Priya NatarajanOperations lead

“Support answered a Sunday question in twenty minutes with a fix, not a ticket number. That is what I pay for.”

Lucas MoreauFreelance developer

“The API does exactly what the docs say, and the docs are one page. I shipped the integration before lunch.”

Balayez, faites glisser ou utilisez les flèches et les points — la rangée se pose sur une carte à chaque fois.

À 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 :

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.

TestimonialCarousel.tsx
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 :

shadcn
npx shadcn@latest add https://react-horizontal-scrolling-menu.dev/r/snap-carousel.json

Exemples associés

Tous les exemples (23)