MDN self-hosted library · e01.org

DOMMatrixReadOnly: isIdentity property

Geometry Interfaces

Open notebook · 1 cells web-api-instance-property upstream source

Geometry Interfaces

The readonly isIdentity property of the DOMMatrixReadOnly interface is a Boolean whose value is true if the matrix is the identity matrix.

The identity matrix is one in which every value is 0 except those on the main diagonal from top-left to bottom-right corner (in other words, where the offsets in each direction are equal).

Value

A Boolean value.

Examples

// Initialize a 2D matrix
const matrix = new DOMMatrix(); // create a matrix
console.log(matrix.isIdentity); // output: true

// Apply a transform that has no effect
console.log(matrix.translate(0).isIdentity); // output: true

// Apply a transform with effect: this rotates the matrix by 30deg
console.log(matrix.rotate(30).isIdentity); // output: false

Specifications

Browser compatibility

See also

  • DOMMatrix interface
  • CSSMatrixComponent interface
  • CanvasRenderingContext2D interface
  • CSS transform-function/matrix() function
  • CSS transform property
  • CSS transforms module
  • SVG transform attribute