Web/API/SVGSVGElement

From Get docs


The SVGSVGElement interface provides access to the properties of <svg> elements, as well as methods to manipulate them. This interface contains also various miscellaneous commonly-used utility methods, such as matrix operations and the ability to control the time of redraw on visual rendering devices.

Properties

This interface also inherits properties from its parent, SVGGraphicsElement and also implements the ones from SVGZoomAndPan, SVGFitToViewBox, and WindowEventHandlers.

SVGSVGElement.x Read only
An SVGAnimatedLength corresponding to the x attribute of the given <svg> element.
SVGSVGElement.y Read only
An SVGAnimatedLength corresponding to the y attribute of the given <svg> element.
SVGSVGElement.width Read only
An SVGAnimatedLength corresponding to the width attribute of the given <svg> element.
SVGSVGElement.height Read only
An SVGAnimatedLength corresponding to the height attribute of the given <svg> element.
SVGSVGElement.contentScriptType
An SVGAnimatedLength corresponding to the contentScriptType attribute of the given <svg> element.
SVGSVGElement.contentStyleType
An SVGAnimatedLength corresponding to the contentStyleType attribute of the given <svg> element.
SVGSVGElement.viewport
An SVGRect containing the position and size of the viewport (implicit or explicit) that corresponds to the given <svg> element. When the browser is actually rendering the content, then the position and size values represent the actual values when rendering. The position and size values are unitless values in the coordinate system of the parent element. If no parent element exists (i.e., <svg> element represents the root of the document tree), if this SVG document is embedded as part of another document (e.g., via the HTML <object> element), then the position and size are unitless values in the coordinate system of the parent document. (If the parent uses CSS or XSL layout, then unitless values represent pixel units for the current CSS or XSL viewport.)
SVGSVGElement.pixelUnitToMillimeterX '
A float representing the size of the pixel unit (as defined by CSS2) along the x-axis of the viewport, which represents a unit somewhere in the range of 70dpi to 120dpi, and, on systems that support this, might actually match the characteristics of the target medium. On systems where it is impossible to know the size of a pixel, a suitable default pixel size is provided.
SVGSVGElement.pixelUnitToMillimeterY '
A float representing the size of a pixel unit along the y-axis of the viewport.
SVGSVGElement.screenPixelToMillimeterX '
User interface (UI) events in DOM Level 2 indicate the screen positions at which the given UI event occurred. When the browser actually knows the physical size of a "screen unit", this float attribute will express that information; otherwise, user agents will provide a suitable default value (such as .28mm).
SVGSVGElement.screenPixelToMillimeterY '
Corresponding size of a screen pixel along the y-axis of the viewport.
SVGSVGElement.useCurrentView
The initial view (i.e., before magnification and panning) of the current innermost SVG document fragment can be either the "standard" view, i.e., based on attributes on the <svg> element such as viewBox) or on a "custom" view (i.e., a hyperlink into a particular <view> or other element). If the initial view is the "standard" view, then this attribute is false. If the initial view is a "custom" view, then this attribute is true.
SVGSVGElement.currentView
An SVGViewSpec defining the initial view (i.e., before magnification and panning) of the current innermost SVG document fragment. The meaning depends on the situation: If the initial view was a "standard" view, then:
  • the values for viewBox, preserveAspectRatio and zoomAndPan within currentView will match the values for the corresponding DOM attributes that are on SVGSVGElement directly
  • the values for transform and viewTarget within currentView will be null

If the initial view was a link into a <view> element, then:

  • the values for viewBox, preserveAspectRatio and zoomAndPan within currentView will correspond to the corresponding attributes for the given <view> element
  • the values for transform and viewTarget within currentView will be null

If the initial view was a link into another element (i.e., other than a <view>), then:

  • the values for viewBox, preserveAspectRatio and zoomAndPan within currentView will match the values for the corresponding DOM attributes that are on SVGSVGElement directly for the closest ancestor <svg> element
  • the values for transform within currentView will be null
  • the viewTarget within currentView will represent the target of the link

