Documentatie voor ontwikkelaars: JavaScript-API
Uploadhulp
JavaScript-API
Verklein een PDF of afbeelding tot een maximale grootte vanuit je eigen code met PDFkind.fit(file, { max }), en vang elke uitkomst af.
Het script voegt een globaal PDFkind-object toe. Gebruik het wanneer bestanden ergens vandaan komen die de automatische modus niet ziet: plakken, een camera, een eigen bestandskiezer.
PDFkind.fit(file, options)
try {
const small = await PDFkind.fit(file, { max: '5MB' });
upload(small);
} catch (err) {
if (err.reason === 'too-big') alert('Dit bestand is te groot, zelfs na verkleining.');
else upload(file); // terugvallen op het origineel
}| Optie | Type | Beschrijving |
|---|---|---|
max | string of getal | Verplicht. Zelfde notatie als data-pdfkind-max: 5MB, 500KB of bytes. |
el | Element | Optioneel. De data-lang ervan (of van een bovenliggend element) bepaalt de taal van het venster. |
De promise wordt vervuld met een File: het verkleinde bestand, de omgezette JPG bij HEIC-foto’s, of het origineel als het al past (dan opent er geen venster). Bij een fout wordt hij afgewezen met een error waarvan de reason een van deze waarden is:
| reason | Betekenis |
|---|---|
too-big | Ook na verkleining is het bestand groter dan de limiet. |
unsupported | Geen PDF of afbeelding die de uploadhulp kan verkleinen. |
cancel | De bezoeker heeft het venster gesloten. |
unavailable | Het PDFkind-venster is niet binnen 8 seconden geladen. |
timeout | De verwerking duurde langer dan 3 minuten. |
failed | Het bestand is beschadigd, of er ging iets anders mis. |
bad-call | Aangeroepen zonder File of zonder max. |
PDFkind.mount(root)
Zet data-pdfkind-tool-elementen om in tools. Dit gebeurt automatisch bij het laden van de pagina; roep het opnieuw aan als je later tools toevoegt, bijvoorbeeld in een single-page app. root is optioneel en is standaard de hele pagina.
container.innerHTML = '<div data-pdfkind-tool="split-pdf"></div>';
PDFkind.mount(container);PDFkind.version
De versie van het script, momenteel 3. Handig om te controleren of het script is geladen: typ PDFkind.version in de browserconsole.
Laatst bijgewerkt op 3 november 2026 · Vragen: contact@pdfkind.com