HTMLImageElement

La interfaz HTMLImageElement provee de propiedas especiales y métodos (más allá de las interfaces HTMLElement, 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.align (en-US): Es un DOMString que indica el alineamiento de la imagen respecto al contexto que la rodea.
HTMLImageElement.alt (en-US): Es un DOMString que refleja el atributo HTML alt, indicando texto de respaldo a la imagen.
HTMLImageElement.border (en-US): Es un DOMString que indica el ancho del borde alrededor de la imagen. Este está desaprobado y debe usarse la propiedad CSS border en su lugar.
HTMLImageElement.complete (en-US) Read only: Devuelve un Boolean (en-US) que es true si el navegador ha terminado de buscar la imagen, sea o no exitoso. También devuelve true si la imagen no tiene valor src (en-US).
HTMLImageElement.crossOrigin (en-US): Es un DOMString representa la configuración CORS para el elemento imagen. Ver Atributos de configuración CORS para más detalles.
HTMLImageElement.currentSrc (en-US) Read only Experimental: Devuelve un DOMString
HTMLImageElement.height (en-US): Es un unsigned long que refleja el atributo HTML height, indica el alto de la imagen en píxeles CSS.
HTMLImageElement.hspace (en-US): Es un long que representa el espacio a izquierda y derecha de la imagen.
HTMLImageElement.isMap (en-US): Es un Boolean (en-US) que refleja el atributo HTML ismap, indica que la imagen es parte del mapa de imagen del lado del servidor.
HTMLImageElement.longDesc (en-US): Es un DOMString que representa la URI de una larga descripción de la imagen.
HTMLImageElement.lowSrc: Es un DOMString que referencia una copia de la imagen en mala calidad (pero más rápida cargando)
HTMLImageElement.name (en-US): Es un DOMString.
HTMLImageElement.naturalHeight (en-US) Read only: Devuelve un unsigned long que representa el alto intrínseco de la imagen en píxeles CSS, si está disponible, de otro modo, es 0.
HTMLImageElement.naturalWidth (en-US) Read only: Devuelve un unsigned long que representa el ancho intrínseco de la imagen en píxeles CSS, si está disponible, de otro modo, es 0.
HTMLImageElement.referrerPolicy (en-US) Experimental: Es un DOMString que refleja el atributo HTML referrerpolicy indica la referencia a usar para buscar la imagen.
HTMLImageElement.src (en-US): Es un DOMString que refleja el atributo HTML src HTML attribute, contiene la URL completa de la imagen, incluido la base del URI
HTMLImageElement.sizes (en-US) Experimental: Es un DOMString
HTMLImageElement.srcset (en-US) Experimental: Es un DOMString que refleja el atributo HTML srcset, 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 (en-US): Es un DOMString que refleja el atributo HTML usemap, contiene una URL parcial del mapa del elemento.
HTMLImageElement.vspace (en-US): Es un long que representa el espacio sobre y bajo la imagen.
HTMLImageElement.width (en-US): Es un unsigned long que refleja el atributo HTML width, indica el ancho de la imagen en píxeles CSS.
HTMLImageElement.x (en-US) Read only Experimental: Devuelve un long que representa el hueco horizontal hasta la capa más cercana. Esta propiedad copia el comportamiento de Netscape 4.
HTMLImageElement.y (en-US) Read only Experimental: Devuelve un long 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 constructor Image(), toma dos unsigned long opcionales, ancho y alto del recurso, crea una instacia de creates HTMLImageElement no insertada en el árbol DOM.

Ejemplo

var img1 = new Image(); // HTML5 Constructor
img1.src = 'image1.png';
img1.alt = 'alt';
document.body.appendChild(img1);

var img2 = document.createElement('img'); // Uso DOM HTMLImageElement
img2.src = 'image2.jpg';
img2.alt = 'alt text';
document.body.appendChild(img2);

// Usando la primera imagen en el documento
alert(document.images[0].src);

Especificiaciones

Especicifación	Estado	Comentario
Referrer Policy La definición de 'referrer attribute' en esta especificación.	Candidate Recommendation	Añadida la propiedad `referrerPolicy`.
CSS Object Model (CSSOM) View Module La definición de 'Extensions to HTMLImageElement' en esta especificación.	Working Draft	Añadidas propiedades `x` e `y`
HTML Living Standard La definición de 'HTMLImageElement' en esta especificación.	Living Standard	Las siguientes propiedades han sido añadidas: `srcset`, `currentSrc` y `sizes`.
HTML5 La definición de 'HTMLImageElement' en esta especificación.	Recommendation	Un constructor (con 2 parámetros opcionales) añadido. Las siguientes propiedades quedaron obsoletas: `name`, `border`, `align`, `hspace`, `vspace`, y `longdesc`. Las siguientes propiedades son ahora `unsigned long`, en lugar de `long`: `height`, y width.Las siguientes propiedades fueron añadidas: `crossorigin`, `naturalWidth`, `naturalHeight`, `y` `complete`.
Document Object Model (DOM) Level 2 HTML Specification La definición de 'HTMLImgElement' en esta especificación.	Obsolete	La propiedad `lowSrc` fue eliminada. Las siguientes propiedades son ahora `long`, en lugar de `DOMString`: `height`, `width`, `hspace`, y `vspace`.
Document Object Model (DOM) Level 1 Specification La definición de 'HTMLImgElement' en esta especificación.	Obsolete	Definición inicial.

Compatibilidad con navegador

BCD tables only load in the browser

Ver también

El elemento HTML implementa esta interfaz: <img>