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-Nummerlistenschnittstelle

Das SVGNumberList definiert eine Liste von SVGNumber Objekten.

Ein SVGNumberList Objekt kann als schreibgeschützt bezeichnet 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.

Überblick über die Schnittstelle

Implementiert auch Keine
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
Normatives Dokument SVG 1.1 (2. Ausgabe)

Instanzeigenschaften

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

Instanzmethoden

Name & Argumente Rückgabetyp Beschreibung
[`clear`](/de/docs/Web/API/SVGNumberList/clear)() void

Entfernt alle vorhandenen aktuellen Elemente aus der Liste, so dass die Liste leer ist.

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`](/de/docs/Web/API/SVGNumberList/initialize)(in [`SVGNumber`](/de/docs/Web/API/SVGNumber) newItem) [`SVGNumber`](/de/docs/Web/API/SVGNumber)

Entfernt alle vorhandenen aktuellen Elemente aus der Liste und initialisiert die Liste mit dem angegebenen Einzelteil newItem. Wenn das eingefügte Element bereits in einer Liste ist, wird es aus der vorherigen Liste entfernt, bevor es in diese Liste eingefügt wird. Das eingefügte Element ist das Element selbst und keine Kopie. Der Rückgabewert ist das Element, das in die Liste eingefügt wurde.

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`](/de/docs/Web/API/SVGNumberList/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. Alle Änderungen, die am Element vorgenommen werden, werden sofort in der Liste widergespiegelt. Das erste Element hat die 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`](/de/docs/Web/API/SVGNumberList/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 hat die Nummer 0.

Wenn newItem bereits in einer Liste ist, wird es aus der vorherigen Liste entfernt, bevor es in diese Liste eingefügt wird. 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 ist.

Wenn der index gleich 0 ist, wird das neue Element am Anfang der Liste eingefügt. Ist der Index größer oder gleich numberOfItems, wird das neue Element am 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`](/de/docs/Web/API/SVGNumberList/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 ist, wird es aus der vorherigen Liste entfernt, bevor es in diese Liste eingefügt wird. 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 zu ersetzenden Elements vor der Entfernung des Elements ist.

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`](/de/docs/Web/API/SVGNumberList/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`](/de/docs/Web/API/SVGNumberList/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 ist, wird es aus der vorherigen Liste entfernt, bevor es in diese Liste eingefügt wird. 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