Taggor

Todos os componentes · Categoria: Dados

Tabela de dados

Busque, filtre, ordene e pagine linhas.

Uma tabela de verdade que funciona só com o teclado. As linhas desta página são dados de exemplo gerados, não pedidos reais.

01

Experimente

<data-table>
Visão

Props

Destaque
Cantos
data-table: Busque, filtre, ordene e pagine linhas. 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.

Código para

index.html

<data-table locale="en"></data-table>

<script>
  const element = document.querySelector("data-table");
  element.addEventListener("data-table:sort", (event) => {
    console.log(event.detail);
  });
  element.addEventListener("data-table:filter", (event) => {
    console.log(event.detail);
  });
  element.addEventListener("data-table:page", (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("data-table");
element.setAttribute("locale", "en");
element.addEventListener("data-table:sort", (event) => {
  console.log(event.detail);
});
element.addEventListener("data-table:filter", (event) => {
  console.log(event.detail);
});
element.addEventListener("data-table:page", (event) => {
  console.log(event.detail);
});
document.body.append(element);
  • Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.

DataTable.tsx

import { useEffect, useRef } from "react";

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

  useEffect(() => {
    const element = ref.current;
    if (!element) return;
    const onSort = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("data-table:sort", onSort);
    const onFilter = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("data-table:filter", onFilter);
    const onPage = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("data-table:page", onPage);
    return () => {
      element.removeEventListener("data-table:sort", onSort);
      element.removeEventListener("data-table:filter", onFilter);
      element.removeEventListener("data-table:page", onPage);
    };
  }, []);

  return <data-table 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.

DataTable.tsx

import { useEffect, useRef } from "react";

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

  useEffect(() => {
    const element = ref.current;
    if (!element) return;
    const onSort = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("data-table:sort", onSort);
    const onFilter = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("data-table:filter", onFilter);
    const onPage = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("data-table:page", onPage);
    return () => {
      element.removeEventListener("data-table:sort", onSort);
      element.removeEventListener("data-table:filter", onFilter);
      element.removeEventListener("data-table:page", onPage);
    };
  }, []);

  return <data-table 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/DataTable.vue

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

function onFilter(event: Event) {
  console.log((event as CustomEvent).detail);
}

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

<template>
  <data-table
    locale="en"
    @data-table:sort="onSort"
    @data-table:filter="onFilter"
    @data-table:page="onPage"
  />
</template>

vite.config.ts

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

export default defineConfig({
  plugins: [
    vue({
      template: {
        compilerOptions: {
          isCustomElement: (tag) => tag === "data-table",
        },
      },
    }),
  ],
});
  • 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/data-table.component.ts

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

@Component({
  selector: "app-data-table",
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
  template: `
    <data-table locale="en"></data-table>
  `,
})
export class DataTableComponent {
  constructor() {
    const host = inject<ElementRef<HTMLElement>>(ElementRef);
    const element = () => host.nativeElement.querySelector("data-table");
    const onSort = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    afterNextRender(() => element()?.addEventListener("data-table:sort", onSort));
    inject(DestroyRef).onDestroy(() => element()?.removeEventListener("data-table:sort", onSort));
    const onFilter = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    afterNextRender(() => element()?.addEventListener("data-table:filter", onFilter));
    inject(DestroyRef).onDestroy(() => element()?.removeEventListener("data-table:filter", onFilter));
    const onPage = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    afterNextRender(() => element()?.addEventListener("data-table:page", onPage));
    inject(DestroyRef).onDestroy(() => element()?.removeEventListener("data-table:page", onPage));
  }
}
  • 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 onSort(event) {
    console.log(event.detail);
  }

  function onFilter(event) {
    console.log(event.detail);
  }

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

<data-table
  locale="en"
  ondata-table:sort={onSort}
  ondata-table:filter={onFilter}
  ondata-table:page={onPage}
></data-table>
  • 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

data-table {
  --dt-radius: 12px;
}

02

Props

Props do componente, lidas do manifesto dele
PropTipoPadrãoO que faz
headlinestringnenhumReplaces the default heading.
sampleorders | inventoryordersWhich synthetic dataset to show.
rowsnumber 0 to 1000120How many rows to generate.
seednumber 0 to 10000007The same seed makes the same rows.
pageSizenumber 3 to 508Rows per page.
sortColumnstringnenhumThe column key it starts sorted by; the dataset's own when unknown.
sortDirectionasc | descdescThe direction of the first sort.
currencyUSD | EUR | BRLUSD–
hideSearchbooleanfalseHides the search box and the filter menu.
compactbooleanfalseDenser rows.
accentcolornenhumAccent color; wins over the --dt-accent variable.
localept-BR | enen–

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

03

Eventos

Eventos do componente, lidos do manifesto dele
EventoQuando dispara
sortThe visitor sorted by a column.
filterThe search or the menu changed; `matches` is how many rows are left.
pageThe visitor went to another page.

04

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 "Tabela de dados" (data-table): Busque, filtre, ordene e pagine linhas. 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.

05

Componentes relacionados