一、概述
SVG 是一种基于 XML 语法的图像格式,全称是可缩放矢量图(Scalable Vector Graphics)。其他图像格式都是基于像素处理的,SVG 则是属于对图像的形状描述,所以它本质上是文本文件,体积较小,且不管放大多少倍都不会失真。
SVG 文件可以直接插入网页,成为 DOM 的一部分,然后用 JavaScript 和 CSS 进行操作。
<!DOCTYPE html>
<html>
<head></head>
<body>
<svg
id="mysvg"
xmlns="http://www.w3.org/2000/svg"
viewBox="0 0 800 600"
preserveAspectRatio="xMidYMid meet"
>
<circle id="mycircle" cx="400" cy="300" r="50" />
<svg>
</body>
</html>
上面是 SVG 代码直接插入网页的例子。
SVG 代码也可以写在一个独立文件中,然后用<img>
、<object>
、<embed>
、<iframe>
等标签插入网页。
<img src="circle.svg">
<object id="object" data="circle.svg" type="image/svg+xml"></object>
<embed id="embed" src="icon.svg" type="image/svg+xml">
<iframe id="iframe" src="icon.svg"></iframe>
CSS 也可以使用 SVG 文件。
.logo {
background: url(icon.svg);
}
SVG 文件还可以转为 BASE64 编码,然后作为 Data URI 写入网页。
<img src="data:image/svg+xml;base64,[data]">
二、语法
2.1 <svg>
标签
SVG 代码都放在顶层标签<svg>
之中。下面是一个例子。
<svg width="100%" height="100%">
<circle id="mycircle" cx="50" cy="50" r="50" />
</svg>
<svg>
的width
属性和height
属性,指定了 SVG 图像在 HTML 元素中所占据的宽度和高度。除了相对单位,也可以采用绝对单位(单位:像素)。如果不指定这两个属性,SVG 图像默认大小是300像素(宽) x 150像素(高)。
如果只想展示 SVG 图像的一部分,就要指定viewBox
属性。
<svg width="100" height="100" viewBox="50 50 50 50">
<circle id="mycircle" cx="50" cy="50" r="50" />
</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 <circle>
标签
<circle>
标签代表圆形。
<svg width="300" height="180">
<circle cx="30" cy="50" r="25" />
<circle cx="90" cy="50" r="25" class="red" />
<circle cx="150" cy="50" r="25" class="fancy" />
</svg>
上面的代码定义了三个圆。<circle>
标签的cx
、cy
、r
属性分别为横坐标、纵坐标和半径,单位为像素。坐标都是相对于<svg>
画布的左上角原点。
class
属性用来指定对应的 CSS 类。
.red {
fill: red;
}
.fancy {
fill: none;
stroke: black;
stroke-width: 3pt;
}
SVG 的 CSS 属性与网页元素有所不同。
- fill:填充色
- stroke:描边色
- stroke-width:边框宽度
2.3 <line>
标签
<line>
标签用来绘制直线。
<svg width="300" height="180">
<line x1="0" y1="0" x2="200" y2="0" style="stroke:rgb(0,0,0);stroke-width:5" />
</svg>
上面代码中,<line>
标签的x1
属性和y1
属性,表示线段起点的横坐标和纵坐标;x2
属性和y2
属性,表示线段终点的横坐标和纵坐标;style
属性表示线段的样式。
2.4 <polyline>
标签
<polyline>
标签用于绘制一根折线。
<svg width="300" height="180">
<polyline points="3,3 30,28 3,53" fill="none" stroke="black" />
</svg>
<polyline>
的points
属性指定了每个端点的坐标,横坐标与纵坐标之间与逗号分隔,点与点之间用空格分隔。
2.5 <rect>
标签
<rect>
标签用于绘制矩形。
<svg width="300" height="180">
<rect x="0" y="0" height="100" width="200" style="stroke: #70d5dd; fill: #dd524b" />
</svg>
<rect>
的x
属性和y
属性,指定了矩形左上角端点的横坐标和纵坐标;width
属性和height
属性指定了矩形的宽度和高度(单位像素)。
2.6 <ellipse>
标签
<ellipse>
标签用于绘制椭圆。
<svg width="300" height="180">
<ellipse cx="60" cy="60" ry="40" rx="20" stroke="black" stroke-width="5" fill="silver"/>
</svg>
<ellipse>
的cx
属性和cy
属性,指定了椭圆中心的横坐标和纵坐标(单位像素);rx
属性和ry
属性,指定了椭圆横向轴和纵向轴的半径(单位像素)。
2.7 <polygon>
标签
<polygon>
标签用于绘制多边形。
<svg width="300" height="180">
<polygon fill="green" stroke="orange" stroke-width="1" points="0,0 100,0 100,100 0,100 0,0"/>
</svg>
<polygon>
的points
属性指定了每个端点的坐标,横坐标与纵坐标之间与逗号分隔,点与点之间用空格分隔。
2.8 <path>
标签
<path>
标签用于制路径。
<svg width="300" height="180">
<path d="
M 18,3
L 46,3
L 46,40
L 61,40
L 32,68
L 3,40
L 18,40
Z
"></path>
</svg>
<path>
的d
属性表示绘制顺序,它的值是一个长字符串,每个字母表示一个绘制动作,后面跟着坐标。
- M:移动到(moveto)
- L:画直线到(lineto)
- Z:闭合路径
2.9 <text>
标签
<text>
标签用于绘制文本。
<svg width="300" height="180">
<text x="50" y="25">Hello World</text>
</svg>
<text>
的x
属性和y
属性,表示文本区块基线(baseline)起点的横坐标和纵坐标。文字的样式可以用class
或style
属性指定。
2.10 <use>
标签
<use>
标签用于复制一个形状。
<svg viewBox="0 0 30 10" xmlns="http://www.w3.org/2000/svg">
<circle id="myCircle" cx="5" cy="5" r="4"/>
<use href="#myCircle" x="10" y="0" fill="blue" />
<use href="#myCircle" x="20" y="0" fill="white" stroke="blue" />
</svg>
<use>
的href
属性指定所要复制的节点,x
属性和y
属性是<use>
左上角的坐标。另外,还可以指定width
和height
坐标。
2.11 <g>
标签
<g>
标签用于将多个形状组成一个组(group),方便复用。
<svg width="300" height="100">
<g id="myCircle">
<text x="25" y="20">圆形</text>
<circle cx="50" cy="50" r="20"/>
</g>
<use href="#myCircle" x="100" y="0" fill="blue" />
<use href="#myCircle" x="200" y="0" fill="white" stroke="blue" />
</svg>
2.12 <defs>
标签
<defs>
标签用于自定义形状,它内部的代码不会显示,仅供引用。
<svg width="300" height="100">
<defs>
<g id="myCircle">
<text x="25" y="20">圆形</text>
<circle cx="50" cy="50" r="20"/>
</g>
</defs>
<use href="#myCircle" x="0" y="0" />
<use href="#myCircle" x="100" y="0" fill="blue" />
<use href="#myCircle" x="200" y="0" fill="white" stroke="blue" />
</svg>
2.13 <pattern>
标签
<pattern>
标签用于自定义一个形状,该形状可以被引用来平铺一个区域。
<svg width="500" height="500">
<defs>
<pattern id="dots" x="0" y="0" width="100" height="100" patternUnits="userSpaceOnUse">
<circle fill="#bee9e8" cx="50" cy="50" r="35" />
</pattern>
</defs>
<rect x="0" y="0" width="100%" height="100%" fill="url(#dots)" />
</svg>
上面代码中,<pattern>
标签将一个圆形定义为dots
模式。patternUnits="userSpaceOnUse"
表示<pattern>
的宽度和长度是实际的像素值。然后,指定这个模式去填充下面的矩形。
2.14 <image>
标签
<image>
标签用于插入图片文件。
<svg viewBox="0 0 100 100" width="100" height="100">
<image xlink:href="path/to/image.jpg"
width="50%" height="50%"/>
</svg>
上面代码中,<image>
的xlink:href
属性表示图像的来源。
2.15 <animate>
标签
<animate>
标签用于产生动画效果。
<svg width="500px" height="500px">
<rect x="0" y="0" width="100" height="100" fill="#feac5e">
<animate attributeName="x" from="0" to="500" dur="2s" repeatCount="indefinite" />
</rect>
</svg>
上面代码中,矩形会不断移动,产生动画效果。
<animate>
的属性含义如下。
- attributeName:发生动画效果的属性名。
- from:单次动画的初始值。
- to:单次动画的结束值。
- dur:单次动画的持续时间。
- repeatCount:动画的循环模式。
可以在多个属性上面定义动画。
<animate attributeName="x" from="0" to="500" dur="2s" repeatCount="indefinite" />
<animate attributeName="width" to="500" dur="2s" repeatCount="indefinite" />
2.16 <animateTransform>
标签
<animate>
标签对 CSS 的transform
属性不起作用,如果需要变形,就要使用<animateTransform>
标签。
<svg width="500px" height="500px">
<rect x="250" y="250" width="50" height="50" fill="#4bc0c8">
<animateTransform attributeName="transform" type="rotate" begin="0s" dur="10s" from="0 200 200" to="360 400 400" repeatCount="indefinite" />
</rect>
</svg>
上面代码中,<animateTransform>
的效果为旋转(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 操作。
<svg
id="mysvg"
xmlns="http://www.w3.org/2000/svg"
viewBox="0 0 800 600"
preserveAspectRatio="xMidYMid meet"
>
<circle id="mycircle" cx="400" cy="300" r="50" />
<svg>
上面代码插入网页之后,就可以用 CSS 定制样式。
circle {
stroke-width: 5;
stroke: #f00;
fill: #ff0;
}
circle:hover {
stroke: #090;
fill: #fff;
}
然后,可以用 JavaScript 代码操作 SVG。
var mycircle = document.getElementById('mycircle');
mycircle.addEventListener('click', function(e) {
console.log('circle clicked - enlarging');
mycircle.setAttribute('r', 60);
}, false);
上面代码指定,如果点击图形,就改写circle
元素的r
属性。
3.2 获取 SVG DOM
使用<object>
、<iframe>
、<embed>
标签插入 SVG 文件,可以获取 SVG DOM。
var svgObject = document.getElementById('object').contentDocument;
var svgIframe = document.getElementById('iframe').contentDocument;
var svgEmbed = document.getElementById('embed').getSVGDocument();
注意,如果使用<img>
标签插入 SVG 文件,就无法获取 SVG DOM。
3.3 读取 SVG 源码
由于 SVG 文件就是一段 XML 文本,因此可以通过读取 XML 代码的方式,读取 SVG 源码。
<div id="svg-container">
<svg
xmlns="http://www.w3.org/2000/svg"
xmlns:xlink="http://www.w3.org/1999/xlink"
xml:space="preserve" width="500" height="440"
>
<!-- svg code -->
</svg>
</div>
使用XMLSerializer
实例的serializeToString()
方法,获取 SVG 元素的代码。
var svgString = new XMLSerializer()
.serializeToString(document.querySelector('svg'));
3.4 SVG 图像转为 Canvas 图像
首先,需要新建一个Image
对象,将 SVG 图像指定到该Image
对象的src
属性。
var img = new Image();
var svg = new Blob([svgString], {type: "image/svg+xml;charset=utf-8"});
var DOMURL = self.URL || self.webkitURL || self;
var url = DOMURL.createObjectURL(svg);
img.src = url;
然后,当图像加载完成后,再将它绘制到<canvas>
元素。
img.onload = function () {
var canvas = document.getElementById('canvas');
var ctx = canvas.getContext('2d');
ctx.drawImage(img, 0, 0);
};
四、实例:折线图
下面将一张数据表格画成折线图。
Date |Amount
-----|------
2014-01-01 | $10
2014-02-01 | $20
2014-03-01 | $40
2014-04-01 | $80
上面的图形,可以画成一个坐标系,Date
作为横轴,Amount
作为纵轴,四行数据画成一个数据点。
<svg width="350" height="160">
<g class="layer" transform="translate(60,10)">
<circle r="5" cx="0" cy="105" />
<circle r="5" cx="90" cy="90" />
<circle r="5" cx="180" cy="60" />
<circle r="5" cx="270" cy="0" />
<g class="y axis">
<line x1="0" y1="0" x2="0" y2="120" />
<text x="-40" y="105" dy="5">$10</text>
<text x="-40" y="0" dy="5">$80</text>
</g>
<g class="x axis" transform="translate(0, 120)">
<line x1="0" y1="0" x2="270" y2="0" />
<text x="-30" y="20">January 2014</text>
<text x="240" y="20">April</text>
</g>
</g>
</svg>
<svg t="1591124909270" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="3082" width="100%" height="100%"><path d="M251.69 471.18s-63.92-10-113.18 22.5-65.19 95.21-65.19 95.21 63.92 10 113.18-22.5 65.19-95.21 65.19-95.21zM277.52 565.71s-73.52 17.1-112.68 73.81-29 131.55-29 131.55 73.57-17.1 112.68-73.81 29-131.55 29-131.55zM265.85 775.48c-6.2 63.45 35.59 119.46 35.59 119.46s51.86-46.85 58.06-110.3-35.59-119.46-35.59-119.46-51.86 46.82-58.06 110.3zM399.25 766.29S383.9 822 407.77 869.06s77.94 67.52 77.94 67.52 15.35-55.74-8.52-102.76-77.94-67.53-77.94-67.53zM577.74 878.81C548.57 856.55 508.48 860 508.48 860s7.23 39.58 36.4 61.84 69.26 18.78 69.26 18.78-7.22-39.55-36.4-61.81zM617.34 898.65s26 26.61 59.94 28.56 62.83-21.47 62.83-21.47-26-26.61-59.94-28.57-62.83 21.48-62.83 21.48zM798.67 852c-31.14 2.22-54.75 27-54.75 27s26.89 21.18 58 19 54.74-27 54.74-27-26.85-21.18-57.99-19zM881.39 813.19c-22.15 11.39-31.7 37-31.7 37s26.36 7.11 48.51-4.28 31.7-37 31.7-37-26.36-7.12-48.51 4.28zM935.79 768.05c-11.8 9.27-14.52 25.5-14.52 25.5s16.41 1.19 28.21-8.08S964 760 964 760s-16.41-1.22-28.21 8.05zM166 437.17c51.34-17.62 80-69.79 80-69.79s-54.62-23.61-106-6-80 69.79-80 69.79 54.62 23.61 106 6zM200.3 309.38c49.82-2.74 88.19-41.73 88.19-41.73s-42.41-34.56-92.23-31.82-88.2 41.73-88.2 41.73 42.41 34.56 92.24 31.82zM266.43 216.48c39.32 6.24 75.8-17.72 75.8-17.72s-27.23-34.08-66.59-40.32-75.8 17.73-75.8 17.73 27.27 34.07 66.59 40.31zM343.36 161.94c27.35 9.93 56.86-2.2 56.86-2.2S385.38 131.5 358 121.57s-56.86 2.19-56.86 2.19S316 152 343.36 161.94zM426.29 131.31c21 9.06 44.68 0.92 44.68 0.92s-10.32-22.83-31.31-31.89-44.66-0.93-44.66-0.93 10.3 22.84 31.29 31.9zM502.8 117.08c15.92 9.14 35.57 4.81 35.57 4.81s-6.15-19.16-22.07-28.31-35.57-4.81-35.57-4.81 6.15 19.16 22.07 28.31zM606.91 118.59s-2-16.31-13.34-26.1-27.79-9.33-27.79-9.33 2 16.31 13.34 26.1 27.79 9.33 27.79 9.33zM657.32 125.61s1-9.88-4.43-17.15-15.16-9.16-15.16-9.16-1 9.88 4.43 17.15 15.16 9.16 15.16 9.16zM448.18 536.3c22.84-45.87 7.5-99.91 7.5-99.91s-52.37 20.33-75.2 66.2-7.51 99.9-7.51 99.9 52.37-20.32 75.21-66.19zM292.38 463s51.94 2 88.24-28.46 43.19-82 43.19-82-51.94-2.05-88.23 28.46-43.2 82-43.2 82zM451.6 259.67s-39.41-13.87-74.51 1-52.61 52.77-52.61 52.77 39.41 13.88 74.51-1 52.61-52.77 52.61-52.77zM505.63 517.64s-39.88 52.05-34.82 111.65S524 733.47 524 733.47s39.89-52.05 34.83-111.65-53.2-104.18-53.2-104.18zM709.82 721.08s4.63-57.65-27.66-99.38-89.24-51.7-89.24-51.7-4.63 57.65 27.65 99.38 89.25 51.7 89.25 51.7zM767.87 645.54c41.63 15.71 87-2.28 87-2.28s-22.14-43.45-63.77-59.16-87 2.27-87 2.27 22.15 43.46 63.77 59.17zM863.28 566.75c34.65-4.52 59.4-33.77 59.4-33.77s-31.43-21.9-66.09-17.37-59.4 33.77-59.4 33.77 31.44 21.9 66.09 17.37zM909.85 477c24.22-21.42 28.06-56.66 28.06-56.66s-35.45-0.52-59.68 20.9-28.05 56.67-28.05 56.67 35.44 0.49 59.67-20.91zM877 421s28-16.7 36.61-45.15-5.34-57.85-5.34-57.85-28 16.7-36.61 45.15S877 421 877 421zM886.74 293.67c1.61-23.66-14.54-44-14.54-44s-18.78 18-20.39 41.65 14.54 44 14.54 44 18.78-17.98 20.39-41.65zM832.32 279s13.8-19.52 11.13-41.16-20.82-37.21-20.82-37.21-13.8 19.52-11.12 41.16S832.32 279 832.32 279zM797.59 216.08s5.2-18.05-2.37-33.41-25.06-22.22-25.06-22.22-5.19 18 2.38 33.4 25.05 22.23 25.05 22.23zM747.26 171.54s2.11-12.36-4.06-22-18.26-12.88-18.26-12.88-2.11 12.35 4 22 18.32 12.88 18.32 12.88zM699.94 138.73s1.54-6.94-1.69-12.56-10-7.8-10-7.8-1.54 6.94 1.69 12.56 10 7.8 10 7.8zM438.92 197.2s21.54 31.44 55.38 39.42 67.16-10.52 67.16-10.52-21.54-31.44-55.38-39.42-67.16 10.52-67.16 10.52zM641 177.05c-24.17-20.07-58.59-18.5-58.59-18.5s4.79 34.12 29 54.19 58.59 18.5 58.59 18.5-4.83-34.11-29-54.19zM700.68 269.41c6.26 27.37 31.54 44.94 31.54 44.94s15.12-26.82 8.86-54.19-31.55-44.93-31.55-44.93-15.12 26.77-8.85 54.18zM731.71 383.33s26.87-3.64 42.76-22.6 14.77-46.06 14.77-46.06-26.87 3.65-42.76 22.61-14.77 46.05-14.77 46.05zM739.66 450c21.1-3.53 35.59-22 35.59-22s-19.71-12.71-40.8-9.18-35.6 22-35.6 22 19.71 12.68 40.81 9.18zM639.22 451s7.68 15.5 24 21.6 35.21 0.48 35.21 0.48-7.69-15.51-24.05-21.6-35.16-0.48-35.16-0.48zM602.44 455.86c5.69 13.55 20.31 20.34 20.31 20.34s5.39-15.19-0.3-28.75-20.32-20.34-20.32-20.34-5.39 15.19 0.31 28.75zM588.38 415.51c4-10.64-0.64-22.2-0.64-22.2s-11.08 5.69-15.06 16.33 0.65 22.2 0.65 22.2 11.08-5.69 15.05-16.33zM582 374s-8.37-0.09-14.59 5.63-7.94 15.09-7.94 15.09 8.38 0.09 14.6-5.63S582 374 582 374zM588 357c-7.1-0.52-13.23 4.3-13.23 4.3s5.37 5.66 12.47 6.18 13.24-4.3 13.24-4.3-5.37-5.64-12.48-6.18zM614.5 354.32c-3.72-4.05-9.73-4.59-9.73-4.59s0 6 3.74 10.08 9.73 4.59 9.73 4.59-0.03-6.03-3.74-10.08zM624.75 362.63c0 4.21 3.14 7.61 3.14 7.61s3.09-3.43 3.07-7.64-3.15-7.62-3.15-7.62-3.09 3.44-3.06 7.65zM636.73 372.32a11.32 11.32 0 0 0 0.77-6.28 8.63 8.63 0 0 0-4.32 3.88 11.33 11.33 0 0 0-0.76 6.27 8.64 8.64 0 0 0 4.31-3.87zM627.44 382.36a6.83 6.83 0 0 0 9.16-2.74 6.83 6.83 0 0 0-9.16 2.74zM621.13 384.28a5.28 5.28 0 0 0 6.6 3.31 5.28 5.28 0 0 0-6.6-3.31z" fill="#2EAD38" p-id="3083"></path></svg>