W3cubDocs

/Web APIs

CSSTransformComponent: toMatrix() method

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

js

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 16.4 66 66 No 47 16.4 9.0

© 2005–2023 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