Entwicklerdokumentation: Funktionsweise
Upload-Helfer
Upload-Helfer
Schluss mit „Datei zu groß“: PDFs, Fotos und iPhone-HEIC-Bilder werden im Browser der Besucher verkleinert und an Ihr Formular übergeben, das eine passende Datei erhält.
Wo das Limit hingehört
Setzen Sie data-pdfkind-max dort, wo Dateien hereinkommen. Es gilt das nächstgelegene Element mit dem Attribut, sodass ein Feld innerhalb eines Formulars mit anderem Limit ein eigenes Limit haben kann.
| Ihr Upload | data-pdfkind-max setzen auf | Beispiel |
|---|---|---|
| Ein Dateifeld | das Input-Element | <input type="file" data-pdfkind-max="5MB"> |
| Ein Drag-and-drop-Bereich | den Bereich (gilt für das Ablegen und seine „Durchsuchen“-Schaltfläche) | <div class="dropzone" data-pdfkind-max="5MB"> |
| Ein ganzes Formular | das Formular | <form data-pdfkind-max="5MB"> |
| Alle Felder der Seite | das Script-Tag, als data-max | <script src="…/embed.js" data-max="5MB" defer> |
Das Limit angeben
Schreiben Sie es als 5MB, 500KB, 2.5 MB oder 800ko oder als Anzahl Bytes, etwa 5000000. 1 MB entspricht 1.000.000 Bytes.
5MB: Das ist etwas weniger, sodass verkleinerte Dateien Ihre Prüfung immer bestehen.Was mit jeder Datei passiert
| Datei | Was der Helfer tut |
|---|---|
| Unter dem Limit | Nichts. Sie geht direkt an Ihr Formular, es öffnet sich kein Fenster. |
| PDF über dem Limit | Wird verkleinert: Zuerst werden Schriften und doppelte Daten verschlankt, dann Bilder nur so weit wie nötig reduziert. Text bleibt scharf und auswählbar. |
| JPG, PNG, WebP über dem Limit | Wird nur so weit wie nötig neu kodiert und verkleinert. Ein PNG ohne Transparenz, das nicht passt, wird zu JPG. |
| HEIC oder HEIF (iPhone-Fotos) | Wird immer in JPG umgewandelt, auch unter dem Limit, da die meisten Formulare kein HEIC annehmen. |
| Alle anderen Dateien (Word, ZIP…) | Bleiben unverändert. |
| Mehrere Dateien gleichzeitig | Sie werden nacheinander verarbeitet; Ihr Feld erhält alle. |
Was Besucher sehen
Über Ihrer Seite öffnet sich ein kleines PDFkind-Fenster mit „Datei wird verkleinert…“, zeigt dann das Ergebnis („Verkleinert von 8,2 MB auf 3,9 MB“) und schließt sich von selbst. Die meisten Dateien brauchen 1 bis 5 Sekunden; ein langer Scan auf einem älteren Smartphone kann etwa 15 Sekunden dauern.
| Wenn | Dann |
|---|---|
| die Datei nicht unter das Limit gebracht werden kann | Das Fenster erklärt den Grund, dann wird die Originaldatei durchgereicht, sodass Ihr Formular seine übliche Fehlermeldung anzeigt. |
| der Besucher das Fenster schließt | Die Originaldatei wird durchgereicht. |
| das Fenster nicht innerhalb von 8 Sekunden lädt | Die Originaldatei wird sofort durchgereicht (offline oder durch Ihre Sicherheitsregeln blockiert). |
| das Script selbst nicht lädt | Auf Ihrer Seite ändert sich nichts: Ihr Formular funktioniert wie bisher. |
Sprache des Fensters
Das Fenster richtet sich nach dem <html lang> Ihrer Seite. Setzen Sie data-lang="fr" auf das Feld oder das Script, um die Sprache festzulegen. Siehe Sprachen.
Frameworks
Zuletzt aktualisiert am 3. November 2026 · Fragen: contact@pdfkind.com