SVGStringList: 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() des SVGStringList-Interfaces fügt ein neues Element an der angegebenen Position in die Liste ein. Das erste Element hat den Index 0. Das eingefügte Element ist das Element selbst und keine Kopie.

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

Syntax

js
insertItemBefore(newItem, index)

Parameter

newItem

Der String, der zur Liste hinzugefügt werden soll.

index

Eine nicht-negative Ganzzahl, die den Index des Elements angibt, vor dem das neue Element eingefügt werden soll.

Rückgabewert

Der String, der zur Liste hinzugefügt wurde.

Ausnahmen

DOMException NoModificationAllowedError

Wird ausgelöst, wenn SVGStringList einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGNameList__insertItemBefore

Browser-Kompatibilität

BCD tables only load in the browser