Documentation développeurs : Fonctionnement
Assistant d’envoi
Assistant d’envoi
Fini les erreurs « fichier trop volumineux » : les PDF, photos et images HEIC d’iPhone sont réduits dans le navigateur du visiteur, puis transmis à votre formulaire, qui reçoit un fichier conforme.
Où placer la limite
Ajoutez data-pdfkind-max là où les fichiers arrivent. C’est l’élément le plus proche portant l’attribut qui l’emporte : un champ peut donc avoir sa propre limite dans un formulaire qui en a une autre.
| Votre envoi | Placez data-pdfkind-max sur | Exemple |
|---|---|---|
| Un champ fichier | le champ | <input type="file" data-pdfkind-max="5MB"> |
| Une zone de glisser-déposer | la zone (couvre le dépôt et son bouton « Parcourir ») | <div class="dropzone" data-pdfkind-max="5MB"> |
| Un formulaire entier | le formulaire | <form data-pdfkind-max="5MB"> |
| Tous les champs de la page | la balise script, sous la forme data-max | <script src="…/embed.js" data-max="5MB" defer> |
Écrire la limite
Écrivez-la sous la forme 5MB, 500KB, 2.5 MB ou 800ko, ou en nombre d’octets, par exemple 5000000. 1 Mo correspond à 1 000 000 octets.
5MB : c’est légèrement inférieur, donc les fichiers réduits passent toujours votre contrôle.Ce que devient chaque fichier
| Fichier | Ce que fait l’assistant |
|---|---|
| Sous la limite | Rien. Il va directement à votre formulaire, aucune fenêtre ne s’ouvre. |
| PDF au-dessus de la limite | Réduit : les polices et les données en double sont d’abord allégées, puis les images sont compressées juste autant que nécessaire. Le texte reste net et sélectionnable. |
| JPG, PNG, WebP au-dessus de la limite | Réencodé et redimensionné juste autant que nécessaire. Un PNG sans transparence qui ne peut pas tenir sous la limite devient un JPG. |
| HEIC ou HEIF (photos d’iPhone) | Toujours converti en JPG, même sous la limite, car la plupart des formulaires n’acceptent pas le HEIC. |
| Tout autre fichier (Word, ZIP…) | Laissé tel quel. |
| Plusieurs fichiers à la fois | Chacun est traité à son tour ; votre champ les reçoit tous. |
Ce que voit le visiteur
Une petite fenêtre PDFkind s’ouvre par-dessus votre page avec « Réduction de votre fichier… », affiche ensuite le résultat (« Réduit de 8,2 Mo à 3,9 Mo ») puis se ferme d’elle-même. La plupart des fichiers prennent de 1 à 5 secondes ; un long scan sur un téléphone ancien peut prendre environ 15 secondes.
| Si | Alors |
|---|---|
| le fichier ne peut pas passer sous la limite | La fenêtre explique pourquoi, puis le fichier d’origine est transmis, pour que votre formulaire affiche son erreur habituelle. |
| le visiteur ferme la fenêtre | Le fichier d’origine est transmis. |
| la fenêtre ne se charge pas en 8 secondes | Le fichier d’origine est transmis immédiatement (hors connexion, ou bloqué par vos règles de sécurité). |
| le script lui-même ne se charge pas | Rien ne change sur votre page : votre formulaire fonctionne comme avant. |
Langue de la fenêtre
La fenêtre suit l’attribut <html lang> de votre page. Pour la choisir, indiquez data-lang="fr" sur le champ ou sur le script. Consultez Langues.
Frameworks
Dernière mise à jour : 3 novembre 2026 · Des questions ? contact@pdfkind.com