SVGTransformList: removeItem() method

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.

The removeItem() method of the SVGTransformList interface removes an existing item from the list.

Syntax

js
SVGTransformList.removeItem(index)

Parameters

index

An integer; the index of the item to be removed as an unsigned long.

Return value

An SVGTransform object; the removed item from the list.

Exceptions

This method may raise a DOMException of one of the following types:

NoModificationAllowedError DOMException

Thrown if SVGTransformList corresponds to a read-only attribute or when the object itself is read-only.

IndexSizeError DOMException

Thrown if the index number is greater than or equal to numberOfItems.

Examples

Removing a Transformation from the List

html
<svg width="200" height="200" id="mySvg">
  <rect
    width="100"
    height="100"
    fill="blue"
    transform="translate(50,50) rotate(45)" />
</svg>
js
const svgElement = document.querySelector("svg");
const rectElement = svgElement.querySelector("rect");

// Access the transform list of the <rect> element
const transformList = rectElement.transform.baseVal;

const removedTransform = transformList.removeItem(0);
console.dir(removedTransform); // Output: SVGTransform { type: 2, matrix: SVGMatrix, angle: 0 }

// The updated list length
console.log(`Updated number of transformations: ${transformList.length}`); // Output: 1

Specifications

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGNameList__removeItem

Browser compatibility

BCD tables only load in the browser

See also