CKTIS / HTML
img — insertar una imagen
El elemento img inserta una imagen en un documento HTML. Los atributos src y srcset indican los recursos, mientras que alt proporciona un texto que sustituye la información que transmite la imagen.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
<img src="image-url" alt="text alternative" width="160" height="100">img representa una imagen. Es un elemento vacío: no tiene contenido hijo ni etiqueta de cierre. Se requiere al menos uno de los atributos src o srcset; src debe contener una URL de imagen no vacía.
Normalmente, proporciona un atributo alt que transmita el significado de la imagen en su contexto, en lugar del nombre del archivo. Para una imagen puramente decorativa, usa alt="". La ausencia de alt no equivale a un texto alternativo vacío; solo se permite omitirlo en los casos limitados que define el estándar.
width y height ayudan al navegador a reservar espacio antes de que se cargue la imagen. srcset ofrece alternativas para que el navegador elija. Con descriptores de anchura w, se requiere sizes a menos que el elemento img permita determinar el tamaño automáticamente. Por ejemplo, con loading="lazy", que permite aplazar la carga de la imagen, se puede omitir sizes.
El ejemplo inserta una imagen SVG en una URL data:, así que no necesita un archivo independiente ni conexión de red. El resultado esperado es un rectángulo azul de 160 × 100 píxeles CSS.
Ejemplos
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Image example</title>
<img
src="data:image/svg+xml,%3Csvg%20xmlns='http://www.w3.org/2000/svg'%20width='160'%20height='100'%3E%3Crect%20width='160'%20height='100'%20fill='blue'/%3E%3C/svg%3E"
alt="Blue rectangle"
width="160"
height="100">
</html>Resultado
A blue rectangle, 160 CSS pixels wide and 100 CSS pixels high.
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.