Formulario de Carga de archivos

¿Qué es un formulario de carga de archivos?

Un formulario de carga de archivos permite a un visitante adjuntar un archivo, una imagen, un documento, un currículum, una captura de pantalla, junto con los campos de texto habituales, y enviarlo todo en un solo envío. En el momento en que un formulario tiene un campo de archivo, ya no puede enviarse como datos url-encoded simples; tiene que enviarse como multipart form data en su lugar. Esta plantilla maneja ese cambio por ti.

El código generado configura el enctype correcto, multipart/form-data, y envía el FormData sin procesar, así que el archivo viaja junto con los demás campos en una única petición. No escribes un endpoint de carga, y tu app nunca tiene que recibir, almacenar en búfer ni procesar el archivo. El navegador lo envía directamente a Formpaste, lo que evita por completo los límites de tamaño de cuerpo y de tiempo de ejecución de los entornos serverless que hacen tropezar al manejo de cargas autoalojado.

Cuándo usarlo

Recurre a un formulario de carga de archivos siempre que un envío quede incompleto sin un adjunto. Las postulaciones de empleo necesitan un currículum, las solicitudes de soporte suelen necesitar una captura, el feedback de diseño necesita el archivo en cuestión, y los reclamos o registros con frecuencia necesitan un documento. Si “por favor adjunta” es parte de la petición, este es el formulario.

Es el patrón adecuado siempre que quieras tener el archivo y el contexto juntos en un solo lugar, en vez de un formulario de texto más un paso separado de “envíanos el archivo por correo”. Un envío, ambas partes, sin rearmado. Si nunca necesitas realmente un adjunto, un formulario simple es más ligero; agrega el campo de archivo solo cuando el archivo sea genuinamente parte de la petición.

Qué incluir

Esta plantilla empareja un archivo con el contexto justo para que sea útil. Nombre y correo electrónico son obligatorios, así sabes quién envió la carga y puedes responder. El campo de archivo en sí es obligatorio, así que ningún envío llega sin el adjunto que es todo el punto. Un área de texto de mensaje es opcional, dando al remitente espacio para explicar qué es el archivo o qué necesita que se haga con él.

Sé claro con las personas sobre lo que aceptas. Pon los tipos aceptados y un límite aproximado de tamaño en la etiqueta o en una nota cerca del campo, para que alguien no complete el formulario solo para que un archivo demasiado grande o con formato incorrecto rebote. Una nota operativa: la carga de archivos es una función Pro, así que conecta Storage en el panel antes de lanzar este formulario, o el envío no tendrá dónde poner el archivo.

Consejos para un formulario de carga de archivos que simplemente funciona

Deja que el backend sea el dueño del envío multipart. El código generado ya configura enctype y publica el FormData sin procesar, así que el archivo y los campos de texto van juntos en una petición. No construyas un flujo de carga paralelo; el POST directo del navegador a Formpaste es lo que mantiene a tu propia app fuera del negocio de manejar archivos.

Define expectativas antes de la carga, no después. Indica a las personas los tipos aceptados y el tope de tamaño por adelantado. Una línea clara de “PDF o PNG, hasta 10 MB” previene el fallo más frustrante, un formulario completado rechazado en el último segundo por un archivo que nunca iba a funcionar.

Conecta Storage primero. Como las cargas son una función Pro, configura Storage en el panel antes de que este formulario se ponga en marcha. Confirma que una carga de prueba llega donde esperas, para que el primer envío real no sea el momento en que descubres que el destino nunca se configuró.