CSSTransformComponent: toMatrix() method

{{APIRef("CSS Typed OM")}}

The toMatrix() method of the {{domxref("CSSTransformComponent")}} interface returns a {{domxref('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 {{domxref('DOMMatrix')}} object

Exceptions

• {{jsxref("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

{{Specifications}}

Browser compatibility

{{Compat}}