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.

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

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

js
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
# htmlimageelement

Compatibilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
HTMLImageElement
Image() constructor
align
Deprecated
alt
attributionSrc
Experimental
border
Deprecated
complete
crossOrigin
currentSrc
decode()
decoding
fetchPriority
height
hspace
Deprecated
isMap
loading
longDesc
Deprecated
lowsrc
Deprecated
name
Deprecated
naturalHeight
naturalWidth
referrerPolicy
no-referrer-when-downgrade
origin-when-cross-origin
unsafe-url
sharedStorageWritable
Experimental
sizes
auto value
src
srcset
useMap
vspace
Deprecated
width
x
y

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
Deprecated. Not for use in new websites.
See implementation notes.
Uses a non-standard name.
Has more compatibility info.

Ver también

  • El elemento HTML implementa esta interfaz: <img>