SVGTransform: setMatrix() method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
The setMatrix()
method of the SVGTransform
interface sets the transform type to SVG_TRANSFORM_MATRIX
, with parameter matrix
defining the new transformation.
Note that the values from the parameter matrix
are copied, meaning changes to the matrix
object after calling this method will not affect the transformation.
Syntax
js
setMatrix(matrix)
Parameters
Return value
None (undefined
).
Exceptions
NoModificationAllowedError
DOMException
-
Thrown if the attribute or the
SVGTransform
object is read-only.
Examples
Setting a Transformation Matrix
js
// Get an SVG element and create a transform object
const svgElement = document.querySelector("svg");
const transform = svgElement.createSVGTransform();
// Create a DOMMatrix with specific values
const matrix = new DOMMatrix();
matrix.a = 1; // Scale X
matrix.d = 1; // Scale Y
matrix.e = 50; // Translate X
matrix.f = 50; // Translate Y
// Set the transform to the new matrix
transform.setMatrix(matrix);
console.dir(transform.matrix); // Output: SVGMatrix { a: 1, b: 0, c: 0, d: 1, e: 50, f: 50 }
Specifications
Specification |
---|
Scalable Vector Graphics (SVG) 2 # __svg__SVGTransform__setMatrix |
Browser compatibility
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
setMatrix |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.