SVG 描边动画就这么简单

5,853 阅读3分钟

在开始讲解之前,先来看看效果

svg

svg 描边属性 stroke

在 svg 中对图形(line、polyline、rect、circle、ellipse、polygon)、路径(path)、文本(text、textPath、tspan)的描边都需要用到stroke属性。

stroke 常用属性

  • stroke:颜色。

    <svg xmlns="http://www.w3.org/2000/svg" version="1.1">
      <g>
        <path stroke="red" d="M0 20 l200 0" />
        <path stroke="green" d="M0 40 l200 0" />
        <path stroke="blue" d="M0 60 l200 0" />
      </g>
    </svg>
    

    stroke

  • stroke-width:宽度。

    <svg xmlns="http://www.w3.org/2000/svg" version="1.1">
      <g stroke="black">
        <path stroke-width="2" d="M0 20 l200 0" />
        <path stroke-width="6" d="M0 40 l200 0" />
        <path stroke-width="12" d="M0 60 l200 0" />
      </g>
    </svg>
    

    stroke-width

  • stroke-linecap:线端点样式。取值buttroundsquare,默认butt

    <svg xmlns="http://www.w3.org/2000/svg" version="1.1">
      <g stroke="black" stroke-width="6">
        <path stroke-linecap="butt" d="M10 20 l210 0" />
        <path stroke-linecap="round" d="M10 40 l210 0" />
        <path stroke-linecap="square" d="M10 60 l210 0" />
      </g>
    </svg>
    

    stroke-linecap

  • stroke-opacity:透明度。

    <svg xmlns="http://www.w3.org/2000/svg" version="1.1">
      <g stroke="black" stroke-width="6">
        <path stroke-opacity="0.2" d="M10 20 l210 0" />
        <path stroke-opacity="0.6" d="M10 40 l210 0" />
        <path stroke-opacity="1" d="M10 60 l210 0" />
      </g>
    </svg>
    

    stroke-opacity

  • stroke-linejoin:转角处样式。取值arcsbevelmiterround,默认miter

    <svg xmlns="http://www.w3.org/2000/svg" version="1.1" width="400" height="300"
       viewBox="0 0 400 300">
      <g>
        <polyline stroke-linejoin="miter"
                  points="20,100 60,30 100,100"
                  stroke="black" stroke-width="30"
                  fill="none" />
    
        <polyline stroke-linejoin="round"
                  points="20,180 60,110 100,180"
                  stroke="black" stroke-width="30"
                  fill="none" />
    
        <polyline stroke-linejoin="bevel"
                  points="20,260 60,190 100,260"
                  stroke="black" stroke-width="30"
                  fill="none" />
    
      </g>
    </svg>
    

    stroke-linejoin

  • stroke-dasharray:定义虚线样式。取值是一个逗号或者空格分隔的数列。数列的第一个值表示dash大小、第二值表示两个dash之间空隙大小。如stroke-dasharray:10, 2 表示dash大小10、dash间隙2。如果提供数列是奇数个,则会重复一次形成偶数个。如stroke-dasharray:10等效于stroke-dasharray:10, 10stroke-dasharray:10, 2, 5等效于stroke-dasharray:10, 2, 5, 10, 2, 5

    <svg xmlns="http://www.w3.org/2000/svg" version="1.1">
      <g stroke="black" stroke-width="6">
        <path stroke-dasharray="5,5" d="M10 20 l210 0" />
        <path stroke-dasharray="10,10" d="M10 40 l210 0" />
        <path stroke-dasharray="20,10,5,5,5,10" d="M10 60 l210 0" />
      </g>
    </svg>
    

    stroke-dasharray

    singsong:也就是说 stroke-dasharray 取值数列以两个数值为一个单元划分,每个单元第一个值表示dash大小,第二值表示两个dash之间空隙大小。演示实例

    dasharray

  • stroke-miterlimit:当stroke-linejoin: miter时,对 miter 进行限制。

singsong: 样式属性优先级为 style > css > attribute。

如何让描边动起来

stroke-dashoffset

这个属性用于指定 stroke-dasharray 开始的偏移量。也是本文重点介绍对象,理解该属性如何工作,就能很好地掌握 svg 描边动画。stroke-dashoffset 取值可以大于 0,也可以小于 0。演示实例

  • 取值大于 0

    dashoffset1

  • 取值小于 0。等效于offset = s - |-offset| % s。其中offset表示正取值,s表示dasharray的总和(如:dasharray: '100 50',则s: 150)。

    dashoffset2

动画原理

随着时间的变化,通过控制 stroke-dashoffset 来控制 stroke-dasharray 开始的偏移量的变化,以到达动画效果。演示实例

singsong:通常会将 stroke-dasharray 设置为路径总长度。如总长度为sstroke-dasharray: sstroke-dasharray: s s。再将 stroke-dashoffset 取值从 s 变化到 0,就可实现从无到有的描边动画。

animation

动画的实现方式:演示实例

  • css
    .path {
      stroke-dasharray: 523.1047973632812;
      stroke-dashoffset: 0;
      animation: dash 2s linear 3s alternate infinite;
    }
    @keyframes dash {
        from {
            stroke-dashoffset: 523.1047973632812;
        }
        to {
            stroke-dashoffset: 0;
        }
    }
    
  • js。需要使用 SVGGeometryElement.getTotalLength() 方法,获取路径的总长度。在 SVG 1.1 中,getTotalLength() 只存在 SVGPathElement 中,而基本图形是没有该方法的。不过在 SVG 2.0 中,基本图形也继承该方法。如何检测SVG版本,可以参考这里。

Moved pathLength attribute and getTotalLength() and getPointAtLength() methods from SVGPathElement to SVGGeometryElement。————SVG 2 support in Mozilla

const path = document.querySelector('.path');
// 获取总长度
const totalLength = path.getTotalLength();
// 设置 stroke-dasharray
path.style.strokeDasharray = totalLength;
// 设置 stroke-dashoffset
path.style.strokeDashoffset = totalLength;

let currentFrame = 0;
let totalFrames = 160;
const draw = function() {
    let progress = currentFrame / totalFrames;
    if (progress > 1) {
        window.cancelAnimationFrame(handle);
    } else {
        currentFrame++;
        // 更新 stroke-dashoffset
        path.style.strokeDashoffset = totalLength * (1 - progress);
        handle = window.requestAnimationFrame(draw);
    }
};
draw();

实战

将 stroke 动画用于预加载动画展示

工具

相关库

参考文章