SVGStringList: Methode replaceItem()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die Methode replaceItem() der Schnittstelle SVGStringList ersetzt ein vorhandenes Element in der Liste durch ein neues Element. Das eingefügte Element ist das Element selbst und keine Kopie.
- Wenn sich das neue Element bereits in einer Liste befindet, wird es aus seiner vorherigen Liste entfernt, bevor es in diese Liste eingefügt wird.
- Wenn sich das Element bereits in dieser Liste befindet, beachten Sie, dass der Index des zu ersetzenden Elements vor dem Entfernen des Elements bestimmt wird.
Die Zuweisung zu einem Index der Liste hat dieselbe Wirkung wie der Aufruf dieser Methode, mit Ausnahme davon, dass kein Rückgabewert vorhanden ist.
Syntax
js
replaceItem(newItem, index)
Parameter
Rückgabewert
Die Zeichenfolge, die zur Liste hinzugefügt wurde.
Ausnahmen
NoModificationAllowedErrorDOMException-
Wird ausgelöst, wenn die
SVGStringListeinem schreibgeschützten Attribut entspricht oder wenn das Objekt selbst schreibgeschützt ist. IndexSizeErrorDOMException-
Wird ausgelöst, wenn der Index außerhalb der Grenzen der Liste liegt.
Spezifikationen
| Spezifikation |
|---|
| Scalable Vector Graphics (SVG) 2 # __svg__SVGNameList__replaceItem |