SVGTransformList: Methode insertItemBefore()

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 Methode insertItemBefore() der Schnittstelle SVGTransformList fügt ein neues Element an der angegebenen Position in die Liste ein.

Das erste Element ist bei 0 indiziert. Das eingefügte Element ist das Element selbst und keine Kopie.

Wenn newItem bereits in einer Liste enthalten ist, wird es vor dem Einfügen in diese Liste aus seiner vorherigen Liste entfernt.
Wenn das Element bereits in dieser Liste enthalten ist, beachten Sie, dass der index des einzufügenden Elements vor dem Entfernen des Elements gilt.
Wenn der index gleich 0 ist, wird das neue Element an den Anfang der Liste eingefügt.
Wenn der index größer oder gleich numberOfItems ist, wird das neue Element an das Ende der Liste angehängt.

Syntax

insertItemBefore(newItem, index)

Parameter

newItem: Ein SVGTransform-Element, das in die Liste eingefügt wird.
index: Ein integer; der Index, an dem das neue Element als "unsigned long" eingefügt werden soll.

Rückgabewert

Ein SVGTransform-Objekt; das eingefügte Element aus der Liste.

Ausnahmen

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

Beispiele

Einfügen einer Transformation in die Liste

html

<svg width="200" height="200" id="mySvg">
  <rect width="100" height="100" fill="blue" />
</svg>

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

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

// Create a new translate transformation
const translateTransform = svgElement.createSVGTransform();
translateTransform.setTranslate(50, 50);

// Insert the translation transformation at the beginning of the list
transformList.insertItemBefore(translateTransform, 0);

// The transformation list length and type
console.log(`Number of transformations: ${transformList.length}`); // Output: 1
console.log(`Transformation Type: ${transformList.getItem(0).type}`); // Output: 2 (e.g. SVG_TRANSFORM_TRANSLATE)

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2 # __svg__SVGNameList__insertItemBefore

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

SVGTransform