SVGTransformList: consolidate() Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Die consolidate()-Methode der SVGTransformList-Schnittstelle konsolidiert die Liste der einzelnen SVGTransform-Objekte, indem die entsprechenden Transformationsmatrizen multipliziert werden, um eine Liste zu erhalten, die aus einem einzigen SVGTransform-Objekt des Typs SVG_TRANSFORM_MATRIX besteht.

Die Konsolidierungsoperation erstellt ein neues SVGTransform-Objekt als das erste und einzige Element in der Liste.

Das zurückgegebene Element ist das Element selbst und keine Kopie. Alle Änderungen an dem Element werden sofort in der Liste reflektiert.

Syntax

consolidate()

NoModificationAllowedError DOMException: Wird ausgelöst, wenn SVGTransformList einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.

Beispiele

Konsolidierung von Transformationen

html

<svg width="200" height="200">
  <rect
    width="100"
    height="100"
    fill="red"
    transform="translate(50,50) rotate(45)" />
</svg>

const svgElement = document.querySelector("svg");
const rectElement = svgElement.querySelector("rect");

// Access the transform list of the <rect> element
const transformList = rectElement.transform.baseVal;

// Consolidate the transformations
const consolidatedTransform = transformList.consolidate();

console.dir(consolidatedTransform); // Output: SVGTransform { type: 1, matrix: SVGMatrix, angle: 0 }
console.log(transformList.numberOfItems); // Output: 1