Documentatie voor ontwikkelaars: Hoe het werkt
Uploadhulp
Uploadhulp
Geen foutmeldingen meer over een te groot bestand: PDF’s, foto’s en HEIC-afbeeldingen van iPhones worden in de browser van de bezoeker verkleind en aan je formulier doorgegeven, dat een bestand ontvangt dat binnen de limiet blijft.
Waar zet je de limiet?
Voeg data-pdfkind-max toe waar bestanden binnenkomen. Het dichtstbijzijnde element met het attribuut wint, zodat één veld een eigen limiet kan hebben binnen een formulier met een andere limiet.
| Je upload | Zet data-pdfkind-max op | Voorbeeld |
|---|---|---|
| Een bestandsveld | het input-element | <input type="file" data-pdfkind-max="5MB"> |
| Een sleepgebied (drag-and-drop) | het gebied (geldt voor slepen én de bijbehorende knop ‘bladeren’) | <div class="dropzone" data-pdfkind-max="5MB"> |
| Een heel formulier | het formulier | <form data-pdfkind-max="5MB"> |
| Elk veld op de pagina | de scripttag, als data-max | <script src="…/embed.js" data-max="5MB" defer> |
De limiet noteren
Schrijf hem als 5MB, 500KB, 2.5 MB of 800ko, of als aantal bytes, zoals 5000000. 1 MB is 1.000.000 bytes.
5MB: dat is iets lager, zodat verkleinde bestanden altijd door je controle komen.Wat er met elk bestand gebeurt
| Bestand | Wat de uploadhulp doet |
|---|---|
| Onder de limiet | Niets. Het gaat direct naar je formulier, er opent geen venster. |
| PDF boven de limiet | Verkleind: eerst worden lettertypen en dubbele gegevens afgeslankt, daarna worden afbeeldingen alleen zoveel lichter gemaakt als nodig is. Tekst blijft scherp en selecteerbaar. |
| JPG, PNG, WebP boven de limiet | Opnieuw gecodeerd en verkleind, alleen zoveel als nodig is. Een PNG zonder transparantie die niet past, wordt een JPG. |
| HEIC of HEIF (iPhone-foto’s) | Altijd omgezet naar JPG, ook onder de limiet, omdat de meeste formulieren geen HEIC accepteren. |
| Elk ander bestand (Word, ZIP…) | Blijft ongewijzigd. |
| Meerdere bestanden tegelijk | Ze worden een voor een verwerkt; je veld ontvangt ze allemaal. |
Wat de bezoeker ziet
Er opent een klein PDFkind-venster boven je pagina met ‘Je bestand wordt verkleind…’. Daarna toont het het resultaat (‘Verkleind van 8.2 MB naar 3.9 MB’) en sluit het vanzelf. De meeste bestanden duren 1 tot 5 seconden; een lange scan op een oudere telefoon kan ongeveer 15 seconden duren.
| Als | Dan |
|---|---|
| het bestand niet onder de limiet te krijgen is | Het venster legt uit waarom, waarna het originele bestand wordt doorgegeven, zodat je formulier zijn gebruikelijke foutmelding toont. |
| de bezoeker het venster sluit | Het originele bestand wordt doorgegeven. |
| het venster niet binnen 8 seconden laadt | Het originele bestand wordt meteen doorgegeven (offline, of geblokkeerd door je beveiligingsregels). |
| het script zelf niet laadt | Er verandert niets op je pagina: je formulier werkt zoals voorheen. |
Taal van het venster
Het venster volgt de <html lang> van je pagina. Zet data-lang="fr" op het veld of het script om zelf een taal te kiezen. Zie Talen.
Frameworks
Laatst bijgewerkt op 3 november 2026 · Vragen: contact@pdfkind.com