CSSTransformComponent.toMatrix()
The toMatrix() method of the CSSTransformComponent interface returns a DOMMatrix object.
All transform functions can be represented mathematically as a 4x4 transformation matrix. This is explained in detail in Understanding the CSS Transforms matrix.
Note: The is2D property affects what transform, and therefore type of matrix that will be returned. CSS 2D and 3D transforms are different for legacy reasons. A brief explanation of 2D vs. 3D transforms can be found in Using CSS transforms.
Syntax
var matrix = CSSTransformComponent.toMatrix();
Parameters
None
Return value
A DOMMatrix object
Exceptions
TypeError-
Raised if any lengths involved in generating the matrix are not compatible units with px (such as relative lengths or percentages).
Examples
To Do
Specifications
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
toMatrix |
66 |
79 |
No |
No |
53 |
No |
66 |
66 |
No |
47 |
No |
9.0 |
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/CSSTransformComponent/toMatrix