SVG 图像入门教程

作者： 阮一峰 

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


一、概述

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 属性与网页元素有所不同。


1、fill：填充色

2、stroke：描边色

3、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属性表示绘制顺序，它的值是一个长字符串，每个字母表示一个绘制动作，后面跟着坐标。


1、M：移动到（moveto）

2、L：画直线到（lineto）

3、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>的属性含义如下。

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

2、from：单次动画的初始值。

3、to：单次动画的结束值。

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

5、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>


五、参考书籍

1、Jon McPartland, An introduction to SVG animation

2、Alexander Goedde, SVG – Super Vector Graphics

3、Joseph Wegner, Learning SVG

4、biovisualize, Direct svg to canvas to png conversion

5、Tyler Sticka, Cropping Image Thumbnails with SVG

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

感兴趣的小伙伴，可以关注公众号【grain先森】，回复关键词 “小程序”，获取更多资料，更多关键词玩法期待你的探索~

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 203,456评论 5赞 477
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 85,370评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 150,337评论 0赞 337
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,583评论 1赞 273
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,596评论 5赞 365
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,572评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 37,936评论 3赞 395
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,595评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 40,850评论 1赞 297
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,601评论 2赞 321
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,685评论 1赞 329
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,371评论 4赞 318
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 38,951评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,934评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,167评论 1赞 259
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 43,636评论 2赞 349
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,411评论 2赞 342

推荐阅读更多精彩内容

  • SVG 图像入门教程
    一、概述 SVG 是一种基于 XML 语法的图像格式，全称是可缩放矢量图（Scalable Vector Grap...
    CRUD_科科阅读 605评论 0赞 1
  • Svg实战总结（二）
    接着上篇文章继续往后讲解其他知识点，感谢读者们愿意花费您们宝贵时间阅读！ 使用滤镜filter（也是设置阴影） <...
    lilyping阅读 805评论 0赞 0
  • SVG 入门
    一、栅格图形和矢量图形栅格图形：也称位图，图像由一组二维像素网格表示。Canvas 2d API 就是一款栅格图形...
    linda102阅读 1,125评论 0赞 4
  • SVG笔记
    一：什么是SVG？ 对于SVG的定义如下： ①：SVG 指的是可伸缩矢量图形 (Scalable Vector G...
    GreenHand1阅读 794评论 0赞 1
  • 2018-09-14_D3.js
    Data Visualization with D3 D3: SVG中的jQurey 1. Add Documen...
    王策北阅读 751评论 0赞 2