Documentación para desarrolladores: Cómo funciona
Asistente de subida
Asistente de subida
Acaba con los errores de «archivo demasiado grande»: los PDF, las fotos y las imágenes HEIC del iPhone se reducen en el navegador del visitante y se entregan a tu formulario, que recibe un archivo que cumple el límite.
Dónde poner el límite
Añade data-pdfkind-max allí donde entran los archivos. Se aplica el elemento más cercano que tenga el atributo, así que un campo puede tener su propio límite dentro de un formulario que tiene otro.
| Tu subida | Pon data-pdfkind-max en | Ejemplo |
|---|---|---|
| Un campo de archivo | el input | <input type="file" data-pdfkind-max="5MB"> |
| Una zona de arrastrar y soltar | la zona (cubre el arrastre y su botón «Examinar») | <div class="dropzone" data-pdfkind-max="5MB"> |
| Un formulario completo | el formulario | <form data-pdfkind-max="5MB"> |
| Todos los campos de la página | la etiqueta script, como data-max | <script src="…/embed.js" data-max="5MB" defer> |
Cómo escribir el límite
Escríbelo como 5MB, 500KB, 2.5 MB u 800ko, o como un número de bytes, por ejemplo 5000000. 1 MB equivale a 1 000 000 de bytes.
5MB: es un poco menos, así que los archivos reducidos siempre pasarán tu comprobación.Qué pasa con cada archivo
| Archivo | Qué hace el asistente |
|---|---|
| Por debajo del límite | Nada. Va directamente a tu formulario y no se abre ninguna ventana. |
| PDF por encima del límite | Se reduce: primero se aligeran las fuentes y los datos duplicados, y después las imágenes, solo lo necesario. El texto sigue nítido y seleccionable. |
| JPG, PNG o WebP por encima del límite | Se vuelve a codificar y se redimensiona solo lo necesario. Un PNG sin transparencia que no cabe en el límite se convierte en JPG. |
| HEIC o HEIF (fotos del iPhone) | Siempre se convierte a JPG, aunque esté por debajo del límite, porque la mayoría de los formularios no aceptan HEIC. |
| Cualquier otro archivo (Word, ZIP…) | No se modifica. |
| Varios archivos a la vez | Se procesan uno tras otro; tu campo los recibe todos. |
Qué ve el visitante
Se abre sobre tu página una pequeña ventana de PDFkind con «Reduciendo tu archivo…», que luego muestra el resultado («Reducido de 8,2 MB a 3,9 MB») y se cierra sola. La mayoría de los archivos tardan de 1 a 5 segundos; un escaneo largo en un móvil antiguo puede tardar unos 15.
| Si | Entonces |
|---|---|
| el archivo no puede quedar por debajo del límite | La ventana explica el motivo y después se envía el archivo original, para que tu formulario muestre su error habitual. |
| el visitante cierra la ventana | Se envía el archivo original. |
| la ventana no carga en 8 segundos | Se envía el archivo original de inmediato (sin conexión o bloqueada por tus reglas de seguridad). |
| el propio script no puede cargarse | No cambia nada en tu página: tu formulario funciona como antes. |
Idioma de la ventana
La ventana sigue el <html lang> de tu página. Para elegirlo, añade data-lang="fr" al campo o al script. Consulta Idiomas.
Frameworks
Última actualización: 3 de noviembre de 2026 · ¿Preguntas? contact@pdfkind.com