Baseline Widely available
Note: This feature is available in Web Workers.
The setMatrixValue()
method of the DOMMatrix
interface replaces the contents of the matrix with the matrix described by the specified transform or transforms, returning itself.
setMatrixValue(transformList)
Parameters
transformList
A string. Its value follows the same syntax as the CSS transform
property value.
Returns itself; the DOMMatrix
with updated values.
In this example, we create a matrix, apply a 3D transform using the DOMMatrix.translateSelf()
method, revert it to a 2D transform using the setMatrixValue()
method, then revert it back to a 3D transform with another setMatrixValue()
method call.
const matrix = new DOMMatrix();
console.log(matrix.toString()); // matrix(1, 0, 0, 1, 0, 0)
console.log(matrix.is2D); // true
matrix.translateSelf(30, 40, 50);
console.log(matrix.toString()); // matrix3d(1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 30, 40, 50, 1)
console.log(matrix.is2D); // false
matrix.setMatrixValue("matrix(1, 0, 0, 1, 15, 45)");
console.log(matrix.toString()); // output: matrix(1, 0, 0, 1, 15, 45)
console.log(matrix.is2D); // true
matrix.setMatrixValue(
"matrix3d(1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 30, 40, 50, 1)",
);
console.log(matrix.toString()); // matrix3d(1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 30, 40, 50, 1)
console.log(matrix.is2D); // false
Specifications Browser compatibility See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4