SVG.md · Jay_Ohhh/front-end notes

概述

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

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

SVG 代码也可以写在一个独立文件中，然后用<img>、<object>、<embed>、<iframe>等标签插入网页。

CSS 也可以使用 SVG 文件

.logo {
  background: url(icon.svg);
}

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

<img src="data:image/svg+xml;base64,[data]">

语法和行内属性

width和height

<svg width="100%" height="100%">
  <circle id="mycircle" cx="50" cy="50" r="50" />
</svg>

<svg>的width属性和height属性，指定了 SVG 图像在 HTML 元素中所占据的宽度和高度。除了相对单位，也可以采用绝对单位（单位：像素）。如果不指定这两个属性，SVG 图像默认宽度是300px , 高度是150px。如果设置了viewBox属性时，没指定width和height，则默认的宽度和高度则是所在的HTML元素的宽高。

viewBox

如果只想展示 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 图像的大小，即放大了四倍。即viewBox先通过矩形框裁剪SVG的内容，然后viewBox视口会变成SVG宽高大小，可以用来放大或缩小SVG的内容。更多

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

id svg 元素的唯一标识

**class ** svg 元素的 class 标识，常用于css样式设置

**stroke ** 定义 svg 元素的描边颜色

stroke-width

stroke-width: 2px stroke-width: 2em stroke-width: 2 stroke-width: 2.5 stroke-width: 15%

值为纯数字时（没单位和没百分号）是基于viewBox的大小。stroke-width也是SVG的CSS属性。例如，stroke-width: 5 在设置为0 0 100 100（5/100=.05或5%）的viewBox中，stroke-width值为5与5%相同；但在0 0 50 50（5/50=.1或10%）的viewBox中为10%。

stroke-linecap

定义不同类型的开放路径的终结

butt：默认值，端点是垂直于线段边缘的平直边缘（与边缘平直）。
round：端点是在线段边缘处以线宽为直径的半圆（超出边缘）。
square：端点是在选段边缘处以线宽为长、以一半线宽为宽的矩形（超出边缘）。

stroke-linejoin

线条的连接点，三个属性值

miter，默认值，直接连接，创建尖角。
bevel，连接处为斜角（切去尖角）。
round，连接处为圆角。

stroke-dasharray

用于创建虚线，实线长度—间距—实线长度—间距—...

 stroke-dasharray="20,10,5,5,5,10"

stroke-opacity 定义 svg 元素的描边透明度

**fill ** 定义 svg 元素的填充颜色

**fill-opacity ** 定义 svg 元素的填充透明度

**transform ** 定义 svg 元素的变换，包括移动、旋转、放缩等，与CSS类似，例如

将圆顺时针旋转30度，向左平移30，向下平移40，缩小成原来的0.5倍
<circle cx="25" cy="25" r="20" transform="rotate(30) translate(-30 40) scale(0.5)" />

`<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: 3px;
}

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

fill：填充色
stroke：描边色
stroke-width：边框宽度

`<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属性表示线段的样式。

`<polyline>`标签（折线）

<svg width="300" height="180">
  <polyline points="3,3 30,28 3,53" fill="none" stroke="black" />
</svg>

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

`<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属性指定了矩形的宽度和高度（单位像素）。

`<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属性，指定了椭圆横向轴和纵向轴的半径（单位像素）。

`<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>

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

`<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：闭合路径

`<text>`标签（文本）

<svg width="300" height="180">
  <text x="50" y="25">Hello World</text>
 </svg>

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

`<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。

`<g>`标签（组，group）

标签用于将多个形状组成一个组（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>

`<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>

`<pattern>`标签（模式，填充图案）

<pattern>标签常和<defs>标签配合使用，用于自定义一个形状，该形状可以被引用来平铺一个区域。

<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>
  <-- 通过引用pattern的id来对矩形进行填充 -->
  <rect x="0" y="0" width="100%" height="100%" fill="url(#dots)" />
</svg>

patternUnits="objectBoundingBox"（默认值）表示<pattern>的宽度和长度是相对值，此时width和height必须小于1.0。图案会根据外层元素变化缩放。 patternUnits="userSpaceOnUse"表示<pattern>的宽度和长度是绝对的像素值。图案不会缩放。

`<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属性表示图像的来源。

`<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>

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

attributeName：发生动画效果的属性名。
from：单次动画attributeName的初始值。
to：单次动画attributeName的结束值。
dur：单次动画的持续时间。
repeatCount：动画的循环模式。

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

<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>标签。

<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)旋转。

JS 操作 SVG

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

