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) Obsoleto-
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 HTMLalt
, indicando texto de respaldo a la imagen. HTMLImageElement.border
(en-US) 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
(en-US) Read only-
Devuelve un
Boolean
(en-US) que estrue
si el navegador ha terminado de buscar la imagen, sea o no exitoso. También devuelvetrue
si la imagen no tiene valorsrc
(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 HTMLheight
, indica el alto de la imagen en píxeles CSS. HTMLImageElement.hspace
(en-US) Obsoleto-
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 HTMLismap
, indica que la imagen es parte del mapa de imagen del lado del servidor. HTMLImageElement.longDesc
(en-US) 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
(en-US) Obsoleto-
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 HTMLreferrerpolicy
indica la referencia a usar para buscar la imagen. HTMLImageElement.src
(en-US)-
Es un
DOMString
que refleja el atributo HTMLsrc
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 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
(en-US)-
Es un
DOMString
que refleja el atributo HTMLusemap
, contiene una URL parcial del mapa del elemento. HTMLImageElement.vspace
(en-US) Obsoleto-
Es un
long
que representa el espacio sobre y bajo la imagen. HTMLImageElement.width
(en-US)-
Es un
unsigned long
que refleja el atributo HTMLwidth
, 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 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>