¿Para qué sirve el atributo download en un enlace?

El atributo download en enlaces HTML («a») sirve para que el navegador descargue el recurso enlazado en vez de navegar a él. Aprende a usarlo y sus opciones.

LucusHost, el mejor hosting

El atributo download se utiliza en las etiquetas de enlace (<a>) de HTML para indicarle al navegador que el recurso al que apunta el atributo href debe ser descargado por el usuario en lugar de que el navegador intente navegar a él y mostrarlo directamente en la ventana o pestaña.

Función Principal del Atributo download

Cuando un usuario hace clic en un enlace que contiene el atributo download, el navegador inicia el proceso de descarga del archivo vinculado. Esto es especialmente útil para ofrecer archivos que no están pensados para ser visualizados directamente en el navegador (como archivos .zip, .exe, .docx) o cuando quieres que el usuario guarde una copia local de un recurso que sí podría visualizarse (como un PDF, una imagen de alta resolución o un archivo de audio).

En esencia, el atributo download cambia el comportamiento predeterminado de un enlace de «navegar a» por «descargar».

¿Cómo se utiliza el atributo download?

El atributo download puede usarse de dos formas principales dentro de la etiqueta <a>:

  1. Como atributo booleano (sin asignar un valor explícito):
    Si simplemente añades el atributo download al enlace, el navegador intentará descargar el archivo utilizando el nombre original del archivo, tal como se infiere de la URL o como lo especifique el servidor a través de la cabecera HTTP Content-Disposition.
    <a href="/recursos/documento_importante.pdf" download> Descargar Documento Importante (PDF) </a> Al hacer clic, el navegador comenzará a descargar documento_importante.pdf.
  2. Con un valor asignado (para sugerir un nombre de archivo):
    Puedes proporcionar un valor al atributo download para sugerir un nombre de archivo específico con el que el usuario debería guardar el recurso.
    Esto es muy útil si deseas que el archivo se guarde con un nombre más descriptivo o diferente al nombre original en el servidor, o si el recurso es generado dinámicamente y su URL no tiene un nombre de archivo claro.
    <a href="/api/generar_reporte.php?id=123" download="reporte_anual_ventas_2025.xlsx"> Descargar Reporte Anual de Ventas (Excel) </a>
    <a href="/imagenes_galeria/IMG_0042.JPG" download="Vacaciones_Playa_Soleada.jpg"> Descargar foto de las vacaciones </a>

Consideraciones Importantes al Usar download

  • Política del Mismo Origen (Same-Origin Policy): El atributo download funciona de manera más fiable y predecible para los archivos que están alojados en el mismo dominio que tu página web.
  • Enlaces de Origen Cruzado (Cross-Origin Links): Para archivos ubicados en dominios diferentes al de tu página, el comportamiento del atributo download puede ser inconsistente entre navegadores debido a políticas de seguridad.
    El navegador podría ignorar el atributo download (especialmente el nombre de archivo sugerido) a menos que el servidor del recurso externo envíe las cabeceras HTTP CORS (Cross-Origin Resource Sharing) adecuadas que permitan este tipo de interacción.
    En muchos casos de recursos de origen cruzado, la cabecera HTTP Content-Disposition: attachment; filename="nombre.ext" enviada por el servidor del recurso tendrá más peso para forzar la descarga y determinar el nombre del archivo.
  • Tipos de Archivo: Puedes usar el atributo download para cualquier tipo de archivo que desees que el usuario pueda descargar fácilmente.

El atributo download es una herramienta sencilla pero muy efectiva para mejorar la experiencia del usuario al ofrecer descargas directas de archivos desde tus páginas web.

¿Tienes alguna duda o pregunta?Envía el formulario y procuraré darle respuesta
Formulario de pregunta
Responsable » Jose Ramón Bernabeu Guillem. Finalidad » Ponernos en contacto. Legitimación » Tu consentimiento al marcar la casilla verificación. Destinatarios » Los datos que proporciones estarán ubicados en los servidores de LucusHost, proveedor de hosting de este sitio. Derechos » por supuesto tendrás derecho, entre otros, a acceder, rectificar, limitar y suprimir tus datos.
Si creees que esto puede ser de utilidad a alguien más, pues... compártelo que es gratis 🙂
Sitio alojado en un servidor verde según The Green Web Foundation

LucusHost, el mejor hosting

Aviso legal | Condiciones de contratación | Política de privacidad | Política de cookies
© 2017-2025 · Jose R. Bernabeu ·
linkedin facebook pinterest youtube rss twitter instagram facebook-blank rss-blank linkedin-blank pinterest youtube twitter instagram