PDFkind
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)

JavaScript
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
}
OptieTypeBeschrijving
maxstring of getalVerplicht. Zelfde notatie als data-pdfkind-max: 5MB, 500KB of bytes.
elElementOptioneel. 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:

reasonBetekenis
too-bigOok na verkleining is het bestand groter dan de limiet.
unsupportedGeen PDF of afbeelding die de uploadhulp kan verkleinen.
cancelDe bezoeker heeft het venster gesloten.
unavailableHet PDFkind-venster is niet binnen 8 seconden geladen.
timeoutDe verwerking duurde langer dan 3 minuten.
failedHet bestand is beschadigd, of er ging iets anders mis.
bad-callAangeroepen 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.

JavaScript
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