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 HTML `alt`, 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 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) 
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 HTML `ismap`, 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 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) 
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 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
-------


```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 Standard # htmlimageelement |

Compatibilidad con navegadores
------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Ver también
-----------

* El elemento HTML implementa esta interfaz: `<img>`