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.

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.

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.

Specification
Scalable Vector Graphics (SVG) 2 # InterfaceSVGImageElement

This page was last modified on ⁨Mar 26, 2025⁩ by MDN contributors.