DOMMatrixReadOnly: rotate() method
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("Geometry Interfaces")}}{{AvailableInWorkers}}
The rotate() method of the {{domxref("DOMMatrixReadOnly")}} interface returns a new {{domxref("DOMMatrix")}} created by rotating the source matrix around each of its axes by the specified number of degrees. The original matrix is not altered.
To mutate the matrix as you rotate it, see {{domxref("DOMMatrix.rotateSelf()")}}.
Syntax
js-nolint
rotate()
rotate(rotX)
rotate(rotX, rotY)
rotate(rotX, rotY, rotZ)Parameters
rotX- : A number; the x-coordinate of the vector denoting the axis of rotation. If non-zero, [
is2D](/en-US/docs/Web/API/DOMMatrixReadOnly/is2D) is false. rotY{{optional_inline}}- : A number; the y-coordinate of the vector denoting the axis of rotation. If non-zero, [
is2D](/en-US/docs/Web/API/DOMMatrixReadOnly/is2D) is false. rotZ{{optional_inline}}- : A number; the z-coordinate of the vector denoting the axis of rotation.
If only rotX is passed, then rotX is used as the value for the z-coordinate, and the x- and -y-coordinates are both set to zero.
Return value
A [DOMMatrix](/en-US/docs/Web/API/DOMMatrix).
Examples
js
const matrix = new DOMMatrix(); // create a matrix
console.log(matrix.toString());
// output: "matrix(1, 0, 0, 1, 0, 0)"
const rotated = matrix.rotate(30); // rotation and assignment
console.log(matrix.toString()); // original matrix is unchanged
// output: "matrix(1, 0, 0, 1, 0, 0)"
console.log(rotated.toString());
// output: "matrix(0.866, 0.5, -0.5, 0.866, 0, 0)"Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- {{domxref("DOMMatrix.rotateSelf()")}}
- {{domxref("DOMMatrixReadOnly.rotateAxisAngle()")}}
- {{domxref("DOMMatrixReadOnly.rotateFromVector()")}}
- CSS {{cssxref("transform")}} property and {{cssxref("transform-function/rotate3d", "rotate3d()")}} function
- CSS {{cssxref("rotate")}} property
- CSS transforms module
- SVG [
transform](/en-US/docs/Web/SVG/Reference/Attribute/transform) attribute - {{domxref("CanvasRenderingContext2D")}} interface and {{domxref("CanvasRenderingContext2D.rotate()", "rotate()")}} method