CSSTransformComponent: toMatrix() method

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Learn more
See full compatibility
Report feedback

The toMatrix() method of the CSSTransformComponent interface returns a DOMMatrix object.

All transform functions can be represented mathematically as a 4x4 transformation 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

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

Specification
CSS Typed OM Level 1 # dom-csstransformcomponent-tomatrix

Browser compatibility

BCD tables only load in the browser