HTMLImageElement

Baseline Widely available

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

io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/es/web/api/html_dom_api/index.md)

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 Obsoleto: Es un DOMString que indica el alineamiento de la imagen respecto al contexto que la rodea.
HTMLImageElement.alt: Es un DOMString que refleja el atributo HTML alt, indicando texto de respaldo a la imagen.
HTMLImageElement.border Obsoleto: 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 Read only: Devuelve un Boolean 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.
HTMLImageElement.crossOrigin: Es un DOMString representa la configuración CORS para el elemento imagen. Ver Atributos de configuración CORS para más detalles.
HTMLImageElement.currentSrc Read only Experimental: Devuelve un DOMString
HTMLImageElement.height: Es un unsigned long que refleja el atributo HTML height, indica el alto de la imagen en píxeles CSS.
HTMLImageElement.hspace Obsoleto: Es un long que representa el espacio a izquierda y derecha de la imagen.
HTMLImageElement.isMap: Es un Boolean que refleja el atributo HTML ismap, indica que la imagen es parte del mapa de imagen del lado del servidor.
HTMLImageElement.longDesc Obsoleto: Es un DOMString que representa la URI de una larga descripción de la imagen.
HTMLImageElement.lowSrc Obsoleto: Es un DOMString que referencia una copia de la imagen en mala calidad (pero más rápida cargando)
HTMLImageElement.name Obsoleto: Es un DOMString.
HTMLImageElement.naturalHeight 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 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 Experimental: Es un DOMString que refleja el atributo HTML referrerpolicy indica la referencia a usar para buscar la imagen.
HTMLImageElement.src: 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 Experimental: Es un DOMString
HTMLImageElement.srcset 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: Es un DOMString que refleja el atributo HTML usemap, contiene una URL parcial del mapa del elemento.
HTMLImageElement.vspace Obsoleto: Es un long que representa el espacio sobre y bajo la imagen.
HTMLImageElement.width: Es un unsigned long que refleja el atributo HTML width, indica el ancho de la imagen en píxeles CSS.
HTMLImageElement.x 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 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);

Especificaciones

Specification
HTML Standard # htmlimageelement

Compatibilidad con navegadores

BCD tables only load in the browser

Ver también

El elemento HTML implementa esta interfaz: <img>