1. Web
  2. HTML
  3. Referencia
  4. Elementos
  5. <img>

Esta página ha sido traducida del inglés por la comunidad. Aprende más y únete a la comunidad de MDN Web Docs.

View in English Always switch to English

<img> elemento HTML de imagen incrustada

Baseline
Widely available
*

This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.

* Some parts of this feature may have varying levels of support.

El elemento <img> de HTML incrusta una imagen en el documento.

Pruébalo

<img
  class="fit-picture"
  src="/shared-assets/images/examples/grapefruit-slice.jpg"
  alt="Rodaja de pomelo sobre un montón de otras rodajas" />

.fit-picture {
  width: 250px;
}

Atributos

Este elemento incluye los atributos globales.

alt

Define el texto que puede sustituir a la imagen en la página.

Nota: Los navegadores no siempre muestran las imágenes. Hay varias situaciones en las que un navegador podría no mostrarlas, por ejemplo:

  • Navegadores no visuales (como los que usan las personas con discapacidad visual)
  • El usuario elige no mostrar imágenes (para ahorrar ancho de banda o por motivos de privacidad)
  • La imagen no es válida o tiene un tipo no admitido

En estos casos, el navegador puede sustituir la imagen por el texto del atributo alt del elemento. Por estas y otras razones, proporciona siempre que puedas un valor útil para alt.

Establecer este atributo como una cadena vacía (alt="") indica que la imagen no es una parte clave del contenido (es decorativa o un píxel de seguimiento), y que los navegadores no visuales pueden omitirla del renderizado. Los navegadores visuales también ocultan el icono de imagen rota cuando el atributo alt está vacío y la imagen no se pudo mostrar.

Este atributo también se usa al copiar y pegar la imagen como texto, o al guardar una imagen enlazada como marcador.

attributionsrc

Especifica que quieres que el navegador envíe una cabecera Attribution-Reporting-Eligible junto con la petición de la imagen.

En el lado del servidor, esto se usa para activar el envío de una cabecera Attribution-Reporting-Register-Source o Attribution-Reporting-Register-Trigger en la respuesta, con el fin de registrar una fuente de atribución o un disparador de atribución basados en imagen, respectivamente. Qué cabecera de respuesta debe enviarse depende del valor de la cabecera Attribution-Reporting-Eligible que activó el registro.

El evento de fuente o disparador correspondiente se desencadena una vez que el navegador recibe la respuesta que contiene el archivo de imagen.