Todos os componentes · Categoria: Enquetes e quizzes

Enquete rápida

Uma pergunta, algumas opções e um voto que é contado.

Botões de opção nativos e um botão Votar. O voto é guardado sem nenhum dado pessoal, então nada pede consentimento.

Experimente

<quick-poll>

VisãoPréviaCódigoCSS

quick-poll: Uma pergunta, algumas opções e um voto que é contado. 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

<quick-poll
  poll-id="landing"
  question="Which feature should we build first?"
  locale="en"
  options="[&quot;Dark mode&quot;,&quot;Mobile app&quot;,&quot;WhatsApp integration&quot;]"
></quick-poll>

<script>
  const element = document.querySelector("quick-poll");
  element.addEventListener("quick-poll:voted", (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("quick-poll");
element.setAttribute("poll-id", "landing");
element.setAttribute("question", "Which feature should we build first?");
element.setAttribute("locale", "en");
element.options = [
  "Dark mode",
  "Mobile app",
  "WhatsApp integration"
];
element.addEventListener("quick-poll:voted", (event) => {
  console.log(event.detail);
});
document.body.append(element);

Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.
Listas e objetos entram como propriedade do elemento, não como atributo.

QuickPoll.tsx

import { useEffect, useRef } from "react";

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

  useEffect(() => {
    const element = ref.current;
    if (!element) return;
    Object.assign(element, {
      options: [
        "Dark mode",
        "Mobile app",
        "WhatsApp integration"
      ],
    });
    const onVoted = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("quick-poll:voted", onVoted);
    return () => {
      element.removeEventListener("quick-poll:voted", onVoted);
    };
  }, []);

  return <quick-poll
      ref={ref}
      poll-id="landing"
      question={"Which feature should we build first?"}
      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.
Listas e objetos entram como propriedade do elemento, não como atributo.
O evento é ouvido com addEventListener, dentro de um efeito.

QuickPoll.tsx

import { useEffect, useRef } from "react";

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

  useEffect(() => {
    const element = ref.current;
    if (!element) return;
    Object.assign(element, {
      options: [
        "Dark mode",
        "Mobile app",
        "WhatsApp integration"
      ],
    });
    const onVoted = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("quick-poll:voted", onVoted);
    return () => {
      element.removeEventListener("quick-poll:voted", onVoted);
    };
  }, []);

  return <quick-poll
      ref={ref}
      poll-id="landing"
      question={"Which feature should we build first?"}
      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.
Listas e objetos entram como propriedade do elemento, não como atributo.
O evento é ouvido com addEventListener, dentro de um efeito.

src/QuickPoll.vue

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

<template>
  <quick-poll
    poll-id="landing"
    question="Which feature should we build first?"
    locale="en"
    :options.prop="[&quot;Dark mode&quot;,&quot;Mobile app&quot;,&quot;WhatsApp integration&quot;]"
    @quick-poll:voted="onVoted"
  />
</template>

vite.config.ts

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

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

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.
Listas e objetos entram como propriedade do elemento, não como atributo.

src/app/quick-poll.component.ts

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

@Component({
  selector: "app-quick-poll",
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
  template: `
    <quick-poll
      poll-id="landing"
      [question]="&#39;Which feature should we build first?&#39;"
      locale="en"
      [options]="values.options"
    ></quick-poll>
  `,
})
export class QuickPollComponent {
  readonly values = {
    options: [
      "Dark mode",
      "Mobile app",
      "WhatsApp integration"
    ],
  };

  constructor() {
    const host = inject<ElementRef<HTMLElement>>(ElementRef);
    const element = () => host.nativeElement.querySelector("quick-poll");
    const onVoted = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    afterNextRender(() => element()?.addEventListener("quick-poll:voted", onVoted));
    inject(DestroyRef).onDestroy(() => element()?.removeEventListener("quick-poll:voted", onVoted));
  }
}

Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.
O componente declara CUSTOM_ELEMENTS_SCHEMA.
Listas e objetos entram como propriedade do elemento, não como atributo.
O evento é ouvido com addEventListener, dentro de um efeito.

src/TaggorComponent.svelte

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

<quick-poll
  poll-id="landing"
  question={"Which feature should we build first?"}
  locale="en"
  options={[
    "Dark mode",
    "Mobile app",
    "WhatsApp integration"
  ]}
  onquick-poll:voted={onVoted}
></quick-poll>

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

quick-poll {
  --qp-radius: 999px;
}

Props

Props do componente, lidas do manifesto dele
Prop	Tipo	Padrão	O que faz
pollId	string	poll	Tells this poll's votes apart from other polls of the site.
question	string	Qual recurso você quer ver primeiro?	–
options	list	["Modo escuro","Aplicativo para celular","Integ…	The answers, in the site's language.
locale	pt-BR \| en	pt-BR	–

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
voted	The vote was accepted by Taggor.

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 "Enquete rápida" (quick-poll): Uma pergunta, algumas opções e um voto que é contado. 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

Enquete ao vivo<live-poll>
Quiz<quiz-result>
Coleta de opinião<feedback-collector>