SVG string list interface
The SVGStringList defines a list of DOMString objects.
An SVGStringList object can be designated as read only, which means that attempts to modify the object will result in an exception being thrown.
Interface overview
| Also implement | None |
|---|---|
| Methods |
|
| Properties |
|
| Normative document | SVG 1.1 (2nd Edition) |
Properties
| Name | Type | Description |
|---|---|---|
numberOfItems |
unsigned long |
The number of items in the list. |
length |
unsigned long |
A mirror of the value in numberOfItems, for consistency with other interfaces. |
Methods
| Name & Arguments | Return | Description |
|---|---|---|
clear() |
void |
Clears all existing current items from the list, with the result being an empty list. Exceptions:
|
initialize(in |
DOMString |
Clears all existing current items from the list and re-initializes the list to hold the single item specified by the parameter. If the inserted item is already in a list, it is removed from its previous list before it is inserted into this list. The inserted item is the item itself and not a copy. The return value is the item inserted into the list. Exceptions:
|
getItem(in unsigned long index) |
DOMString |
Returns the specified item from the list. The returned item is the item itself and not a copy. Any changes made to the item are immediately reflected in the list. The first item is number 0. Exceptions:
|
insertItemBefore(in |
DOMString |
Inserts a new item into the list at the specified position. The first item is number 0. If Exceptions:
|
replaceItem(in |
DOMString |
Replaces an existing item in the list with a new item. If Exceptions:
|
removeItem(in unsigned long index) |
DOMString |
Removes an existing item from the list. Exceptions:
|
appendItem(in |
DOMString |
Inserts a new item at the end of the list. If Exceptions:
|
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
SVGStringList | Chrome Full support Yes | Edge Full support 12 | Firefox
Full support
12
| IE Full support 9 | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android
Full support
14
| Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes |
length | Chrome Full support Yes | Edge Full support ≤79 | Firefox Full support 13 | IE ? | Opera Full support Yes | Safari ? | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support 14 | Opera Android Full support Yes | Safari iOS ? | Samsung Internet Android Full support Yes |
Legend
- Full support
- Full support
- Compatibility unknown
- Compatibility unknown
- Non-standard. Expect poor cross-browser support.
- Non-standard. Expect poor cross-browser support.
- See implementation notes.
- See implementation notes.
