SVGTransformList: consolidate()-Methode

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.

Die consolidate()-Methode der SVGTransformList-Schnittstelle konsolidiert die Liste separater SVGTransform-Objekte, indem sie die entsprechenden Transformationsmatrizen multipliziert, um eine Liste zu erhalten, die aus einem einzigen SVGTransform-Objekt vom Typ SVG_TRANSFORM_MATRIX besteht.

Der Konsolidierungsvorgang 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. Jegliche Änderungen am Element werden sofort in der Liste reflektiert.

Syntax

SVGTransformList.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

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2 # __svg__SVGTransformList__consolidate

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

SVGTransform