svg 是干什么的
SVG 是用文本描述图形的图片格式:一个 <svg> 标签里放若干图形元素,浏览器按坐标和属性现画出来,所以放到多大都不糊。
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 120 120" width="120" height="120">
<circle cx="60" cy="60" r="50" fill="#2563eb"/>
</svg>
把这段存成 logo.svg 用浏览器打开,就是一个蓝圆。它和 PNG 的区别不只是"矢量"两个字,而是所有信息都在代码里:颜色、半径、描边宽度都能直接改,改完刷新就是新图,不用重新导出。
图标、logo、流程图、图表这类由线条和色块组成的图适合 SVG;照片和复杂插画不适合,硬转成 SVG 只会得到一个又大又糊的文件。
这一页的代码写在哪
三种用法,规则不一样:
| 用法 | 写法 | 注意 |
|---|---|---|
| HTML 里内联 | 直接把 <svg> 写在页面结构中 |
可以省 xmlns,能用 CSS 和 currentColor |
| 单独 .svg 文件 | <img src="logo.svg"> 或直接打开 |
xmlns 不能省,否则可能被当成非法 XML |
| CSS 背景 | background-image: url(logo.svg) |
不能引用外部资源,也拿不到 currentColor |
本页条目里:以 <svg 开头的整段可以直接存成 .svg 文件;只有 <rect .../> 这类单个元素的,要放进已有的 <svg> 里,单独打开是空白的。
viewBox 到底在干什么
一句话:viewBox 决定"内部坐标系里哪一块区域被画到屏幕上",它定义的是坐标系和取景范围,不是图片的显示大小。
一、坐标系原点在左上角,y 向下增大
SVG 的 (0,0) 在左上角,x 往右变大、y 往下变大,和数学课的坐标系上下相反。 写 y="10" 是靠上,写 y="100" 是靠下。
这直接决定了常用属性的含义:rect 的 x/y 是左上角;circle 的 cx/cy 是圆心;text 的 y 是文字基线而不是顶部,所以文字看起来总比写的 y 低一点。
二、viewBox 是取景框
viewBox="0 0 200 100" 的四个数依次是:取景框左上角的 x、左上角的 y、取景框宽、取景框高。
- 前两个可以是负数,写
viewBox="-50 -50 100 100"等于把原点挪到画布中心; - 后两个是"能看见多大范围",不是右下角的坐标;
- 取景框宽高比和
width/height不一致时,由preserveAspectRatio决定留白还是裁切。
三、为什么改了 viewBox 图形会缩放
因为图形坐标一个没动,取景框却变小了,同样的坐标在屏幕上占的比例就变大。图形画在 0 0 200 200 里,改成 viewBox="50 50 100 100" 后只取中间 100×100 那块铺满屏幕,视觉上放大 2 倍,代价是四周被裁掉。
反过来把 viewBox 放大到 -50 -50 300 300,图形缩小、四周多出空白。要缩放整张图,改 viewBox 或 width/height,不要去改每个图形的坐标。
四、width/height 和 viewBox 是什么关系
width/height:这张图在页面上占多大,可以写100%或省略(省略时按 viewBox 比例自适应);viewBox:内部坐标范围;- 两者比例不一致时,默认
preserveAspectRatio="xMidYMid meet"会等比缩放并居中留白,不会拉变形。
只写 viewBox、不写 width/height,图会撑满父容器,做响应式图标最常用;两个都写死就是固定尺寸。
五、图形超出 viewBox 会怎样
超出取景框的部分直接不可见,不报错、没有滚动条,也不会把画布撑大。 常见现象是"代码里明明画了圆,页面只看到半圆"——不是没画,是圆心跑到框外了。想完整显示就扩大 viewBox,或把图形挪回框内。
六、preserveAspectRatio 怎么选
默认 xMidYMid meet:等比缩放到能完整装进取景框,多出来的方向留空。改成 slice 会填满整个框但裁掉超出部分,做封面图时常用;none 会强行拉伸变形,几乎不该用。
语法骨架
<svg xmlns="http://www.w3.org/2000/svg" width viewBox preserveAspectRatio>
<defs> 渐变、滤镜、symbol 的存放处,本身不显示
<g> 分组,可带 transform 和统一样式
<rect> <circle> <ellipse> <line> <polyline> <polygon> <path> <text>
</svg>
| 元素 / 属性 | 作用 | 必记点 |
|---|---|---|
viewBox |
取景框 | 四个数:左上 x、左上 y、宽、高 |
fill |
填充 | 默认黑色;none 才是不填充 |
stroke |
描边 | 默认 none,线类图形不写就看不见 |
stroke-width |
描边宽度 | 单位是用户坐标,会跟着 viewBox 缩放 |
path d |
路径 | M/L/C/A/Z 可混用,大小写决定绝对/相对 |
transform |
变换 | translate / rotate / scale,按从左到右生效 |
use href |
复用 | 引用 defs 或 symbol 里定义的 id |
常见坑
line/polyline不写stroke就完全看不见,它们的fill默认无效;text的y是基线,不是顶部;垂直居中要dominant-baseline="central";- 同页多个 SVG 的 id 会互相串:两个
linearGradient id="g1",后引用的可能是前一个的渐变; transform会连带描边和阴影一起变,只想挪位置就改x/y或cx/cy;- 作为
background-image或<img>引用时拿不到currentColor,想跟随文字颜色必须内联; - 描边默认画在路径中央,一半在图形内一半在外,所以加了
stroke-width的图形视觉上比写的大一圈。
排错:图看不见,按这四步查
第一步看取景框。 把 viewBox 和图形的 cx/cy、x/y 放在一起比:viewBox="0 0 100 100" 里写 cx="150",图形就在框外,页面上什么都没有。先把 viewBox 放大到 0 0 200 200 确认图形存在,再决定是挪图形还是改取景框。
第二步看颜色。 line、polyline、path 这类开放图形只有 stroke 生效,fill 默认黑色也画不出来(线没有面积);写成 fill="none" 却忘了 stroke,同样是一片空白。反过来,fill="#fff" 放在白底页面上也会"看不见",改个底色或加描边就能确认它一直在。
第三步看 id 引用。 渐变、滤镜、use 全靠 id 关联,id 写错、重复或者大小写不一致都不会报错,只是效果不出现。同一页面里两个 SVG 各自定义了 id="grad",浏览器只会认其中一个,后一个图形可能拿到前一个的渐变——id 加上模块前缀最省事。
第四步看父容器。 只写 viewBox、不写 width/height 时,SVG 默认宽度 100%、高度按比例算;但父容器如果是 display:flex 且没有高度,或者被 height: 0 的折叠容器包着,图就会被压成一条线。给父容器一个明确高度,或直接写死 width/height 验证。
单位的问题也要留意:SVG 属性里的数值默认就是用户坐标,width="100" 和 width="100px" 等价,写成 100% 才是相对父容器。在 CSS 里给 <svg> 设 width: 100% 时,高度不写就按 viewBox 比例自适应,这和普通块级元素的规则不同。
把设计稿尺寸换算成 viewBox
最省事的做法:viewBox 直接用设计稿的像素画布,图形坐标照抄设计稿标注。 1920×1080 的画布就写 viewBox="0 0 1920 1080",元素该在 (240,180) 就写 (240,180),一个数都不用换算。
需要适配不同尺寸时,只改 width/height(或交给 CSS 的 width:100%),不要反过来去改 viewBox:改 viewBox 等于裁切或放大画面,原本对齐的元素会一起移位。
图标类素材建议固定成 24×24 或 32×32 的 viewBox,所有图标共用同一套坐标,use 复用时尺寸才好统一。
常见用法示例
1. 一个能直接用的图标
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="24" height="24">
<path d="M4 10.8h9.2V6l6.8 6-6.8 6v-4.8H4z" fill="currentColor"/>
</svg>
执行前:只是一段代码。执行后:存成 arrow.svg 打开是黑色箭头;内联进按钮、给按钮设 color: #2563eb,箭头跟着变蓝,因为 fill="currentColor" 取的是文字颜色。
2. 圆角按钮
<svg xmlns="http://www.w3.org/2000/svg" width="200" height="48" viewBox="0 0 200 48">
<rect x="0" y="0" width="200" height="48" rx="24" fill="#2563eb"/>
<text x="100" y="24" text-anchor="middle" dominant-baseline="central"
fill="#fff" font-size="16">下载</text>
</svg>
rx 等于高度一半时得到完整胶囊。文字居中靠 text-anchor 和 dominant-baseline,不是靠反复调 y 试出来的。
3. 同一张图放大两倍
<!-- 原图 -->
<svg viewBox="0 0 200 200" width="200" height="200">
<circle cx="100" cy="100" r="80" fill="#dbeafe" stroke="#2563eb" stroke-width="4"/>
</svg>
<!-- 只改取景框,图形坐标不动 -->
<svg viewBox="50 50 100 100" width="200" height="200">
<circle cx="100" cy="100" r="80" fill="#dbeafe" stroke="#2563eb" stroke-width="4"/>
</svg>
执行前:200×200 的整图。执行后:只显示中间 100×100 那块,铺满同样的 200×200 屏幕,视觉放大 2 倍,边缘被裁。这就是"改 viewBox 等于改缩放"的完整含义。
4. 渐变加投影
<svg xmlns="http://www.w3.org/2000/svg" width="200" height="120" viewBox="0 0 200 120">
<defs>
<linearGradient id="cardGrad" x1="0" y1="0" x2="1" y2="1">
<stop offset="0" stop-color="#2563eb"/>
<stop offset="1" stop-color="#7c3aed"/>
</linearGradient>
<filter id="cardShadow" x="-30%" y="-30%" width="160%" height="160%">
<feDropShadow dx="0" dy="4" stdDeviation="6" flood-color="#000" flood-opacity="0.3"/>
</filter>
</defs>
<rect x="20" y="20" width="160" height="80" rx="12"
fill="url(#cardGrad)" filter="url(#cardShadow)"/>
</svg>
执行前:一块纯色矩形。执行后:左上到右下的蓝紫渐变加一层柔和投影。两个 url 都靠 id 引用,id 写错不会报错,只是没有效果——渐变不生效时先查 id 拼写。
5. 一组图形复用
<svg xmlns="http://www.w3.org/2000/svg" width="240" height="80" viewBox="0 0 240 80">
<defs>
<symbol id="dot" viewBox="0 0 24 24">
<circle cx="12" cy="12" r="10" fill="currentColor"/>
</symbol>
</defs>
<use href="#dot" x="10" y="28" width="24" height="24" color="#2563eb"/>
<use href="#dot" x="60" y="28" width="24" height="24" color="#7c3aed"/>
<use href="#dot" x="110" y="28" width="24" height="24" color="#059669"/>
</svg>
symbol 自带 viewBox 且不直接显示,use 按 x/y/width/height 摆放。改一次 symbol 里的形状,所有引用同时变;每个 use 再用 color 单独换色,这就是图标系统的常见做法。