HTMLImageElement

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.

La interfazHTMLImageElement provee de propiedas especiales y métodos (más allá de las interfacesHTMLElement, también tiene disponible la herencia) para manipular el diseño y la presentación de elementos<img>.

Propiedades

Heredadas de su padre,HTMLElement.

HTMLImageElement.alignObsoleto: Es un DOMString que indica el alineamiento de la imagen respecto al contexto que la rodea.
HTMLImageElement.alt: Es unDOMString que refleja el atributo HTMLalt, indicando texto de respaldo a la imagen.
HTMLImageElement.borderObsoleto: Es un DOMString que indica el ancho del borde alrededor de la imagen. Este está desaprobado y debe usarse la propiedad CSSborder en su lugar.
HTMLImageElement.completeRead only: Devuelve unBoolean que estrue si el navegador ha terminado de buscar la imagen, sea o no exitoso. También devuelvetrue si la imagen no tiene valorsrc.
HTMLImageElement.crossOrigin: Es unDOMString representa la configuración CORS para el elemento imagen. VerAtributos de configuración CORS para más detalles.
HTMLImageElement.currentSrcRead onlyExperimental: Devuelve un DOMString
HTMLImageElement.height: Es ununsigned long que refleja el atributo HTMLheight, indica el alto de la imagen en píxeles CSS.
HTMLImageElement.hspaceObsoleto: Es unlong que representa el espacio a izquierda y derecha de la imagen.
HTMLImageElement.isMap: Es unBoolean que refleja el atributo HTMLismap, indica que la imagen es parte del mapa de imagen del lado del servidor.
HTMLImageElement.longDescObsoleto: Es un DOMString que representa la URI de una larga descripción de la imagen.
HTMLImageElement.lowSrcObsoleto: Es un DOMString que referencia una copia de la imagen en mala calidad (pero más rápida cargando)
HTMLImageElement.nameObsoleto: Es un DOMString.
HTMLImageElement.naturalHeightRead only: Devuelve ununsigned long que representa el alto intrínseco de la imagen en píxeles CSS, si está disponible, de otro modo, es 0.
HTMLImageElement.naturalWidthRead only: Devuelve ununsigned long que representa el ancho intrínseco de la imagen en píxeles CSS, si está disponible, de otro modo, es 0.
HTMLImageElement.referrerPolicyExperimental: Es un DOMString que refleja el atributo HTMLreferrerpolicy indica la referencia a usar para buscar la imagen.
HTMLImageElement.src: Es unDOMString que refleja el atributo HTMLsrc HTML attribute, contiene la URL completa de la imagen, incluido la base del URI
HTMLImageElement.sizesExperimental: Es un DOMString
HTMLImageElement.srcsetExperimental: Es un DOMString que refleja el atributo HTMLsrcset, contiene una ista de imágenes candidatas, separadas por una coma (',', U+002C COMMA). Una imagen candidata es una URL seguida por'w' con el ancho, o una'x' seguida de la densidad del píxel.
HTMLImageElement.useMap: Es unDOMString que refleja el atributo HTMLusemap, contiene una URL parcial del mapa del elemento.
HTMLImageElement.vspaceObsoleto: Es unlong que representa el espacio sobre y bajo la imagen.
HTMLImageElement.width: Es ununsigned long que refleja el atributo HTMLwidth, indica el ancho de la imagen en píxeles CSS.
HTMLImageElement.xRead onlyExperimental: Devuelve unlong que representa el hueco horizontal hasta la capa más cercana. Esta propiedad copia el comportamiento de Netscape 4.
HTMLImageElement.yRead onlyExperimental: Devuelve unlong que representa el hueco vertical hasta la capa más cercana. Esta propiedad copia el comportamiento de Netscape 4.

Métodos

Heredados de su padre,HTMLElement.

Image(): El constructorImage(), toma dosunsigned long opcionales, ancho y alto del recurso, crea una instacia de createsHTMLImageElement no insertada en el árbol DOM.

Ejemplo

var img1 = new Image(); // HTML5 Constructorimg1.src = "image1.png";img1.alt = "alt";document.body.appendChild(img1);var img2 = document.createElement("img"); // Uso DOM HTMLImageElementimg2.src = "image2.jpg";img2.alt = "alt text";document.body.appendChild(img2);// Usando la primera imagen en el documentoalert(document.images[0].src);