Todos os componentes · Categoria: Formulários

Soltar arquivos com prévia

Solte arquivos e veja a lista com prévia, só no navegador.

Uma zona para soltar e um botão acessível pelo teclado para escolher arquivos, com limites de tipo e tamanho vindos das suas props. As imagens ganham uma prévia feita no navegador. Nada é enviado, e o componente diz isso na tela.

Experimente

<file-drop-preview>

VisãoPréviaCódigoCSS

file-drop-preview: Solte arquivos e veja a lista com prévia, só no navegador. 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

<file-drop-preview
  locale="en"
  examples="[{&quot;name&quot;:&quot;brand-cover.png&quot;,&quot;sizeKb&quot;:842},{&quot;name&quot;:&quot;brief.pdf&quot;,&quot;sizeKb&quot;:240}]"
></file-drop-preview>

<script>
  const element = document.querySelector("file-drop-preview");
  element.addEventListener("file-drop-preview:changed", (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("file-drop-preview");
element.setAttribute("locale", "en");
element.examples = [
  {
    "name": "brand-cover.png",
    "sizeKb": 842
  },
  {
    "name": "brief.pdf",
    "sizeKb": 240
  }
];
element.addEventListener("file-drop-preview:changed", (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.

FileDropPreview.tsx

import { useEffect, useRef } from "react";

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

  useEffect(() => {
    const element = ref.current;
    if (!element) return;
    Object.assign(element, {
      examples: [
        {
          "name": "brand-cover.png",
          "sizeKb": 842
        },
        {
          "name": "brief.pdf",
          "sizeKb": 240
        }
      ],
    });
    const onChanged = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("file-drop-preview:changed", onChanged);
    return () => {
      element.removeEventListener("file-drop-preview:changed", onChanged);
    };
  }, []);

  return <file-drop-preview 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.
Listas e objetos entram como propriedade do elemento, não como atributo.
O evento é ouvido com addEventListener, dentro de um efeito.

FileDropPreview.tsx

import { useEffect, useRef } from "react";

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

  useEffect(() => {
    const element = ref.current;
    if (!element) return;
    Object.assign(element, {
      examples: [
        {
          "name": "brand-cover.png",
          "sizeKb": 842
        },
        {
          "name": "brief.pdf",
          "sizeKb": 240
        }
      ],
    });
    const onChanged = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("file-drop-preview:changed", onChanged);
    return () => {
      element.removeEventListener("file-drop-preview:changed", onChanged);
    };
  }, []);

  return <file-drop-preview 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.
Listas e objetos entram como propriedade do elemento, não como atributo.
O evento é ouvido com addEventListener, dentro de um efeito.

src/FileDropPreview.vue

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

<template>
  <file-drop-preview
    locale="en"
    :examples.prop="[{&quot;name&quot;:&quot;brand-cover.png&quot;,&quot;sizeKb&quot;:842},{&quot;name&quot;:&quot;brief.pdf&quot;,&quot;sizeKb&quot;:240}]"
    @file-drop-preview:changed="onChanged"
  />
</template>

vite.config.ts

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

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

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/file-drop-preview.component.ts

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

@Component({
  selector: "app-file-drop-preview",
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
  template: `
    <file-drop-preview locale="en" [examples]="values.examples"></file-drop-preview>
  `,
})
export class FileDropPreviewComponent {
  readonly values = {
    examples: [
      {
        "name": "brand-cover.png",
        "sizeKb": 842
      },
      {
        "name": "brief.pdf",
        "sizeKb": 240
      }
    ],
  };

  constructor() {
    const host = inject<ElementRef<HTMLElement>>(ElementRef);
    const element = () => host.nativeElement.querySelector("file-drop-preview");
    const onChanged = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    afterNextRender(() => element()?.addEventListener("file-drop-preview:changed", onChanged));
    inject(DestroyRef).onDestroy(() => element()?.removeEventListener("file-drop-preview:changed", onChanged));
  }
}

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 onChanged(event) {
    console.log(event.detail);
  }
</script>

<file-drop-preview
  locale="en"
  examples={[
    {
      "name": "brand-cover.png",
      "sizeKb": 842
    },
    {
      "name": "brief.pdf",
      "sizeKb": 240
    }
  ]}
  onfile-drop-preview:changed={onChanged}
></file-drop-preview>

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

file-drop-preview {
  --fd-radius: 18px;
}

Props

Props do componente, lidas do manifesto dele
Prop	Tipo	Padrão	O que faz
accept	list	["image/*",".pdf"]	Accepted types: MIME types (image/png), groups (image/*) or extensions (.pdf).
maxSizeKb	number 10 to 20480	2048	Largest file, in KB.
maxFiles	number 1 to 12	4	Most files in the list.
examples	list	nenhum	Rows listed before the visitor adds a file, marked as sample content.
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
changed	The list of files changed.

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 "Soltar arquivos com prévia" (file-drop-preview): Solte arquivos e veja a lista com prévia, só no navegador. 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

Formulário em passos<form-multistep>
Formulário de contato<contact-form>
Orçamento em etapas<quote-wizard>