---
title: "Carrossel de depoimentos em React com scroll snap nativo"
description: "Carrossel de depoimentos em React sem biblioteca de slider: scroll-snap centraliza cada cartão e uma animação CSS abre o resto em leque. Pontos, setas e fonte."
canonical: "https://react-horizontal-scrolling-menu.dev/pt-br/testimonial-carousel"
image: "https://react-horizontal-scrolling-menu.dev/og.png"
---

# Um carrossel de depoimentos em React, sobre scroll snap nativo

A seção de avaliações de todo site de marketing: um cartão no centro, os vizinhos inclinados atrás, pontos embaixo, um deslize ou um clique para o próximo. As bibliotecas de slider vendem exatamente isso. O navegador já tem as duas metades — `scroll-snap-type` para o pouso e uma animação dirigida pela rolagem para a inclinação — e esta biblioteca adiciona a parte que não é nenhuma das duas: saber qual cartão é o atual.

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

Deslize, arraste ou use as setas e os pontos — a linha assenta sobre um cartão toda vez.

[Edite este exemplo ao vivo no Storybook](https://asmyshlyaev177.github.io/react-horizontal-scrolling-menu/?path=/story/examples-scrollsnap--scroll-snap)

## Para que serve de verdade uma biblioteca de slider aqui

Carrosséis de depoimentos são a instalação canônica do Swiper: três cartões visíveis, o do meio plano, pontos de paginação, autoplay. Cada um desses itens é CSS ou algumas linhas sobre a API desta biblioteca:

-   **Pousar em um cartão** é `scroll-snap-type: x mandatory` na linha e `scroll-snap-align: center` nos itens. A rolagem por toque, roda e teclado continua nativa e desacelera sozinha até um cartão.
-   **A inclinação** é uma animação dirigida pela rolagem em cada cartão, então o ângulo acompanha a posição de rolagem pixel a pixel sem medir nada em JavaScript. Chromium e Safari 26 a desenham; o Firefox ainda a mantém atrás de uma flag e mostra cartões planos, e a regra é protegida com `@supports`.
-   **Pontos e setas** precisam saber o cartão atual: `onScroll` encontra o mais próximo do centro da linha, e `scrollToItem(el, 'smooth', 'center')` avança para um vizinho ou pula para o cartão de um ponto, caindo em um ponto de encaixe por construção.

## A única coisa a acertar: o arraste

Um contêiner com encaixe obrigatório encaixa cada escrita programática em `scrollLeft`, então a [receita de arraste com o mouse](https://react-horizontal-scrolling-menu.dev/pt-br/examples/mouse-drag.md) como está engasgaria de cartão em cartão. O [exemplo de scroll snap](https://react-horizontal-scrolling-menu.dev/pt-br/examples/scroll-snap.md) mostra a correção: desligar o encaixe durante o gesto, deslizar até o cartão mais próximo com `scrollToItem` ao soltar e devolver o encaixe ao CSS quando esse deslize assentar — reativá-lo antes pula em vez de deslizar. O toque não precisa de nada disso; a linha é um contêiner de rolagem de verdade.

## Autoplay, loop e o que continua seu

O [autoplay](https://react-horizontal-scrolling-menu.dev/pt-br/examples/autoplay.md) é um timer que chama o mesmo `scrollToItem`, pausado no hover, no foco e com movimento reduzido. Um [loop infinito](https://react-horizontal-scrolling-menu.dev/pt-br/examples/infinite-loop.md) também se combina: seu teletransporte move um comprimento de loop inteiro, que é um número inteiro de pontos de encaixe. Os cartões são seus componentes — um avatar, uma nota, uma citação, um logo — e a geometria são três propriedades personalizadas: largura do cartão, espaçamento e inclinação.

## O padrão, no mínimo

Encaixe e inclinação são a folha de estilos; as setas e os pontos são uma medição e um `scrollToItem`. A demo acima é isso mais os cartões.

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 instale como um componente shadcn

O item de registro [snap-carousel](https://react-horizontal-scrolling-menu.dev/r/snap-carousel.json) traz o padrão inteiro — encaixe, leque, setas, pontos e um arraste que cai sobre o cartão mais próximo — como componente estilizado com Tailwind no seu `components/ui/`. Traga seus próprios cartões:

shadcn

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

## Exemplos relacionados

-   [Carrossel com encaixe de rolagemOs cartões se encaixam no centro e se abrem em leque com CSS — sem motor de carrossel.](https://react-horizontal-scrolling-menu.dev/pt-br/examples/scroll-snap.md)
-   [AutoplayUm loop que avança sozinho com pausa acessível.](https://react-horizontal-scrolling-menu.dev/pt-br/examples/autoplay.md)
-   [Loop infinitoLoop contínuo a partir da API pública — sem mudanças na biblioteca.](https://react-horizontal-scrolling-menu.dev/pt-br/examples/infinite-loop.md)

[Todos os exemplos (23)](https://react-horizontal-scrolling-menu.dev/pt-br/examples.md)

---

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