If the initial view was a link into the SVG document fragment using an SVG view specification fragment identifier (i.e., #svgView(…)), then:

  • the values for viewBox, preserveAspectRatio, zoomAndPan, transform and viewTarget within currentView will correspond to the values from the SVG view specification fragment identifier
SVGSVGElement.currentScale
On an outermost <svg> element, this float attribute indicates the current scale factor relative to the initial view to take into account user magnification and panning operations. DOM attributes currentScale and currentTranslate are equivalent to the 2×3 matrix [a b c d e f] = [currentScale 0 0 currentScale currentTranslate.x currentTranslate.y]. If "magnification" is enabled (i.e., zoomAndPan="magnify"), then the effect is as if an extra transformation were placed at the outermost level on the SVG document fragment (i.e., outside the outermost <svg> element).
SVGSVGElement.currentTranslate Read only
An SVGPoint representing the translation factor that takes into account user "magnification" corresponding to an outermost <svg> element. The behavior is undefined for <svg> elements that are not at the outermost level.

Methods

This interface also inherits methods from its parent, SVGGraphicsElement and also implements the ones from SVGZoomAndPan, SVGFitToViewBox, and WindowEventHandlers.

SVGSVGElement.suspendRedraw() '

Takes a time-out value which indicates that redraw shall not occur until:

the corresponding unsuspendRedraw() call has been made, an unsuspendRedrawAll() call has been made, or its timer has timed out.

In environments that do not support interactivity (e.g., print media), then redraw shall not be suspended. Calls to suspendRedraw() and unsuspendRedraw() should, but need not be, made in balanced pairs.

To suspend redraw actions as a collection of SVG DOM changes occur, precede the changes to the SVG DOM with a method call similar to:

const suspendHandleID = suspendRedraw(maxWaitMilliseconds)

and follow the changes with a method call similar to:

unsuspendRedraw(suspendHandleID)

Note that multiple suspendRedraw() calls can be used at once, and that each such method call is treated independently of the other suspendRedraw() method calls.

SVGSVGElement.unsuspendRedraw() '
Cancels a specified suspendRedraw() by providing a unique suspend handle ID that was returned by a previous suspendRedraw() call.
SVGSVGElement.unsuspendRedrawAll() '
Cancels all currently active suspendRedraw() method calls. This method is most useful at the very end of a set of SVG DOM calls to ensure that all pending suspendRedraw() method calls have been cancelled.
SVGSVGElement.forceRedraw() '
In rendering environments supporting interactivity, forces the user agent to immediately redraw all regions of the viewport that require updating.
SVGSVGElement.pauseAnimations()
Suspends (i.e., pauses) all currently running animations that are defined within the SVG document fragment corresponding to this <svg> element, causing the animation clock corresponding to this document fragment to stand still until it is unpaused.
SVGSVGElement.unpauseAnimations()
Unsuspends (i.e., unpauses) currently running animations that are defined within the SVG document fragment, causing the animation clock to continue from the time at which it was suspended.
SVGSVGElement.animationsPaused()
Returns true if this SVG document fragment is in a paused state.
SVGSVGElement.getCurrentTime()
Returns the current time in seconds relative to the start time for the current SVG document fragment. If getCurrentTime() is called before the document timeline has begun (for example, by script running in a <script> element before the document's SVGLoad event is dispatched), then 0 is returned.
SVGSVGElement.setCurrentTime()
Adjusts the clock for this SVG document fragment, establishing a new current time. If setCurrentTime() is called before the document timeline has begun (for example, by script running in a <script> element before the document's SVGLoad event is dispatched), then the value of seconds in the last invocation of the method gives the time that the document will seek to once the document timeline has begun.
SVGSVGElement.getIntersectionList()
Returns a NodeList of graphics elements whose rendered content intersects the supplied rectangle. Each candidate graphics element is to be considered a match only if the same graphics element can be a target of pointer events as defined in pointer-events processing.
SVGSVGElement.getEnclosureList()
Returns a NodeList of graphics elements whose rendered content is entirely contained within the supplied rectangle. Each candidate graphics element is to be considered a match only if the same graphics element can be a target of pointer events as defined in pointer-events processing.
SVGSVGElement.checkIntersection()
Returns true if the rendered content of the given element intersects the supplied rectangle. Each candidate graphics element is to be considered a match only if the same graphics element can be a target of pointer events as defined in pointer-events processing.
SVGSVGElement.checkEnclosure()
Returns true if the rendered content of the given element is entirely contained within the supplied rectangle. Each candidate graphics element is to be considered a match only if the same graphics element can be a target of pointer events as defined in pointer-events processing.
SVGSVGElement.deselectAll()
Unselects any selected objects, including any selections of text strings and type-in bars.
SVGSVGElement.createSVGNumber()
Creates an SVGNumber object outside of any document trees. The object is initialized to 0.
SVGSVGElement.createSVGLength()
Creates an SVGLength object outside of any document trees. The object is initialized to 0 user units.
SVGSVGElement.createSVGAngle()
Creates an SVGAngle object outside of any document trees. The object is initialized to a value of 0 degrees (unitless).
SVGSVGElement.createSVGPoint()
Creates an SVGPoint object outside of any document trees. The object is initialized to the point (0,0) in the user coordinate system.
SVGSVGElement.createSVGMatrix()
Creates an SVGMatrix object outside of any document trees. The object is initialized to the identity matrix.
SVGSVGElement.createSVGRect()
Creates an SVGRect object outside of any document trees. The object is initialized such that all values are set to 0 user units.
SVGSVGElement.createSVGTransform()
Creates an SVGTransform object outside of any document trees. The object is initialized to an identity matrix transform (SVG_TRANSFORM_MATRIX).
SVGSVGElement.createSVGTransformFromMatrix()
Creates an SVGTransform object outside of any document trees. The object is initialized to the given matrix transform (i.e., SVG_TRANSFORM_MATRIX). The values from the parameter matrix are copied, the matrix parameter is not adopted as SVGTransform::matrix.
SVGSVGElement.getElementById()
Searches this SVG document fragment (i.e., the search is restricted to a subset of the document tree) for an Element whose id is given by elementId. If an Element is found, that Element is returned. If no such element exists, returns null. Behavior is not defined if more than one element has this id.

Specifications

Specification Status Comment
Scalable Vector Graphics (SVG) 2The definition of 'SVGSVGElement' in that specification. Candidate Recommendation Replaced the inheritance from SVGElement by SVGGraphicsElement, removed the implemented interfaces SVGTests, SVGLangSpace, SVGExternalResourcesRequired, SVGStylable, SVGLocatable, DocumentEvent, ViewCSS, and DocumentCSS and added implemented interface WindowEventHandlers.
Scalable Vector Graphics (SVG) 1.1 (Second Edition)The definition of 'SVGSVGElement' 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 Firefox for Android Opera for Android Safari on iOS Samsung Internet
SVGSVGElement Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

Full support 9

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

animationsPaused Chrome

?

Edge

?

Firefox

?

IE

No support No

Opera

?

Safari

?

WebView Android

?

Chrome Android

?

Firefox Android

?

Opera Android

?

Safari iOS

?

Samsung Internet Android

?

checkEnclosure Chrome

Full support Yes

Edge

Full support 12

Firefox

No support No

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

No support No

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

checkIntersection Chrome

Full support Yes

Edge

Full support 12

Firefox

No support No

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

No support No

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

contentScriptType Chrome

?

Edge

Full support 12

Firefox

No support ? — 20

IE

?

Opera

?

Safari

?

WebView Android

?

Chrome Android

?

Firefox Android

?

Opera Android

?

Safari iOS

?

Samsung Internet Android

?

contentStyleType Chrome

?

Edge

Full support 12

Firefox

No support ? — 20

IE

?

Opera

?

Safari

?

WebView Android

?

Chrome Android

?

Firefox Android

?

Opera Android

?

Safari iOS

?

Samsung Internet Android

?

createSVGAngle Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

createSVGLength Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

createSVGMatrix Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

createSVGNumber Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

createSVGPoint Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

createSVGRect Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

createSVGTransform Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

createSVGTransformFromMatrix Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

currentScale Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

currentTranslate Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

currentView Chrome

No support ? — 56

Edge

No support No

Firefox

Full support Yes

IE

?

Opera

No support ? — 43

Safari

?

WebView Android

No support ? — 56

Chrome Android

No support ? — 56

Firefox Android

Full support Yes

Opera Android

No support ? — 43

Safari iOS

?

Samsung Internet Android

No support ? — 6.0

deselectAll Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

forceRedraw

Deprecated'

Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

getCurrentTime Chrome

?

Edge

Full support 12

Firefox

?

IE

?

Opera

?

Safari

?

WebView Android

?

Chrome Android

?

Firefox Android

?

Opera Android

?

Safari iOS

?

Samsung Internet Android

?

getElementById Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support 11

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

getEnclosureList Chrome

Full support Yes

Edge

Full support 12

Firefox

No support No

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

No support No

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

getIntersectionList Chrome

Full support Yes

Edge

Full support 12

Firefox

No support No

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

No support No

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

height Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

pauseAnimations Chrome

?

Edge

Full support 12

Firefox

?

IE

?

Opera

?

Safari

?

WebView Android

?

Chrome Android

?

Firefox Android

?

Opera Android

?

Safari iOS

?

Samsung Internet Android

?

pixelUnitToMillimeterX

Deprecated'

Chrome

No support ? — 47

Edge

No support 12 — 79

Firefox

No support ? — 61

IE

?

Opera

No support ? — 33

Safari

?

WebView Android

No support ? — 47

Chrome Android

No support ? — 47

Firefox Android

No support ? — 61

Opera Android

No support ? — 33

Safari iOS

?

Samsung Internet Android

No support ? — 5.0

pixelUnitToMillimeterY

Deprecated'

Chrome

No support ? — 47

Edge

No support 12 — 79

Firefox

No support ? — 61

IE

?

Opera

No support ? — 33

Safari

?

WebView Android

No support ? — 47

Chrome Android

No support ? — 47

Firefox Android

No support ? — 61

Opera Android

No support ? — 33

Safari iOS

?

Samsung Internet Android

No support ? — 5.0

screenPixelToMillimeterX

Deprecated'

Chrome

No support ? — 47

Edge

No support 12 — 79

Firefox

No support ? — 61

IE

?

Opera

No support ? — 33

Safari

?

WebView Android

No support ? — 47

Chrome Android

No support ? — 47

Firefox Android

No support ? — 61

Opera Android

No support ? — 33

Safari iOS

?

Samsung Internet Android

No support ? — 5.0

screenPixelToMillimeterY

Deprecated'

Chrome

No support ? — 47

Edge

No support 12 — 79

Firefox

No support ? — 61

IE

?

Opera

No support ? — 33

Safari

?

WebView Android

No support ? — 47

Chrome Android

No support ? — 47

Firefox Android

No support ? — 61

Opera Android

No support ? — 33

Safari iOS

?

Samsung Internet Android

No support ? — 5.0

setCurrentTime Chrome

?

Edge

Full support 12

Firefox

?

IE

?

Opera

?

Safari

?

WebView Android

?

Chrome Android

?

Firefox Android

?

Opera Android

?

Safari iOS

?

Samsung Internet Android

?

suspendRedraw

Deprecated'

Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

unpauseAnimations Chrome

?

Edge

Full support 12

Firefox

?

IE

?

Opera

?

Safari

?

WebView Android

?

Chrome Android

?

Firefox Android

?

Opera Android

?

Safari iOS

?

Samsung Internet Android

?

unsuspendRedraw

Deprecated'

Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

unsuspendRedrawAll

Deprecated'

Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

useCurrentView Chrome

No support ? — 56

Edge

No support No

Firefox

Full support 15

IE

?

Opera

No support ? — 43

Safari

?

WebView Android

No support ? — 56

Chrome Android

No support ? — 56

Firefox Android

Full support 15

Opera Android

No support ? — 43

Safari iOS

?

Samsung Internet Android

No support ? — 6.0

viewport Chrome

?

Edge

Full support 12

Firefox

?

IE

?

Opera

?

Safari

?

WebView Android

?

Chrome Android

?

Firefox Android

?

Opera Android

?

Safari iOS

?

Samsung Internet Android

?

width Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

x Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

y Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
Deprecated. Not for use in new websites.'
Deprecated. Not for use in new websites.


See also