---
title: "Carrousel de témoignages React sur scroll snap natif"
description: "Carrousel de témoignages en React sans bibliothèque de slider : scroll-snap centre chaque carte et une animation CSS ouvre le reste en éventail. Points, flèches, source."
canonical: "https://react-horizontal-scrolling-menu.dev/fr/testimonial-carousel"
image: "https://react-horizontal-scrolling-menu.dev/og.png"
---

# 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.

M**Mia Chen**Product designer

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

T**Tomás Reyes**Engineering manager

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

A**Aisha Okafor**Founder

“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.”

J**Jonas Lindqvist**Data analyst

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

P**Priya Natarajan**Operations lead

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

L**Lucas Moreau**Freelance 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.

[Modifier cet exemple en direct dans Storybook](https://asmyshlyaev177.github.io/react-horizontal-scrolling-menu/?path=/story/examples-scrollsnap--scroll-snap)

## À 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 mandatory` sur la rangée et `scroll-snap-align: center` sur 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 : `onScroll` trouve la plus proche du centre de la rangée, et `scrollToItem(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](https://react-horizontal-scrolling-menu.dev/fr/examples/mouse-drag.md) telle quelle sauterait de carte en carte. L’[exemple scroll snap](https://react-horizontal-scrolling-menu.dev/fr/examples/scroll-snap.md) 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](https://react-horizontal-scrolling-menu.dev/fr/examples/autoplay.md) est un minuteur appelant le même `scrollToItem`, en pause au survol, au focus et en mouvement réduit. Une [boucle infinie](https://react-horizontal-scrolling-menu.dev/fr/examples/infinite-loop.md) 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](https://react-horizontal-scrolling-menu.dev/r/snap-carousel.json) 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

-   [Carrousel à accrochage au défilementLes cartes s’accrochent au centre et s’ouvrent en éventail en CSS — sans moteur de carrousel.](https://react-horizontal-scrolling-menu.dev/fr/examples/scroll-snap.md)
-   [Lecture automatiqueUne boucle qui avance seule avec une pause accessible.](https://react-horizontal-scrolling-menu.dev/fr/examples/autoplay.md)
-   [Boucle infinieBoucle continue depuis l’API publique — sans changement dans la bibliothèque.](https://react-horizontal-scrolling-menu.dev/fr/examples/infinite-loop.md)

[Tous les exemples (23)](https://react-horizontal-scrolling-menu.dev/fr/examples.md)

---

More examples: <https://react-horizontal-scrolling-menu.dev/examples.md>
Library summary for LLMs: <https://react-horizontal-scrolling-menu.dev/llms.txt>