<svg id="mysvg">
    <circle id="mycircle" cx="400" cy="300" r="50" />
<svg>

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

var mycircle = document.getElementById('mycircle');

获取 SVG DOM

使用、<iframe>、标签插入 SVG 文件，可以获取 SVG DOM。

var svgObject = document.getElementById('object').contentDocument;
var svgIframe = document.getElementById('iframe').contentDocument;
var svgEmbed = document.getElementById('embed').getSVGDocument();

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

读取 SVG 源码

由于 SVG 文件就是一段 XML 文本，因此可以通过读取 XML 代码的方式，读取 SVG 源码。使用XMLSerializer实例的serializeToString()方法，获取 SVG 元素的代码。

var svgString = new XMLSerializer().serializeToString(document.querySelector('svg'));

SVG 图像转为 Canvas 图像

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

var img = new Image();
// svgString是上面所述
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;

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

img.onload = function () {
    var canvas = document.getElementById('canvas');
    var ctx = canvas.getContext('2d');
    ctx.drawImage(img, 0, 0)
 }

URL.createObjectURL()方法会根据传入的参数对象创建一个指向该参数对象的URL。这个URL的生命仅存在于它被创建的这个文档里。新的对象URL指向执行的File对象或者是Blob对象。

// 可省略window
objectURL = window.URL.createObjectURL(blob || file);

每次调用createObjectURL的时候,一个新的URL对象就被创建了。即使你已经为同一个文件创建过一个URL。如果你不再需要这个对象,要释放它,需要使用URL.revokeObjectURL( objectURL)方法。当页面被关闭,浏览器会自动释放它，但是为了最佳性能和内存使用，当确保不再用得到它的时候,就应该释放它。

支持性

inline SVG 支持资源外链支持CSS 支持JS
img SVG 不支持资源外链支持内部CSS 不支持JS
background-img SVG 不支持资源外链支持内部CSS 不支持JS
background-img BASE64 SVG 不支持资源外链支持内部CSS 不支持JS
object SVG 支持资源外链支持内部CSS 支持内部JS
embed SVG 支持资源外链支持内部CSS 支持内部JS
iframe SVG 支持资源外链支持内部CSS 支持内部JS

你会发现几乎在所有情况下. SVG都支持内部CSS. 即在SVG内部写 style 标签定义其自身的样式. (注意: inline SVG 的 style 标签会污染外部 HTML 的 style)

Jay_Ohhh / front-end notes

概述

语法和行内属性

`<circle>`标签（圆形）

`<line>`标签（直线）

`<polyline>`标签（折线）

`<rect>`标签（矩形）

`<ellipse>`标签（椭圆）

`<polygon>`标签（多边形）

`<path>`标签（路径）

`<text>`标签（文本）

`<use>`标签（复制、深拷贝）

`<g>`标签（组，group）

`<defs>`标签（自定义形状，仅供引用）

`<pattern>`标签（模式，填充图案）

`<image>`标签（插入图片）

`<animate>`标签（动画）

`<animateTransform>`标签（动画变形）

JS 操作 SVG

获取 SVG DOM

读取 SVG 源码

SVG 图像转为 Canvas 图像

支持性

简介

发行版

贡献者

近期动态

Jay_Ohhh / front-end notes .gitee-modal { width: 500px !important; }

概述

语法和行内属性

<circle>标签（圆形）

<line>标签（直线）

<polyline>标签（折线）

<rect>标签（矩形）

<ellipse>标签（椭圆）

<polygon>标签（多边形）

<path>标签（路径）

<text>标签（文本）

<use>标签（复制、深拷贝）

<g>标签（组，group）

<defs>标签（自定义形状，仅供引用）

<pattern>标签（模式，填充图案）

<image>标签（插入图片）

<animate>标签（动画）

<animateTransform>标签（动画变形）

JS 操作 SVG

获取 SVG DOM

读取 SVG 源码

SVG 图像转为 Canvas 图像

支持性

简介

发行版

贡献者

近期动态

搜索帮助

Jay_Ohhh / front-end notes

`<circle>`标签（圆形）

`<line>`标签（直线）

`<polyline>`标签（折线）

`<rect>`标签（矩形）

`<ellipse>`标签（椭圆）

`<polygon>`标签（多边形）

`<path>`标签（路径）

`<text>`标签（文本）

`<use>`标签（复制、深拷贝）

`<g>`标签（组，group）

`<defs>`标签（自定义形状，仅供引用）

`<pattern>`标签（模式，填充图案）

`<image>`标签（插入图片）

`<animate>`标签（动画）

`<animateTransform>`标签（动画变形）