SVG 图像入门教程

作者： 阮一峰

www.ruanyifeng.com/blog/2018/08/svg.html

一、概述

SVG 是一种基于 XML 语法的图像格式，全称是可缩放矢量图（Scalable Vector Graphics）。其他图像格式都是基于像素处理的，SVG 则是属于对图像的形状描述，所以它本质上是文本文件，体积较小，且不管放大多少倍都不会失真。

SVG 文件可以直接插入网页，成为 DOM 的一部分，然后用 JavaScript 和 CSS 进行操作。

id="mysvg"

xmlns="http://www.w3.org/2000/svg"

viewBox="0 0 800 600"

preserveAspectRatio="xMidYMid meet"

上面是 SVG 代码直接插入网页的例子。

SVG 代码也可以写在一个独立文件中，然后用、、、

CSS 也可以使用 SVG 文件。

.logo{

background:url(icon.svg);

}

SVG 文件还可以转为 BASE64 编码，然后作为 Data URI 写入网页。

二、语法

2.1标签

SVG 代码都放在顶层标签之中。下面是一个例子。

的width属性和height属性，指定了 SVG 图像在 HTML 元素中所占据的宽度和高度。除了相对单位，也可以采用绝对单位（单位：像素）。如果不指定这两个属性，SVG 图像默认大小是300像素（宽） x 150像素（高）。

如果只想展示 SVG 图像的一部分，就要指定viewBox属性。

属性的值有四个数字，分别是左上角的横坐标和纵坐标、视口的宽度和高度。上面代码中，SVG 图像是100像素宽 x 100像素高，viewBox属性指定视口从(50, 50)这个点开始。所以，实际看到的是右下角的四分之一圆。

注意，视口必须适配所在的空间。上面代码中，视口的大小是 50 x 50，由于 SVG 图像的大小是 100 x 100，所以视口会放大去适配 SVG 图像的大小，即放大了四倍。

如果不指定width属性和height属性，只指定viewBox属性，则相当于只给定 SVG 图像的长宽比。这时，SVG 图像的默认大小将等于所在的 HTML 元素的大小。

2.2 标签

标签代表圆形。

上面的代码定义了三个圆。标签的cx、cy、r属性分别为横坐标、纵坐标和半径，单位为像素。坐标都是相对于画布的左上角原点。

class属性用来指定对应的 CSS 类。

.red{

fill:red;

}

.fancy{

fill:none;

stroke:black;

stroke-width:3pt;

}

SVG 的 CSS 属性与网页元素有所不同。

fill：填充色

stroke：描边色

stroke-width：边框宽度

2.3

标签

标签用来绘制直线。

上面代码中，

标签的x1属性和y1属性，表示线段起点的横坐标和纵坐标；x2属性和y2属性，表示线段终点的横坐标和纵坐标；style属性表示线段的样式。

2.4

标签

标签用于绘制一根折线。

的points属性指定了每个端点的坐标，横坐标与纵坐标之间与逗号分隔，点与点之间用空格分隔。

2.5 标签

标签用于绘制矩形。

的x属性和y属性，指定了矩形左上角端点的横坐标和纵坐标；width属性和height属性指定了矩形的宽度和高度（单位像素）。

2.6 标签

标签用于绘制椭圆。

的cx属性和cy属性，指定了椭圆中心的横坐标和纵坐标（单位像素）；rx属性和ry属性，指定了椭圆横向轴和纵向轴的半径（单位像素）。

2.7

标签

标签用于绘制多边形。

的points属性指定了每个端点的坐标，横坐标与纵坐标之间与逗号分隔，点与点之间用空格分隔。

2.8

标签

标签用于制路径。

M 18,3

L 46,3

L 46,40

L 61,40

L 32,68

L 3,40

L 18,40

Z

的d属性表示绘制顺序，它的值是一个长字符串，每个字母表示一个绘制动作，后面跟着坐标。

M：移动到（moveto）

L：画直线到（lineto）

Z：闭合路径

2.9 标签

标签用于绘制文本。

HelloWorld

的x属性和y属性，表示文本区块基线（baseline）起点的横坐标和纵坐标。文字的样式可以用class或style属性指定。

2.10 标签

标签用于复制一个形状。

的href属性指定所要复制的节点，x属性和y属性是左上角的坐标。另外，还可以指定width和height坐标。

2.11 标签

标签用于将多个形状组成一个组（group），方便复用。

圆形

2.12 标签

标签用于自定义形状，它内部的代码不会显示，仅供引用。

圆形

2.13

标签

