“Setup took an afternoon and the first report landed in my inbox the next morning. I have not opened the old spreadsheet since.”
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.
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
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 mandatoryna linha escroll-snap-align: centernos 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:
onScrollencontra o mais próximo do centro da linha, escrollToItem(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 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.
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:
npx shadcn@latest add https://react-horizontal-scrolling-menu.dev/r/snap-carousel.json