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.

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

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

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:

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 como está engasgaria de cartão em cartão. O exemplo de scroll snap 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 é um timer que chama o mesmo scrollToItem, pausado no hover, no foco e com movimento reduzido. Um loop infinito 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 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

Todos os exemplos (23)