SVGAnimatedNumberList: animVal property

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 animVal read-only property of the SVGAnimatedNumberList interface represents the current animated value of an animatable attribute that accepts a list of <number> values.

This property reflects the viewBox attribute of the <svg> element, the values attribute of the feColorMatrix element and the points attribute of the <rect>, <polygon>, or <polyline> element as a readonly SVGNumberList, providing access to a dynamically updated list of points defined by the points attribute.

Value

An SVGNumberList object representing the animated value of the attribute. The list contains one or more numbers corresponding to the individual number values specified in the attribute.

Examples

js
const rect = document.querySelector("rect");

// Set the animatable 'points' attribute with number values
rect.setAttribute("points", "10,10 20,10 20,20 10,20");

// Access the SVGAnimatedNumberList object
const points = rect.points;

console.dir(points.animVal); // the animated state

Specifications

Specification
Scalable Vector Graphics (SVG) 2
# __svg__SVGAnimatedNumberList__animVal

Browser compatibility

BCD tables only load in the browser

See also