Documentazione per sviluppatori: Come funziona
Assistente al caricamento
Assistente al caricamento
Basta errori “file troppo grande”: PDF, foto e immagini HEIC di iPhone vengono ridotti nel browser del visitatore e passati al tuo modulo, che riceve un file entro il limite.
Dove impostare il limite
Aggiungi data-pdfkind-max dove arrivano i file. Vale l’elemento più vicino che ha l’attributo, quindi un campo può avere un proprio limite all’interno di un modulo che ne ha un altro.
| Il tuo caricamento | Dove mettere data-pdfkind-max | Esempio |
|---|---|---|
| Un campo file | sull’input | <input type="file" data-pdfkind-max="5MB"> |
| Un’area di trascinamento | sull’area (copre il rilascio e il relativo pulsante “sfoglia”) | <div class="dropzone" data-pdfkind-max="5MB"> |
| Un intero modulo | sul form | <form data-pdfkind-max="5MB"> |
| Tutti i campi della pagina | sul tag script, come data-max | <script src="…/embed.js" data-max="5MB" defer> |
Come scrivere il limite
Scrivilo come 5MB, 500KB, 2.5 MB o 800ko, oppure come numero di byte, ad esempio 5000000. 1 MB equivale a 1.000.000 di byte.
5MB: è un valore leggermente inferiore, quindi i file ridotti superano sempre il tuo controllo.Cosa succede a ogni file
| File | Cosa fa l’assistente |
|---|---|
| Sotto il limite | Niente. Va direttamente al tuo modulo, senza aprire alcuna finestra. |
| PDF oltre il limite | Ridotto: prima vengono alleggeriti i font e i dati duplicati, poi le immagini solo quanto serve. Il testo resta nitido e selezionabile. |
| JPG, PNG, WebP oltre il limite | Ricodificato e ridimensionato solo quanto serve. Un PNG senza trasparenza che non rientra nel limite diventa un JPG. |
| HEIC o HEIF (foto di iPhone) | Sempre convertito in JPG, anche sotto il limite, perché la maggior parte dei moduli non accetta HEIC. |
| Qualsiasi altro file (Word, ZIP…) | Lasciato invariato. |
| Più file insieme | Vengono gestiti uno alla volta; il tuo campo li riceve tutti. |
Cosa vede il visitatore
Una piccola finestra PDFkind si apre sopra la tua pagina con “Riduzione del file in corso…”, poi mostra il risultato (“Ridotto da 8.2 MB a 3.9 MB”) e si chiude da sola. La maggior parte dei file richiede da 1 a 5 secondi; una scansione lunga su un telefono datato può richiederne circa 15.
| Se | Allora |
|---|---|
| il file non può scendere sotto il limite | La finestra spiega il motivo, poi passa il file originale, così il tuo modulo mostra il suo errore abituale. |
| il visitatore chiude la finestra | Passa il file originale. |
| la finestra non si carica entro 8 secondi | Passa subito il file originale (offline, o bloccata dalle tue regole di sicurezza). |
| lo script stesso non si carica | Sulla tua pagina non cambia nulla: il modulo funziona come prima. |
Lingua della finestra
La finestra segue il <html lang> della tua pagina. Per sceglierla, imposta data-lang="fr" sul campo o sullo script. Vedi Lingue.
Framework
Ultimo aggiornamento: 3 novembre 2026 · Domande: contact@pdfkind.com