SVGNumberList

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.

SVG-Nummernlisten-Schnittstelle

Die SVGNumberList definiert eine Liste von SVGNumber-Objekten.

Ein SVGNumberList-Objekt kann als schreibgeschützt gekennzeichnet werden, was bedeutet, dass Versuche, das Objekt zu ändern, zu einer Ausnahme führen.

Ein SVGNumberList ist indizierbar und kann wie ein Array angesprochen werden.

Schnittstellenübersicht

Implementiert auch None
Methoden
  • void clear()
  • [`SVGNumber`](/de/docs/Web/API/SVGNumber) initialize(in [`SVGNumber`](/de/docs/Web/API/SVGNumber) newItem)
  • [`SVGNumber`](/de/docs/Web/API/SVGNumber) getItem(in unsigned long index)
  • [`SVGNumber`](/de/docs/Web/API/SVGNumber) insertItemBefore(in [`SVGNumber`](/de/docs/Web/API/SVGNumber) newItem, in unsigned long index)
  • [`SVGNumber`](/de/docs/Web/API/SVGNumber) replaceItem(in [`SVGNumber`](/de/docs/Web/API/SVGNumber) newItem, in unsigned long index)
  • [`SVGNumber`](/de/docs/Web/API/SVGNumber) removeItem(in unsigned long index)
  • [`SVGNumber`](/de/docs/Web/API/SVGNumber) appendItem(in [`SVGNumber`](/de/docs/Web/API/SVGNumber) newItem)
Eigenschaften
  • readonly unsigned long numberOfItems
  • readonly unsigned long length Nicht standardisiert
Normatives Dokument SVG 1.1 (2nd Edition)

Instanz-Eigenschaften

Name Typ Beschreibung
numberOfItems unsigned long Die Anzahl der Elemente in der Liste.
length Nicht standardisiert unsigned long Die Anzahl der Elemente in der Liste.

Instanz-Methoden

Name & Argumente Rückgabe Beschreibung
clear() void

Löscht alle vorhandenen aktuellen Elemente aus der Liste, das Ergebnis ist eine leere Liste.

Ausnahmen:

  • eine [`DOMException`](/de/docs/Web/API/DOMException) mit dem Code NO_MODIFICATION_ALLOWED_ERR wird ausgelöst, wenn die Liste einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.
initialize(in [`SVGNumber`](/de/docs/Web/API/SVGNumber) newItem) [`SVGNumber`](/de/docs/Web/API/SVGNumber)

Löscht alle vorhandenen aktuellen Elemente aus der Liste und initialisiert die Liste neu, um das angegebene einzelne Element zu halten, das durch newItem spezifiziert ist. Wenn das eingefügte Element bereits in einer Liste vorhanden ist, wird es vor seiner Einfügung in diese Liste aus seiner vorherigen Liste entfernt. Das eingefügte Element ist das Element selbst und keine Kopie. Der Rückgabewert ist das in die Liste eingefügte Element.

Ausnahmen:

  • eine [`DOMException`](/de/docs/Web/API/DOMException) mit dem Code NO_MODIFICATION_ALLOWED_ERR wird ausgelöst, wenn die Liste einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.
getItem(in unsigned long index) [`SVGNumber`](/de/docs/Web/API/SVGNumber)

Gibt das angegebene Element aus der Liste zurück. Das zurückgegebene Element ist das Element selbst und keine Kopie. Änderungen am Element werden sofort in der Liste widergespiegelt. Das erste Element ist Nummer 0.

Ausnahmen:

  • eine [`DOMException`](/de/docs/Web/API/DOMException) mit dem Code NO_MODIFICATION_ALLOWED_ERR wird ausgelöst, wenn die Liste einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.
insertItemBefore(in [`SVGNumber`](/de/docs/Web/API/SVGNumber) newItem, in unsigned long index) [`SVGNumber`](/de/docs/Web/API/SVGNumber)

Fügt ein neues Element an der angegebenen Position in die Liste ein. Das erste Element ist Nummer 0.

Wenn newItem bereits in einer Liste vorhanden ist, wird es vor seiner Einfügung in diese Liste aus seiner vorherigen Liste entfernt. Das eingefügte Element ist das Element selbst und keine Kopie. Wenn das Element bereits in dieser Liste ist, beachten Sie, dass der Index des einzufügenden Elements vor der Entfernung des Elements liegt.

Wenn der index gleich 0 ist, wird das neue Element am Anfang der Liste eingefügt. Liegt der Index größer oder gleich numberOfItems, wird das neue Element an das Ende der Liste angehängt.

Ausnahmen:

  • eine [`DOMException`](/de/docs/Web/API/DOMException) mit dem Code NO_MODIFICATION_ALLOWED_ERR wird ausgelöst, wenn die Liste einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.
replaceItem(in [`SVGNumber`](/de/docs/Web/API/SVGNumber) newItem, in unsigned long index) [`SVGNumber`](/de/docs/Web/API/SVGNumber)

Ersetzt ein vorhandenes Element in der Liste durch ein neues Element. Wenn newItem bereits in einer Liste vorhanden ist, wird es vor seiner Einfügung in diese Liste aus seiner vorherigen Liste entfernt. Das eingefügte Element ist das Element selbst und keine Kopie. Wenn das Element bereits in dieser Liste vorhanden ist, beachten Sie, dass der Index des zu ersetzenden Elements vor der Entfernung des Elements liegt.

Ausnahmen:

  • eine [`DOMException`](/de/docs/Web/API/DOMException) mit dem Code NO_MODIFICATION_ALLOWED_ERR wird ausgelöst, wenn die Liste einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.
  • eine [`DOMException`](/de/docs/Web/API/DOMException) mit dem Code INDEX_SIZE_ERR wird ausgelöst, wenn index größer oder gleich numberOfItems ist.
removeItem(in unsigned long index) [`SVGNumber`](/de/docs/Web/API/SVGNumber)

Entfernt ein vorhandenes Element aus der Liste.

Ausnahmen:

  • eine [`DOMException`](/de/docs/Web/API/DOMException) mit dem Code NO_MODIFICATION_ALLOWED_ERR wird ausgelöst, wenn die Liste einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.
  • eine [`DOMException`](/de/docs/Web/API/DOMException) mit dem Code INDEX_SIZE_ERR wird ausgelöst, wenn index größer oder gleich numberOfItems ist.
appendItem(in [`SVGNumber`](/de/docs/Web/API/SVGNumber) newItem) [`SVGNumber`](/de/docs/Web/API/SVGNumber)

Fügt ein neues Element am Ende der Liste ein. Wenn newItem bereits in einer Liste vorhanden ist, wird es vor seiner Einfügung in diese Liste aus seiner vorherigen Liste entfernt. Das eingefügte Element ist das Element selbst und keine Kopie.

Ausnahmen:

  • eine [`DOMException`](/de/docs/Web/API/DOMException) mit dem Code NO_MODIFICATION_ALLOWED_ERR wird ausgelöst, wenn die Liste einem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist.

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2
# InterfaceSVGNumberList

Browser-Kompatibilität

BCD tables only load in the browser