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.

TheSVGImageElement interface corresponds to the<image> element.

Instance properties

This interface also inherits properties from its parent,SVGGraphicsElement.

SVGImageElement.crossOrigin: A string reflecting thecrossorigin 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.heightRead only: AnSVGAnimatedLength corresponding to theheight attribute of the given<image> element.
SVGImageElement.hrefRead only: AnSVGAnimatedString corresponding to thehref orxlink:hrefDeprecated attribute of the given <image> element.
SVGImageElement.preserveAspectRatioRead only: AnSVGAnimatedPreserveAspectRatio corresponding to thepreserveAspectRatio attribute of the given<image> element.
SVGImageElement.widthRead only: AnSVGAnimatedLength corresponding to thewidth attribute of the given<image> element.
SVGImageElement.xRead only: AnSVGAnimatedLength corresponding to thex attribute of the given<image> element.
SVGImageElement.yRead only: AnSVGAnimatedLength corresponding to they 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 aPromise 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⁩ byMDN contributors.