DOMMatrix: rotateSelf() 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.

Note: This feature is available inWeb Workers.

TherotateSelf() method of theDOMMatrix interface is a mutable transformation method that modifies a matrix. It rotates the source matrix around each of its axes by the specified number of degrees and returns the rotated matrix.

To rotate a matrix without mutating it, seeDOMMatrixReadOnly.rotate()

Syntax

rotateSelf()rotateSelf(rotX)rotateSelf(rotX, rotY)rotateSelf(rotX, rotY, rotZ)

Parameters

rotX: A number; the x-coordinate of the vector denoting the axis of rotation
rotYOptional: A number; the y-coordinate of the vector denoting the axis of rotation.
rotZOptional: A number; the z-coordinate of the vector denoting the axis of rotation

If only one parameter is passed,rotZ is the value ofrotX, and bothrotX androtY are0, and the rotation is a 2D rotation. IfrotX androtY are non-zero, theis2D isfalse.

Return value

Returns itself; theDOMMatrix rotated by the givenvectors.

Examples

const matrix = new DOMMatrix(); // create a matrixconsole.log(matrix.toString()); // output: "matrix(1, 0, 0, 1, 0, 0)"matrix.rotateSelf(30); // mutate itconsole.log(matrix); // output: "matrix(0.866, 0.5, -0.5, 0.866, 0, 0)"