SVG length list interface
The SVGLengthList
defines a list of {{ domxref("SVGLength") }} objects.
An SVGLengthList
object can be designated as read only, which means that attempts to modify the object will result in an exception being thrown.
{{ gecko_callout_heading("5.0") }}
Starting in Gecko 5.0 {{ geckoRelease("5.0") }},the SVGLengthList
DOM interface is now indexable and can be accessed like arrays
Interface overview
Also implement | None |
Methods | void clear() - {{ domxref("SVGLength") }}
initialize(in {{ domxref("SVGLength") }} newItem) - {{ domxref("SVGLength") }}
getItem(in unsigned long index) - {{ domxref("SVGLength") }}
insertItemBefore(in {{ domxref("SVGLength") }} newItem, in unsigned long index) - {{ domxref("SVGLength") }}
replaceItem( in {{ domxref("SVGLength") }} newItem, in unsigned long index ) - {{ domxref("SVGLength") }}
removeItem(in unsigned long index) - {{ domxref("SVGLength") }}
appendItem(in {{ domxref("SVGLength") }} newItem) |
Properties | - readonly unsigned long
numberOfItem - readonly unsigned long
length {{ fx_minversion_inline("5") }} {{ non-standard_inline() }} |
Normative document | SVG 1.1 (2nd Edition) |
Properties
Name | Type | Description |
numberOfItem | unsigned long | The number of items in the list. |
length {{ fx_minversion_inline("5") }} {{ non-standard_inline() }} | unsigned long | The number of items in the list. |
Methods
Name & Arguments | Return | Description |
clear() | void | Clears all existing current items from the list, with the result being an empty list. Exceptions: - a {{ domxref("DOMException") }} with code
NO_MODIFICATION_ALLOWED_ERR is raised when the list corresponds to a read only attribute or when the object itself is read only. |
initialize( in {{ domxref("SVGLength") }} newItem ) | {{ domxref("SVGLength") }} | 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: - a {{ domxref("DOMException") }} with code
NO_MODIFICATION_ALLOWED_ERR is raised when the list corresponds to a read only attribute or when the object itself is read only. |
getItem(in unsigned long index) | {{ domxref("SVGLength") }} | 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: - a {{ domxref("DOMException") }} with code
NO_MODIFICATION_ALLOWED_ERR is raised when the list corresponds to a read only attribute or when the object itself is read only. |
insertItemBefore(in {{ domxref("SVGLength") }} newItem, in unsigned long index) | {{ domxref("SVGLength") }} | Inserts a new item into the list at the specified position. The first item is number 0. If newItem 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. If the item is already in this list, note that the index of the item to insert before is before the removal of the item. If the index is equal to 0, then the new item is inserted at the front of the list. If the index is greater than or equal to numberOfItems , then the new item is appended to the end of the list. Exceptions: - a {{ domxref("DOMException") }} with code
NO_MODIFICATION_ALLOWED_ERR is raised when the list corresponds to a read only attribute or when the object itself is read only. |
replaceItem( in {{ domxref("SVGLength") }} newItem, in unsigned long index ) | {{ domxref("SVGLength") }} | Replaces an existing item in the list with a new item. If newItem 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. If the item is already in this list, note that the index of the item to replace is before the removal of the item. Exceptions: - a {{ domxref("DOMException") }} with code
NO_MODIFICATION_ALLOWED_ERR is raised when the list corresponds to a read only attribute or when the object itself is read only. - a {{ domxref("DOMException") }} with code
INDEX_SIZE_ERR is raised if the index number is greater than or equal to numberOfItems . |
removeItem(in unsigned long index) | {{ domxref("SVGLength") }} | Removes an existing item from the list. Exceptions: - a {{ domxref("DOMException") }} with code
NO_MODIFICATION_ALLOWED_ERR is raised when the list corresponds to a read only attribute or when the object itself is read only. - a {{ domxref("DOMException") }} with code
INDEX_SIZE_ERR is raised if the index number is greater than or equal to numberOfItems . |
appendItem(in {{ domxref("SVGLength") }} newItem) | {{ domxref("SVGLength") }} | Inserts a new item at the end of the list. If newItem 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. Exceptions: - a {{ domxref("DOMException") }} with code
NO_MODIFICATION_ALLOWED_ERR is raised when the list corresponds to a read only attribute or when the object itself is read only. |
Browser
compatibility
{{ CompatibilityTable() }}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
Basic support | {{ CompatUnknown() }} | {{ CompatUnknown() }} | {{ CompatUnknown() }} | {{ CompatUnknown() }} | {{ CompatUnknown() }} |
Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
Basic support | {{ CompatNo() }} | {{ CompatUnknown() }} | {{ CompatUnknown() }} | {{ CompatUnknown() }} | {{ CompatUnknown() }} |