`path-length` CSS property
The path-length CSS property specifies a total path length, in user units. All path computations are then scaled using the ratio path-length / (computed value of path length) — this includes text paths, animation paths, and various stroke operations.
The path-length CSS property specifies a total path length, in user units. All path computations are then scaled using the ratio path-length / (computed value of path length) — this includes text paths, animation paths, and various stroke operations.
The path-length property only applies to circle, ellipse, line, path, polygon, polyline, and rect elements nested in an svg.
[!NOTE] If present, the
path-lengthCSS property overrides an SVG element's pathLength attribute. This property doesn't apply to SVG, HTML, or pseudo-elements other than those listed above.
Syntax
/* Keyword value */
path-length: none;
/* <length> values */
path-length: 0;
path-length: 70px;
path-length: 500px;
/* Global values */
path-length: inherit;
path-length: initial;
path-length: revert;
path-length: revert-layer;
path-length: unset;
Values
none-
: No author path length is specified and the user agent's own computed path length is used for all path-related calculations.
-
<length> - : A non-negative <length> representing an author-defined total path length.
Formal definition
Formal syntax
Examples
Basic usage
This example defines a path and shows how to apply a path length to it using the path-length CSS property.
SVG
Our SVG defines a single curved path element with a colored stroke. It includes a stroke-dasharray attribute that defines a regular dashed pattern for the stroke.
```html live-sample___basic-path-length live-sample___path-length-animation
#### CSS
We set a `path-length` value on the `<path>`:
```css live-sample___basic-path-length
path {
path-length: 500px;
}
Results
100%
Setting a large path-length value results in the dashes becoming smaller and more frequent.
Animating path-length
One major advantage of making path-length available as a CSS property is that you can apply standard CSS functionality such as animations and transitions to it. This example builds on the previous one, showing how to animate a path-length with a CSS animation.
HTML and SVG
This example includes the same SVG <path> as the previous one. In addition, it includes an <input type="range"> element that can be used to change the value of path-length applied to the <path> at runtime. We also include an output element to display the current slider value.
```html live-sample___path-length-animation
#### CSS
On the :root element, we define a [CSS custom property](/docs/Web/CSS/Reference/Properties/--*) called `--path-length` and give it an initial value of `200px`. We then set the `<path>` element's `path-length` value to the `--path-length` property, and set an animation on it that runs an infinite number of times and alternates between forwards and backwards.
```css live-sample___path-length-animation
:root {
--path-length: 200px;
}
path {
path-length: var(--path-length);
animation: path-length-anim 2s alternate infinite ease-in-out;
}
```css hidden live-sample___path-length-animation div { position: fixed; bottom: 0; left: 0; display: flex; align-items: center; }
Next, we define the @keyframes block for the animation — it animates the `path-length` property between the `--path-length` value and the `--path-length` value multiplied by `1.5`.
```css live-sample___path-length-animation
@keyframes path-length-anim {
from {
path-length: var(--path-length);
}
to {
path-length: calc(var(--path-length) * 1.5);
}
}
JavaScript
We start our script by grabbing references to the <input type="range">, <output>, and :root elements.
```js live-sample___path-length-animation const slider = document.querySelector("input"); const output = document.querySelector("output"); const rootElem = document.querySelector(":root");
Next, we add an `input` event handler to the range slider so that, when its value is changed, the `<output>` element's `textContent` and the value of the `--path-length` custom property are set to equal the slider's new value.
```js live-sample___path-length-animation
slider.addEventListener("input", () => {
output.textContent = `${slider.value}px`;
rootElem.style.setProperty("--path-length", `${slider.value}px`);
});
Results
100%
Adjust the slider, and note how larger values result in a smaller dash size.
Specifications
Browser compatibility
See also
- SVG pathLength attribute