ImageElement

EventTarget → Node → DOMElement → Element → js.html.ImageElement (extern class) → Image

The HTMLImageElement interface provides special properties and methods  for manipulating the layout and presentation of img elements.

Documentation HTMLImageElement by Mozilla Contributors, licensed under CC-BY-SA 2.5.

See:

Instance Members

alt: String

Is a DOMString that reflects the alt HTML attribute,  thus indicating fallback context for the image.

src: String

Is a DOMString that reflects the src HTML attribute, containing the full URL of the image including base URI.

srcset: String

Is a DOMString reflecting the srcset HTML attribute, containing a list of candidate images, separated by a comma (',', U+002C COMMA). A candidate image is a URL followed by a 'w' with the width of the images, or an 'x' followed by the pixel density.

crossOrigin: String

Is a DOMString representing the CORS setting for this image element. See CORS settings attributes for further details.

useMap: String

Is a DOMString that reflects the usemap HTML attribute, containing a partial URL of a map element.

referrerPolicy: String

Is a DOMString that reflects the referrerpolicy HTML attribute indicating which referrer to use in order to fetch the image.

isMap: Bool

Is a Boolean that reflects the ismap HTML attribute, indicating that the image is part of a server-side image map.

width: Int

Is a unsigned long that reflects the width HTML attribute, indicating the rendered width of the image in CSS pixels.

height: Int

Is a unsigned long that reflects the height HTML attribute, indicating the rendered height of the image in CSS pixels.

decoding: String

Returns a DOMString representing a hint given to the browser on how it should decode the image.

naturalWidth: Int

Returns a unsigned long representing the intrinsic width of the image in CSS pixels, if it is available; otherwise, it will show 0.

naturalHeight: Int

Returns a unsigned long representing the intrinsic height of the image in CSS pixels, if it is available; else, it shows 0.

complete: Bool

Returns a Boolean that is true if the browser has finished fetching the image, whether successful or not. It also shows true, if the image has no HTMLImageElement.src value.

name: String

Is a DOMString representing the name of the element.

align: String

Is a DOMString indicating the alignment of the image with respect to the surrounding context. The possible values are "left", "right", "justify", and "center".

hspace: Int

Is a long representing the space on either side of the image.

vspace: Int

Is a long representing the space above and below the image.

longDesc: String

Is a DOMString representing the URI of a long description of the image.

border: String

Is a DOMString that is responsible for the width of the border surrounding the image. This is now deprecated and the CSS border property should be used instead.

sizes: String

Is a DOMString reflecting the sizes HTML attribute.

currentSrc: String

Returns a DOMString representing the URL to the currently displayed image (which may change, for example in response to media queries).

lowsrc: String

Is a DOMString that refers to a low-quality (but faster to load) copy of the image.

x: Int

Returns a long representing the horizontal offset from the nearest layer. This property mimics an old Netscape 4 behavior.

y: Int

Returns a long representing the vertical offset from the nearest layer. This property is also similar to behavior of an old Netscape 4.