SVGImageElement

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.

• Learn more
• See full compatibility
• Report feedback

The SVGImageElement interface corresponds to the <image> element.

Instance properties

This interface also inherits properties from its parent, SVGGraphicsElement.

SVGImageElement.crossOrigin

A string reflecting the crossorigin content attribute, which represents the CORS setting of the given <image> element.

SVGImageElement.decoding

Represents a hint given to the browser on how it should decode the image.

SVGImageElement.height Read only

An SVGAnimatedLength corresponding to the height attribute of the given <image> element.

SVGImageElement.href Read only

An SVGAnimatedString corresponding to the href or xlink:href Deprecated attribute of the given <image> element.

SVGImageElement.preserveAspectRatio Read only

An SVGAnimatedPreserveAspectRatio corresponding to the preserveAspectRatio attribute of the given <image> element.

SVGImageElement.width Read only

An SVGAnimatedLength corresponding to the width attribute of the given <image> element.

SVGImageElement.x Read only

An SVGAnimatedLength corresponding to the x attribute of the given <image> element.

SVGImageElement.y Read only

An SVGAnimatedLength corresponding to the y attribute of the given <image> element.

Instance methods

This interface also inherits methods from its parent interface, SVGGraphicsElement.

SVGImageElement.decode()

Initiates asynchronous decoding of the image data. Returns a Promise which resolves once the image data is ready to be used.

Specifications

Browser compatibility