SVG · 前端小册

部分参考（Copy）：[http://www.ruanyifeng.com/blog/2018/08/svg.html](http://www.ruanyifeng.com/blog/2018/08/svg.html) [TOC] >[success]这里记录下 svg 的一些 API，主要想探索下用 svg 实现一些 CSS 不好实现的图案及动画效果。 # 如何在项目中使用 svg 1.SVG 文件可以直接插入网页，成为 DOM 的一部分，然后用 JavaScript 和 CSS 进行操作。 ```html <!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> ``` 2.SVG 代码也可以写在一个独立文件中，然后用`<img>`、`<object>`、`<embed>`、`<iframe>`等标签插入网页。 ```html <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> ``` 3.CSS 也可以使用 SVG 文件。 ```css .logo { background: url(icon.svg); } ``` 4.SVG 文件还可以转为 BASE64 编码，然后作为 Data URI 写入网页。 ```html <img src="data:image/svg+xml;base64,[data]"> ``` # 语法 ## \<svg> 标签 ```html <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`属性（如果是 XML 文件注意大小写 viewbox != viewBox） ```html <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 元素的大小。 ![](https://box.kancloud.cn/52c051f30e845a5c1a02330139227c4d_799x605.png =300x) - width、height：控制的是视窗 - SVG 代码定义 SVG 世界 - viewBox，preserveAspectRatio 控制我们的视野 ## \<circle> 标签 ```html <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> ``` ![](https://box.kancloud.cn/d3ecab08986cc0b7df8087506f985584_255x91.png =150x) 上面的代码定义了三个圆。`<circle>`标签的`cx`、`cy`、`r`属性分别为横坐标、纵坐标和半径，单位为像素。坐标都是相对于`<svg>`画布的左上角原点。 ![](https://box.kancloud.cn/34b675eadf2d47cf76c5fbf2230910bb_591x414.png =300x) `class`属性用来指定对应的 CSS 类 ```css .red { fill: red; } .fancy { fill: none; stroke: black; stroke-width: 3pt; } ``` SVG 的 CSS 属性与网页元素有所不同。 - fill：填充色 - stroke：描边色 - stroke-width：边框宽度 ## \<line> 标签 ```html <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`属性表示线段的样式。 ## \<polyline> 标签 `<polyline>`标签用于绘制一根折线。 ```html <svg width="300" height="180"> <polyline points="3,3 30,28 3,53" fill="#ccc" stroke="black" /> </svg> ``` ![](https://box.kancloud.cn/9c70f38dec067a1bc08cd0bcab7d7cb5_107x105.png ) `<polyline>`的`points`属性指定了每个端点的坐标，横坐标与纵坐标之间与逗号分隔，点与点之间用空格分隔。 ## \<rect> 标签 ```html <svg width="300" height="180"> <rect x="0" y="0" height="100" width="200" style="stroke: #70d5dd; fill: #dd524b" /> </svg> ``` ![](https://box.kancloud.cn/aeb2c5d2006ed8778a279ecb1b3fdb8f_289x148.png =150x) `<rect>`的`x`属性和`y`属性，指定了矩形左上角端点的横坐标和纵坐标；`width`属性和`height`属性指定了矩形的宽度和高度（单位像素）。 ![](https://box.kancloud.cn/b8d90b1bd4a2b1bd993a25de82b342cc_612x431.png =300x) ## \<ellipse> 标签 ellipse 标签用于绘制椭圆。 ```html <svg width="300" height="180"> <ellipse cx="60" cy="60" ry="40" rx="20" stroke="skyblue" stroke-width="5" fill="#58a"/> </svg> ``` ![](https://box.kancloud.cn/bee90537564ef03d560b9bb174f6ca1c_100x130.png ) `<ellipse>`的`cx`属性和`cy`属性，指定了椭圆中心的横坐标和纵坐标（单位像素）；`rx`属性和`ry`属性，指定了椭圆横向轴和纵向轴的半径（单位像素）。 ![](https://box.kancloud.cn/7e96c6c9a551209a461455c6f38d73d7_608x414.png =300x) ## \<polygon> 标签 polygon 标签用于绘制多边形。 ```html <svg width="300" height="180"> <polygon fill="#58a" stroke="skyblue" stroke-width="3" points="50,0 150,0 180,100 20,100"/> </svg> ``` ![](https://box.kancloud.cn/f5c129505a1506ec8f43e587c85aefda_224x149.png =150x) `<polygon>`的`points`属性指定了每个端点的坐标，横坐标与纵坐标之间与逗号分隔，点与点之间用空格分隔。 ## \<path> 标签 path 用于绘制路径。 ```html <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> ``` ![](https://box.kancloud.cn/c43c263fd5733d694c04975ad4ef3000_111x107.png) `<path>`的`d`属性表示绘制顺序，它的值是一个长字符串，每个字母表示一个绘制动作，后面跟着坐标。 - M：移动到（moveto） - L：画直线到（lineto） - Z：闭合路径 ## \<text> 标签 text 标签用于绘制文本。 ```html <svg width="300" height="180"> <text x="50" y="25">Hello World</text> </svg> ``` `<text>`的`x`属性和`y`属性，表示文本区块基线（baseline）起点的横坐标和纵坐标。文字的样式可以用`class`或`style`属性指定。 ## \<use> 标签 use 标签用于复制一个形状。 ```html <svg width="300" height="300"> <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> ``` ![](https://box.kancloud.cn/85f9cff45ca30960afa3599ed829c199_87x58.png) `<use>`的`href`属性指定所要复制的节点，`x`属性和`y`属性是`<use>`左上角的坐标。另外，还可以指定`width`和`height`坐标。 ## \<g> 标签 g 标签用于将多个形状定义成一个组，方便复用。 ```html <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> ``` ## \<defs> 标签 `<defs>`标签用于自定义形状，它内部的代码不会显示，仅供引用。 ```html <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> ``` ## \<pattern> 标签 `<pattern>`标签用于自定义一个形状，该形状可以被引用来平铺一个区域。 ```html <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> ``` ![](https://box.kancloud.cn/824cb38a1feba991b6081c5bbfb8f7ed_612x613.png =150x) 上面代码中，`<pattern>`标签将一个圆形定义为`dots`模式。`patternUnits="userSpaceOnUse"`表示`<pattern>`的宽度和长度是实际的像素值。然后，指定这个模式去填充下面的矩形。 ## \<image> 标签 `<image>`标签用于插入图片文件。 ```html <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`属性表示图像的来源。 ## \<animate> 标签 `<animate>`标签用于产生动画效果。 ```html <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：动画的循环模式。可以在多个属性上面定义动画。 ```html <animate attributeName="x" from="0" to="500" dur="2s" repeatCount="indefinite" /> <animate attributeName="width" to="500" dur="2s" repeatCount="indefinite" /> ``` ## \<animateTransform> 标签 `<animate>`标签对 CSS 的`transform`属性不起作用，如果需要变形，就要使用`<animateTransform>`标签。 ```html <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> ``` ![](https://box.kancloud.cn/8043eeae7e933e0cd9756e7d9a6bdcda_624x290.gif =300x) 上面代码中，`<animateTransform>`的效果为旋转（`rotate`），这时`from`和`to`属性值有三个数字，第一个数字是角度值，第二个值和第三个值是旋转中心的坐标。`from="0 200 200"`表示开始时，角度为0，围绕`(200, 200)`开始旋转；`to="360 400 400"`表示结束时，角度为360，围绕`(400, 400)`旋转。 # JavaScript 操作 svg 如果 SVG 代码直接写在 HTML 网页之中，它就成为网页 DOM 的一部分，可以直接用 DOM 操作。 ```html <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> ``` ```js var mycircle = document.getElementById('mycircle'); mycircle.addEventListener('click', function(e) { console.log('circle clicked - enlarging'); mycircle.setAttribute('r', 60); }, false); ``` - 创建图形：document.createElementNS(ns, tagName) - 添加图形：element.appendChild(childElement) - 设置、获取属性：element.setAttribute(name, value), element.getAttribute(name) # SVG 图像转换为 Canvas 图像首先，需要新建一个`Image`对象，将 SVG 图像指定到该`Image`对象的`src`属性。 ```js 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>`元素。 ```js img.onload = function () { var canvas = document.getElementById('canvas'); var ctx = canvas.getContext('2d'); ctx.drawImage(img, 0, 0); }; ``` # 实例