Todos os componentes · Categoria: Visual

Carrossel de cartões

Cartões que deslizam, com botões, bolinhas, teclas e deslize.

Cartões com uma imagem desenhada, uma etiqueta, um título e um link. A reprodução automática vem desligada e, quando ligada, pode ser pausada como as regras de acessibilidade pedem.

Experimente

<card-carousel>

VisãoPréviaCódigoCSS

card-carousel: Cartões que deslizam, com botões, bolinhas, teclas e deslize. Uma imagem do componente real, desenhada a partir do próprio código. Os controles mudam a imagem e o código ao lado; nada aqui é enviado nem guardado.

Gerado a partir do manifesto do componente e dos valores acima.

index.html

<card-carousel locale="en"></card-carousel>

<script>
  const element = document.querySelector("card-carousel");
  element.addEventListener("card-carousel:slide", (event) => {
    console.log(event.detail);
  });
  element.addEventListener("card-carousel:card-click", (event) => {
    console.log(event.detail);
  });
</script>

Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.

taggor-component.js

const element = document.createElement("card-carousel");
element.setAttribute("locale", "en");
element.addEventListener("card-carousel:slide", (event) => {
  console.log(event.detail);
});
element.addEventListener("card-carousel:card-click", (event) => {
  console.log(event.detail);
});
document.body.append(element);

Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.

CardCarousel.tsx

import { useEffect, useRef } from "react";

export function CardCarousel() {
  const ref = useRef<HTMLElement>(null);

  useEffect(() => {
    const element = ref.current;
    if (!element) return;
    const onSlide = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("card-carousel:slide", onSlide);
    const onCardClick = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("card-carousel:card-click", onCardClick);
    return () => {
      element.removeEventListener("card-carousel:slide", onSlide);
      element.removeEventListener("card-carousel:card-click", onCardClick);
    };
  }, []);

  return <card-carousel ref={ref} locale="en" />;
}

Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.
O React 18 manda toda prop de um custom element como atributo de texto.
O evento é ouvido com addEventListener, dentro de um efeito.

CardCarousel.tsx

import { useEffect, useRef } from "react";

export function CardCarousel() {
  const ref = useRef<HTMLElement>(null);

  useEffect(() => {
    const element = ref.current;
    if (!element) return;
    const onSlide = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("card-carousel:slide", onSlide);
    const onCardClick = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("card-carousel:card-click", onCardClick);
    return () => {
      element.removeEventListener("card-carousel:slide", onSlide);
      element.removeEventListener("card-carousel:card-click", onCardClick);
    };
  }, []);

  return <card-carousel ref={ref} locale="en" />;
}

Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.
O React 19 define uma propriedade quando o elemento já a tem e um atributo no resto.
O evento é ouvido com addEventListener, dentro de um efeito.

src/CardCarousel.vue

<script setup lang="ts">
function onSlide(event: Event) {
  console.log((event as CustomEvent).detail);
}

function onCardClick(event: Event) {
  console.log((event as CustomEvent).detail);
}
</script>

<template>
  <card-carousel
    locale="en"
    @card-carousel:slide="onSlide"
    @card-carousel:card-click="onCardClick"
  />
</template>

vite.config.ts

import vue from "@vitejs/plugin-vue";
import { defineConfig } from "vite";

export default defineConfig({
  plugins: [
    vue({
      template: {
        compilerOptions: {
          isCustomElement: (tag) => tag === "card-carousel",
        },
      },
    }),
  ],
});

Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.
O vite.config.ts avisa o Vue de que esta tag não é um componente Vue.

src/app/card-carousel.component.ts

import { afterNextRender, Component, CUSTOM_ELEMENTS_SCHEMA, DestroyRef, ElementRef, inject } from "@angular/core";

@Component({
  selector: "app-card-carousel",
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
  template: `
    <card-carousel locale="en"></card-carousel>
  `,
})
export class CardCarouselComponent {
  constructor() {
    const host = inject<ElementRef<HTMLElement>>(ElementRef);
    const element = () => host.nativeElement.querySelector("card-carousel");
    const onSlide = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    afterNextRender(() => element()?.addEventListener("card-carousel:slide", onSlide));
    inject(DestroyRef).onDestroy(() => element()?.removeEventListener("card-carousel:slide", onSlide));
    const onCardClick = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    afterNextRender(() => element()?.addEventListener("card-carousel:card-click", onCardClick));
    inject(DestroyRef).onDestroy(() => element()?.removeEventListener("card-carousel:card-click", onCardClick));
  }
}

Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.
O componente declara CUSTOM_ELEMENTS_SCHEMA.
O evento é ouvido com addEventListener, dentro de um efeito.

src/TaggorComponent.svelte

<script>
  function onSlide(event) {
    console.log(event.detail);
  }

  function onCardClick(event) {
    console.log(event.detail);
  }
</script>

<card-carousel
  locale="en"
  oncard-carousel:slide={onSlide}
  oncard-carousel:card-click={onCardClick}
></card-carousel>

Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.

Como um agente leva um componente assim a um site:

taggor checktaggor publish

As variáveis CSS que o componente expõe, definidas como a página de um cliente faria.

styles.css

card-carousel {
  --cc-radius: 14px;
}

Props

Props do componente, lidas do manifesto dele
Prop	Tipo	Padrão	O que faz
headline	string	nenhum	Replaces the default heading.
cards	list	[{"id":"seasonal","title":"Seasonal collection"…	The cards, in the site's language; the picture is drawn from art and hue.
perView	number 1 to 4	3	Cards in view on a wide screen; fewer on a narrow one.
loop	boolean	false	Goes from the last card back to the first.
autoplaySeconds	number 0 to 30	0	Seconds between automatic moves; 0 turns autoplay off.
accent	color	nenhum	Accent color; wins over the --cc-accent variable.
hideExampleNote	boolean	false	Hides the note that the cards are examples.
locale	pt-BR \| en	en	–

Os nomes e as descrições das props são os do próprio componente, em inglês, como o autor escreveu.

Eventos

Eventos do componente, lidos do manifesto dele
Evento	Quando dispara
slide	The first visible card changed.
card-click	The visitor followed a card's link.

Construa um com o seu agente

Cole no seu agente. Ele pergunta a você antes de entrar na conta, pagar ou ir além de verificar e publicar.

Construa para mim um componente do Taggor como "Carrossel de cartões" (card-carousel): Cartões que deslizam, com botões, bolinhas, teclas e deslize. Busque https://taggor.dev/agent-setup/prompt.md e siga as instruções de lá para me configurar para o Taggor. Pergunte-me antes de entrar na conta, criar uma conta, aceitar termos, pagar qualquer coisa ou digitar um segredo. Verifique com `taggor check` e publique com `taggor publish`, e pare por aí. Não promova para produção, não anexe a um site, não faça rollback nem use --yes, --force ou --force-drop-invalid, a menos que eu peça exatamente isso nesta conversa.

Componentes relacionados

Antes e depois<before-after-slider>
Perguntas frequentes<faq-accordion>
Contagem para o lançamento<launch-countdown>

Carrossel de cartões

Experimente

Browse the collection

Seasonal

Gifts

Workshops

Journal

Props

Eventos

Construa um com o seu agente

Componentes relacionados

Documentação