Documentação para desenvolvedores: Como funciona
Assistente de upload
Assistente de upload
Acabe com o erro “arquivo muito grande”: PDFs, fotos e imagens HEIC do iPhone são reduzidos no navegador do visitante e entregues ao seu formulário, que recebe um arquivo dentro do limite.
Onde colocar o limite
Adicione data-pdfkind-max onde os arquivos entram. Vale o elemento mais próximo que tiver o atributo, então um campo pode ter um limite próprio dentro de um formulário que tem outro.
| Seu upload | Coloque data-pdfkind-max em | Exemplo |
|---|---|---|
| Um campo de arquivo | o input | <input type="file" data-pdfkind-max="5MB"> |
| Uma área de arrastar e soltar | a área (cobre o soltar e o botão “procurar”) | <div class="dropzone" data-pdfkind-max="5MB"> |
| Um formulário inteiro | o form | <form data-pdfkind-max="5MB"> |
| Todos os campos da página | a tag script, como data-max | <script src="…/embed.js" data-max="5MB" defer> |
Como escrever o limite
Escreva como 5MB, 500KB, 2.5 MB ou 800ko, ou como um número de bytes, por exemplo 5000000. 1 MB equivale a 1.000.000 bytes.
5MB: o valor é um pouco menor, então os arquivos reduzidos sempre passam na sua verificação.O que acontece com cada arquivo
| Arquivo | O que o assistente faz |
|---|---|
| Abaixo do limite | Nada. Vai direto para o seu formulário, sem abrir nenhuma janela. |
| PDF acima do limite | Reduzido: primeiro as fontes e os dados duplicados são enxugados, depois as imagens são aliviadas só o necessário. O texto continua nítido e selecionável. |
| JPG, PNG, WebP acima do limite | Recodificado e redimensionado só o necessário. Um PNG sem transparência que não cabe no limite vira JPG. |
| HEIC ou HEIF (fotos do iPhone) | Sempre convertido para JPG, mesmo abaixo do limite, já que a maioria dos formulários não aceita HEIC. |
| Qualquer outro arquivo (Word, ZIP…) | Fica intacto. |
| Vários arquivos de uma vez | Cada um é tratado na sua vez; seu campo recebe todos eles. |
O que o visitante vê
Uma pequena janela do PDFkind abre sobre a sua página com “Reduzindo seu arquivo…”, depois mostra o resultado (“Reduzido de 8,2 MB para 3,9 MB”) e fecha sozinha. A maioria dos arquivos leva de 1 a 5 segundos; uma digitalização longa em um celular mais antigo pode levar cerca de 15.
| Se | Então |
|---|---|
| o arquivo não consegue ficar abaixo do limite | A janela explica o motivo e, em seguida, o arquivo original segue para que o seu formulário mostre o erro de sempre. |
| o visitante fecha a janela | O arquivo original segue. |
| a janela não carrega em até 8 segundos | O arquivo original segue na hora (sem conexão, ou bloqueado pelas suas regras de segurança). |
| o próprio script não carrega | Nada muda na sua página: seu formulário funciona como antes. |
Idioma da janela
A janela segue o <html lang> da sua página. Para escolher, defina data-lang="fr" no campo ou no script. Veja Idiomas.
Frameworks
Atualizado em 3 de novembro de 2026 · Dúvidas: contact@pdfkind.com