SVGImageElement

- No translations exist for this article.
- Add a translation
Edit
Advanced
- History
- Print this article

Jump to:

Properties
Methods
Specifications
Browser compatibility

The SVGImageElement interface corresponds to the <image> element.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 23.333333333333332%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 140" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25  236,20  236,30  226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/Element" target="_top"><rect x="266" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="303.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Element</text></a><polyline points="341,25  351,20  351,30  341,25" stroke="#D4DDE4" fill="none"/><line x1="351" y1="25" x2="381" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/SVGElement" target="_top"><rect x="381" y="1" width="100" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="431" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">SVGElement</text></a><polyline points="481,25  491,20  491,30  481,25" stroke="#D4DDE4" fill="none"/><line x1="491" y1="25" x2="499" y2="25" stroke="#D4DDE4"/><line x1="499" y1="25" x2="499" y2="90" stroke="#D4DDE4"/><line x1="499" y1="90" x2="482" y2="90" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/SVGGraphicsElement" target="_top"><rect x="301" y="65" width="180" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="391" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">SVGGraphicsElement</text></a><polyline points="301,89  291,84  291,94  301,89" stroke="#D4DDE4" fill="none"/><line x1="291" y1="89" x2="261" y2="89" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/en-US/docs/Web/API/SVGImageElement" target="_top"><rect x="111" y="65" width="150" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="186" y="94" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">SVGImageElement</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

Properties

This interface also inherits properties from its parent, SVGGraphicsElement.

SVGImageElement.crossOrigin: A DOMString corresponding to the crossorigin attribute of the given <image> element.
SVGImageElement.decoding: Returns a DOMString representing 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.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.

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

Specification	Status	Comment
Scalable Vector Graphics (SVG) 2 The definition of 'SVGImageElement' in that specification.	Candidate Recommendation	Changed the inheritance from `SVGElement` to `SVGGraphicsElement`, removed the implemented interfaces `SVGTests`, `SVGLangSpace`, `SVGExternalResourcesRequired`, `SVGStylable`, and `SVGTransformable` and added the `crossOrigin` property.
Scalable Vector Graphics (SVG) 1.1 (Second Edition) The definition of 'SVGImageElement' in that specification.	Recommendation	Initial definition

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Edge Mobile	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
Basic support	Chrome Full support 1	Edge Full support Yes	Firefox ?	IE ?	Opera Full support Yes	Safari ?	WebView Android Full support Yes	Chrome Android Full support Yes	Edge Mobile Full support Yes	Firefox Android ?	Opera Android Full support Yes	Safari iOS ?	Samsung Internet Android ?
`crossOrigin`	Chrome No support No	Edge ?	Firefox ?	IE ?	Opera No support No	Safari ?	WebView Android No support No	Chrome Android No support No	Edge Mobile ?	Firefox Android ?	Opera Android No support No	Safari iOS ?	Samsung Internet Android ?
`decode()` Experimental	Chrome Full support 65	Edge ?	Firefox No support No	IE ?	Opera ?	Safari ?	WebView Android Full support 65	Chrome Android Full support 65	Edge Mobile ?	Firefox Android No support No	Opera Android ?	Safari iOS ?	Samsung Internet Android ?
`decoding` Experimental	Chrome Full support 65	Edge ?	Firefox ?	IE ?	Opera ?	Safari ?	WebView Android Full support 65	Chrome Android Full support 65	Edge Mobile ?	Firefox Android ?	Opera Android ?	Safari iOS ?	Samsung Internet Android ?
`height`	Chrome Full support 1	Edge ?	Firefox ?	IE ?	Opera Full support Yes	Safari ?	WebView Android Full support Yes	Chrome Android Full support Yes	Edge Mobile ?	Firefox Android ?	Opera Android Full support Yes	Safari iOS ?	Samsung Internet Android ?
`href`	Chrome Full support 1	Edge ?	Firefox ?	IE ?	Opera ?	Safari ?	WebView Android Full support Yes	Chrome Android Full support Yes	Edge Mobile ?	Firefox Android ?	Opera Android ?	Safari iOS ?	Samsung Internet Android ?
`preserveAspectRatio`	Chrome Full support 1	Edge ?	Firefox ?	IE ?	Opera Full support Yes	Safari ?	WebView Android Full support Yes	Chrome Android Full support Yes	Edge Mobile ?	Firefox Android ?	Opera Android Full support Yes	Safari iOS ?	Samsung Internet Android ?
`width`	Chrome Full support 1	Edge ?	Firefox ?	IE ?	Opera Full support Yes	Safari ?	WebView Android Full support Yes	Chrome Android Full support Yes	Edge Mobile ?	Firefox Android ?	Opera Android Full support Yes	Safari iOS ?	Samsung Internet Android ?
`x`	Chrome Full support 1	Edge ?	Firefox ?	IE ?	Opera Full support Yes	Safari ?	WebView Android Full support Yes	Chrome Android Full support Yes	Edge Mobile ?	Firefox Android ?	Opera Android Full support Yes	Safari iOS ?	Samsung Internet Android ?
`y`	Chrome Full support 1	Edge ?	Firefox ?	IE ?	Opera Full support Yes	Safari ?	WebView Android Full support Yes	Chrome Android Full support Yes	Edge Mobile ?	Firefox Android ?	Opera Android Full support Yes	Safari iOS ?	Samsung Internet Android ?

Legend

Full support: Full support
No support: No support
Compatibility unknown: Compatibility unknown
Experimental. Expect behavior to change in the future.: Experimental. Expect behavior to change in the future.

Document Tags and Contributors

Tags:

Contributors to this page: jpmedley, Sheppy, fscholz, Sebastianz, abbycar, kscarfone, pa7, Jeremie

Last updated by: jpmedley, Feb 6, 2019, 2:17:45 PM