标签用于自定义一个形状，该形状可以被引用来平铺一个区域。

上面代码中，

标签将一个圆形定义为dots模式。patternUnits="userSpaceOnUse"表示

的宽度和长度是实际的像素值。然后，指定这个模式去填充下面的矩形。

2.14 标签

标签用于插入图片文件。

width="50%"height="50%"/>

上面代码中，的xlink:href属性表示图像的来源。

2.15 标签

标签用于产生动画效果。

上面代码中，矩形会不断移动，产生动画效果。

的属性含义如下。

attributeName：发生动画效果的属性名。

from：单次动画的初始值。

to：单次动画的结束值。

dur：单次动画的持续时间。

repeatCount：动画的循环模式。

可以在多个属性上面定义动画。

2.16 标签

标签对 CSS 的transform属性不起作用，如果需要变形，就要使用标签。

上面代码中，的效果为旋转（rotate），这时from和to属性值有三个数字，第一个数字是角度值，第二个值和第三个值是旋转中心的坐标。from="0 200 200"表示开始时，角度为0，围绕(200, 200)开始旋转；to="360 400 400"表示结束时，角度为360，围绕(400, 400)旋转。

三、JavaScript 操作

3.1 DOM 操作

如果 SVG 代码直接写在 HTML 网页之中，它就成为网页 DOM 的一部分，可以直接用 DOM 操作。

id="mysvg"

xmlns="http://www.w3.org/2000/svg"

viewBox="0 0 800 600"

preserveAspectRatio="xMidYMid meet"

上面代码插入网页之后，就可以用 CSS 定制样式。

circle{

stroke-width:5;

stroke:#f00;

fill:#ff0;

}

circle:hover{

stroke:#090;

fill:#fff;

}

然后，可以用 JavaScript 代码操作 SVG。

varmycircle=document.getElementById('mycircle');

mycircle.addEventListener('click',function(e){

console.log('circle clicked - enlarging');

mycircle.setAttribute('r',60);

},false);

上面代码指定，如果点击图形，就改写circle元素的r属性。

3.2 获取 SVG DOM

使用、

varsvgObject=document.getElementById('object').contentDocument;

varsvgIframe=document.getElementById('iframe').contentDocument;

varsvgEmbed=document.getElementById('embed').getSVGDocument();

注意，如果使用标签插入 SVG 文件，就无法获取 SVG DOM。

3.3 读取 SVG 源码

由于 SVG 文件就是一段 XML 文本，因此可以通过读取 XML 代码的方式，读取 SVG 源码。

xmlns="http://www.w3.org/2000/svg"

xmlns:xlink="http://www.w3.org/1999/xlink"

xml:space="preserve"width="500"height="440"

使用XMLSerializer实例的serializeToString()方法，获取 SVG 元素的代码。

var svgString = new XMLSerializer()

.serializeToString(document.querySelector('svg'));

3.4 SVG 图像转为 Canvas 图像

首先，需要新建一个Image对象，将 SVG 图像指定到该Image对象的src属性。

varimg=newImage();

varsvg=newBlob([svgString],{type:"image/svg+xml;charset=utf-8"});

varDOMURL=self.URL||self.webkitURL||self;

varurl=DOMURL.createObjectURL(svg);

img.src=url;

然后，当图像加载完成后，再将它绘制到元素。

img.onload=function(){

varcanvas=document.getElementById('canvas');

varctx=canvas.getContext('2d');

ctx.drawImage(img,,);

};

四、实例：折线图

下面将一张数据表格画成折线图。

Date|Amount

-----|------

2014-01-01|$10

2014-02-01|$20

2014-03-01|$40

2014-04-01|$80

上面的图形，可以画成一个坐标系，Date作为横轴，Amount作为纵轴，四行数据画成一个数据点。

$10

$80

January2014

April

五、参考链接

Jon McPartland, An introduction to SVG animation

Alexander Goedde, SVG – Super Vector Graphics

Joseph Wegner, Learning SVG

biovisualize, Direct svg to canvas to png conversion

Tyler Sticka, Cropping Image Thumbnails with SVG

Adi Purdila, How to Create a Loader Icon With SVG Animations

（完）

【关于投稿】

如果大家有原创好文投稿，请直接给公号发送留言。

① 留言格式：

【投稿】+《 文章标题》+ 文章链接

② 示例：

【投稿】《不要自称是程序员，我十多年的 IT 职场总结》：http://blog.jobbole.com/94148/

③ 最后请附上您的个人简介哈~

觉得本文对你有帮助？请分享给更多人

关注「前端大全」，提升前端技能