SVGStringList

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 string list Schnittstelle

Das SVGStringList definiert eine Liste von Zeichenfolgen.

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

Schnittstellenübersicht

Auch implementieren Keine
Methoden
  • void clear()
  • string initialize(string newItem)
  • string getItem(number index)
  • string insertItemBefore(string newItem, number index)
  • string replaceItem(string newItem, number index)
  • string removeItem(number index)
  • string appendItem(string newItem)
Eigenschaften
  • readonly unsigned long numberOfItems
  • readonly unsigned long length
Normatives Dokument SVG 1.1 (2nd Edition)

Instanz-Eigenschaften

Name Typ Beschreibung
numberOfItems unsigned long Die Anzahl der Elemente in der Liste.
length unsigned long Ein Spiegel der Wert in numberOfItems zur Konsistenz mit anderen Schnittstellen.

Instanz-Methoden

Name & Argumente Rückgabe Beschreibung
clear() void

Löscht alle vorhandenen Elemente aus der Liste, wodurch die Liste leer wird.

Ausnahmen:

  • ein [`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(string newItem) string

Löscht alle vorhandenen Elemente aus der Liste und initialisiert die Liste neu, um das durch den Parameter angegebene Einzelteil zu halten. Wenn das eingefügte Element bereits in einer Liste ist, wird es vor seinem Einfügen aus seiner vorherigen Liste entfernt. 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:

  • ein [`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(number index) string

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

Ausnahmen:

  • ein [`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(string newItem, number index) string

Fügt ein neues Element in die Liste an der angegebenen Position ein. Das erste Element ist Nummer 0. Wenn newItem bereits in einer Liste ist, wird es aus seiner 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 dem Entfernen des Elements liegt. Wenn der index gleich 0 ist, dann wird das neue Element an der Spitze der Liste eingefügt. Wenn der Index größer oder gleich numberOfItems ist, dann wird das neue Element am Ende der Liste angehängt.

Ausnahmen:

  • ein [`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(string newItem, number index) string

Ersetzt ein vorhandenes Element in der Liste durch ein neues Element. Wenn newItem bereits in einer Liste ist, wird es aus seiner 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 dem Entfernen des Elements liegt.

Ausnahmen:

  • ein [`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.
  • ein [`DOMException`](/de/docs/Web/API/DOMException) mit dem Code INDEX_SIZE_ERR wird ausgelöst, wenn die Indexnummer größer oder gleich numberOfItems ist.
removeItem(in unsigned long index) string

Entfernt ein vorhandenes Element aus der Liste.

Ausnahmen:

  • ein [`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.
  • ein [`DOMException`](/de/docs/Web/API/DOMException) mit dem Code INDEX_SIZE_ERR wird ausgelöst, wenn die Indexnummer größer oder gleich numberOfItems ist.
appendItem(string newItem) string

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

Ausnahmen:

  • ein [`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
# InterfaceSVGStringList

Browser-Kompatibilität

BCD tables only load in the browser