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.
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 HTMLalt
, 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 CSSborder
en su lugar. HTMLImageElement.complete
Read only-
Devuelve un
Boolean
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 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 HTMLheight
, 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 HTMLismap
, 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 HTMLreferrerpolicy
indica la referencia a usar para buscar la imagen. HTMLImageElement.src
-
Es un
DOMString
que refleja el atributo HTMLsrc
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 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 un
DOMString
que refleja el atributo HTMLusemap
, 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 HTMLwidth
, 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 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 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>