You-need-to-know-css 实战:纯 CSS 与 SVG 双方案实现简易饼图

原创2026-10-12 11:31:231,686 阅读
文章标签:前端文档教程

You-need-to-know-css 实战:纯 CSS 与 SVG 双方案实现简易饼图

本篇以 zh-cn/pie-chart.md(简易饼图)为蓝本,系统拆解 You-need-to-know-css 仓库中"常见形状"一节给出的 5 个可运行演示,覆盖线性渐变半色圆盘、伪元素半圆扇叶、旋转动画、负动画延迟以及 SVG stroke-dasharray / stroke-dashoffset 百分比化等技法。读完后你将掌握两条完全不依赖图片素材与图表库的饼图实现路线,并能在仓库自带的 docsify 站点中直接运行、修改与验证这些示例。

一、方案总览:两条技术路线与五种演示形态

原文档以 <vuep template="#pie-chart"></vuep> 的形式内置了一个可交互演示,页面中依次呈现 5 个饼图(文档原序号为 ①、②、④、⑤、⑥),分别演示不同的实现手法:

演示 核心技巧 技术路线
① rotate() linear-gradient 半色圆盘 + ::before 半圆扇叶 + transform: rotate(.3turn) 静态定位 纯 CSS
② CSS 动画 在 ① 基础上叠加旋转动画与背景翻转动画,动态填充 纯 CSS
④ 从指定位置开始动画 使用负值 animation-delay: -1.5s 使动画从中途位置开始 纯 CSS
⑤ SVG 将 dasharray 转化为百分比 用 stroke-dasharray 从 0 100 动画到 100 100,把圆周长近似当作 100 SVG
⑥ SVG 添加多种颜色 三层 <circle> 叠加,用 stroke-dashoffset 错位 + 三段百分比(36% + 32% + 32%)拼满整圆 SVG

两条技术路线的分工很清晰:纯 CSS 路线依赖渐变与动画,代码直观、无额外标签;SVG 路线借助描边属性天然"按周长百分比"工作的特性,更适合精确占比与多数据段场景。实现这两个方案需要的前置知识分别是线性渐变(linear-gradient)、CSS 动画(@keyframes / animation)与 SVG 基础,原文档在开头已给出提示。

二、纯 CSS 路线:渐变半盘 + 伪元素扇叶

2.1 半色圆盘:用 linear-gradient 的硬色标一分为二

饼图的地基是一个 100×100 的圆盘(zh-cn/pie-chart.md#L27-L33):

.chart > div {
  width: 100px;
  height: 100px;
  border-radius: 50%;
  background-color: #E8E2D6; /* 左半圆的底色 */
  background-image: linear-gradient(to right, transparent 50%, #b4a078 0);
}

这里的关键是 linear-gradient(to right, transparent 50%, #b4a078 0):渐变方向为从左到右,第一个色标 transparent 50% 表示前 50% 完全透明,第二个色标 #b4a078 0 中的 0 表示该色标紧跟在 50% 处开始(硬色标技巧,颜色在 50% 位置瞬间切换而非平滑过渡)。于是:

  • 左半圆(0%–50%)透明,露出 background-color 的浅色 #E8E2D6;
  • 右半圆(50%–100%)为项目主色 #b4a078(米棕色)。

同样的渐变硬色标手法在仓库的条纹背景一节也有使用(如 repeating-linear-gradient 制作条纹进度条),可以对照阅读。配色方面,#E8E2D6 与 #b4a078 均来自项目介绍中说明的网易严选设计规范色板,全仓库示例配色保持一致。

2.2 半圆扇叶:border-radius 双轴语法与定位

要让圆盘"缺一角",需要再用 ::before 伪元素造出一个可旋转的半圆扇叶(zh-cn/pie-chart.md#L34-L43):

.chart > div::before {
  content: "";
  display: block;
  margin-left: 50%;            /* 把半圆推到圆盘右半 */
  height: 100%;
  border-radius: 0 100% 100% 0 / 0 50% 50% 0; /* 右半圆 */
  background-color: inherit;   /* 继承父级底色,先盖住右半的 #b4a078 */
  transform-origin: 0 50%;     /* 旋转轴 = 半圆左边缘中点 = 圆盘圆心 */
  transform: rotate(.3turn);   /* ① 静态:108° 扇区 */
}

逐个拆解这四条关键声明:

  • margin-left: 50%:伪元素宽度即父元素宽度(100px),左移半个宽度后正好覆盖圆盘右半。
  • border-radius: 0 100% 100% 0 / 0 50% 50% 0:border-radius 支持用 / 分隔"水平半径 / 垂直半径"两组值(每个角分别取水平、垂直两个半径,形成椭圆角)。这里左上/右下为 0,右上/左下水平半径 100%、垂直半径 50%,恰好裁出右侧半圆。这一语法在仓库的圆与椭圆一节有专门讲解——通过 border-radius: 50% / 100% 100% 0 0 等组合可以做出半椭圆、四分之一圆等各类图形。
  • background-color: inherit:扇叶继承父元素的浅色底色。由于扇叶盖在右半,它会暂时"遮住"右半的 #b4a078,让整圆看起来是统一浅色,留出旋转后暴露扇区的空间。
  • transform-origin: 0 50%:把旋转轴心设到扇叶左边缘的中点——也就是整个圆盘的圆心。这是"围绕圆心扫出扇区"的关键。

2.3 静态扇区 ①:rotate(.3turn) 与 turn 单位

transform: rotate(.3turn) 中 .3turn 表示 0.3 圈(1turn = 360°),即 108°。扇叶绕圆心顺时针旋转 108° 后,右侧半圆中 0°–108° 的范围从扇叶下方露出,形成 108° / 360° = 30% 的静态饼图扇区。turn 是 CSS 旋转的原生单位,比角度更适合这类"圈数"语义的表达。

2.4 动态填充 ②:旋转 + 背景翻转的双动画组合

在①的静态基础上,演示②给扇叶同时挂上两个动画(zh-cn/pie-chart.md#L44-L54):

.chart:nth-of-type(2) div::before {
  content: "";
  display: block;
  margin-left: 50%;
  height: 100%;
  border-radius: 0 100% 100% 0 / 0 50% 50% 0;
  background-color: inherit;
  transform-origin: 0 50%;
  animation:
    pie-chart-spin1 3s linear 1.6 forwards,  /* 旋转动画 */
    pie-chart-bg1   3s step-end 1 forwards;  /* 背景翻转动画 */
}
@keyframes pie-chart-spin1 {
  to { transform: rotate(.5turn); }   /* 0 → 180° */
}
@keyframes pie-chart-bg1 {
  to { background: #b4a078; }         /* 扇叶最终翻转为主色 */
}

animation 简写的字段顺序为 name duration timing-function iteration-count fill-mode,因此:

  • pie-chart-spin1 3s linear 1.6 forwards:动画名 pie-chart-spin1,时长 3s,匀速(linear),迭代 1.6 次,结束后保持末帧(forwards)。1.6 次迭代 = 1 整次(0→180°,回到 0°)+ 0.6 次(0→108°),动画最终停在与演示①一致的 .3turn 位置;
  • pie-chart-bg1 3s step-end 1 forwards:时长 3s,时间函数 step-end——颜色不是平滑过渡,而是在动画最后一帧"瞬间"翻转为 #b4a078,随后由 forwards 保持。

两个动画叠加的完整时间线如下:

  1. 0–3s:浅色扇叶从 0° 匀速扫到 180°,下方 #b4a078 右半区逐渐露出,可见扇区从 0% 填到 50%;
  2. 3s 瞬间:step-end 让扇叶底色瞬间变为 #b4a078,此时扇叶盖住左半圆,整圆变为全色;
  3. 3–4.8s:深色扇叶再次从 0° 转到 108° 后停住(forwards 保持末帧),最终呈现"深色圆盘带一个约 20% 的浅色缺口"的收尾状态。

2.5 负延迟 ④:animation-delay: -1.5s 从指定位置开始

演示④与②的动画配置完全相同,只额外追加了一行(zh-cn/pie-chart.md#L55-L68):

.chart:nth-of-type(3) > div::before {
  animation-delay: -1.5s; /* 负延迟:动画从中途开始 */
}

animation-delay 为负值时,动画不会等待,而是直接从时间轴中间"快进"开始:对 3s 的旋转动画而言,-1.5s 意味着启动瞬间已经完成了 1.5s 的进度——扇叶已旋转 90°(25%)。于是饼图在动画开始时就已呈现 25% 填充,随后继续填充至 50%,再经历背景翻转。这种"从指定位置开始动画"的写法常用于:让循环动画在页面加载时不必从头播起,直接呈现到某个中间态。

三、SVG 路线:stroke-dasharray 与 stroke-dashoffset

3.1 为什么选 SVG:圆周长 ≈ 100,dasharray 天然是百分比

SVG 方案的载体是一个 viewBox="0 0 32 32"、半径 r="16" 的圆,配合容器级样式(zh-cn/pie-chart.md#L69-L74):

svg {
  width: 100px; height: 100px;
  transform: rotate(-90deg);  /* 让填充从 12 点钟方向开始 */
  background: #E8E2D6;
  border-radius: 50%;
}

圆周长 2 × π × 16 ≈ 100.53,代码因此把 100 近似当作满圆的长度基准:stroke-dasharray 的数值可以直接按百分比理解,例如 37 100 表示"37 长度的虚线段 + 100 长度的间隔",约等于 36% 弧长。transform: rotate(-90deg) 把 SVG 圆默认的 3 点钟起始点逆时针转到 12 点钟,让填充从顶部顺时针展开(CSS 路线中也有类似的"起始位置"控制需求)。

3.2 单色填充环 ⑤:stroke-dasharray 从 0 100 到 100 100

演示⑤用单个 <circle> 演示"虚线长度增长 = 饼图填充"(zh-cn/pie-chart.md#L75-L81):

.chart:nth-of-type(4) svg > circle {
  fill: #E8E2D6;
  stroke: #b4a078;
  stroke-width: 32;             /* 描边宽度 32,恰好铺满半径 0–32 的圆盘 */
  stroke-dasharray: 0 100;      /* 初始:0 长度虚线 + 100 间隔(不可见) */
  animation: pie-chart-fillup 6s linear infinite;
}
@keyframes pie-chart-fillup {
  to { stroke-dasharray: 100 100; }  /* 虚线段长度增长至 ≈ 满圆周长 */
}

stroke-width: 32 是关键参数:描边默认以路径为中心线绘制,半径为 16 的圆加上 32 宽描边,内外边缘恰好落在半径 0 与 32 处,即整张圆盘都被描边覆盖,fill 只是被压在下层的底色。stroke-dasharray 从 0 100 动画到 100 100,虚线段从 0 增长到 100,深色扇区即从 12 点钟方向顺时针"生长"出整圆,6s linear infinite 让填充周而复始地循环。

3.3 多色饼图 ⑥:三层 circle 错位拼接 36% + 32% + 32%

演示⑥在同一个 <svg> 里放三个完全同心的 <circle>,每层一个颜色、一段弧线(zh-cn/pie-chart.md#L82-L105):

.chart:nth-of-type(5) svg > circle:nth-of-type(1) {
  fill: #fff;
  stroke: #b4a078;             /* 第三段:64% → 100%,约 36% */
  stroke-width: 32;
  stroke-dasharray: 0 100;     /* 36% */
  stroke-dashoffset: -64;      /* 虚线段起点沿圆周前移到 64% 处 */
  animation: pie-chart-per1 2s linear 1 forwards;
}
.chart:nth-of-type(5) svg > circle:nth-of-type(2) {
  fill: transparent;
  stroke: #cabca0;             /* 第二段:32% → 64%,32% */
  stroke-width: 32;
  stroke-dasharray: 0 100;     /* 32% */
  stroke-dashoffset: -32;      /* 虚线段起点在 32% 处 */
  animation: pie-chart-per2 2s linear 1 forwards;
}
.chart:nth-of-type(5) svg > circle:nth-of-type(3) {
  fill: transparent;
  stroke: #e1d9c9;             /* 第一段:0 → 32%,32% */
  stroke-width: 32;
  stroke-dasharray: 0 100;     /* 32% */
  stroke-dashoffset: 0;        /* 虚线段起点在 0(12 点钟方向) */
  animation: pie-chart-per3 2s linear 1 forwards;
}
@keyframes pie-chart-per1 { to { stroke-dasharray: 37 100; } } /* ≈36% */
@keyframes pie-chart-per2 { to { stroke-dasharray: 32 100; } } /* 32% */
@keyframes pie-chart-per3 { to { stroke-dasharray: 32 100; } } /* 32% */

实现思路分三层:

  1. 错位起点:stroke-dashoffset 的负值会使虚线段起点沿路径正向(顺时针)前移。三个圆分别设为 -64、-32、0,把各自虚线段起点推到圆周的 64%、32%、0 处;
  2. 拼接整圆:动画把各段虚线从 0 增长到目标值——37(≈36%)、32、32——三段弧线首尾相接:0→32%(#e1d9c9)、32%→64%(#cabca0)、64%→100%(#b4a078),合计正好 100%;
  3. 同步生长:三个动画同为 2s linear 1 forwards,三色扇区在 2 秒内同步从无到有展开,最后定格为完整的多色饼图。

3.4 两个属性的取值语法

文档源码中以注释形式保留了这两个 SVG 描边属性的取值语法(zh-cn/pie-chart.md#L6):

  • stroke-dashoffset = percentage | length | inherit:可以是百分比、长度值或 inherit,本文示例使用长度值(以 100 为满圆基准,可等价换算为百分比);
  • stroke-dasharray = dasharray | inherit:dasharray 由一组"虚线长度 + 间隔长度"的数值对组成,本文统一使用"长度 间隔"的二元组形式。

四、参数速查表

属性 / 语法 本文示例取值 作用
linear-gradient 硬色标 transparent 50%, #b4a078 0 颜色在 50% 处瞬间切换,把圆盘切成左右两半
border-radius 双轴语法 0 100% 100% 0 / 0 50% 50% 0 分别指定水平/垂直半径,裁出右半圆
transform-origin 0 50% 旋转轴心 = 半圆左边缘中点 = 圆盘圆心
transform: rotate() .3turn(108°)/ .5turn(180°) 以 turn 为单位旋转,1turn = 360°
animation 简写 pie-chart-spin1 3s linear 1.6 forwards 字段顺序:name / duration / timing-function / iteration-count / fill-mode
animation-delay -1.5s 负值:动画从时间轴中途开始
stroke-width 32 描边宽度,半径 16 的圆加 32 宽描边恰好铺满整盘
stroke-dasharray 0 100 / 100 100 / 37 100 虚线长度 + 间隔,长度基准 100 ≈ 圆周长
stroke-dashoffset -64 / -32 / 0 虚线段起点沿圆周前移的距离
svg transform rotate(-90deg) 把默认 3 点钟起点转到 12 点钟

五、在仓库中运行与调试这份演示

本文涉及的示例文件位于 zh-cn/pie-chart.md(另有英文版 pie-chart.md),在侧边栏 zh-cn/_sidebar.md 的"常见形状"分组下登记为"简易饼图"。整个站点基于 docsify 构建:

  • 入口页 index.html 加载了 docsify@4.6.6、libs/vue.min.js、libs/vuep.min.js、libs/search.min.js、libs/prism-markdown.min.js、libs/prism-scss.min.js 与 libs/docsify-pagination.min.js 等资源;
  • 站点配置集中在 libs/index.js(loadSidebar、loadNavbar、搜索插件等);
  • 演示本体通过 <vuep template="#pie-chart"></vuep> 与 <script v-pre type="text/x-template" id="pie-chart"> 模板块声明,由 vuep 在页面里渲染成"代码编辑区 + 实时预览区"(相关样式见 assets/vuep.css 与 assets/index.css 中的 .vuep 规则)。饼图演示的 <script> 块为空,说明它完全由 CSS 驱动,无需任何 JavaScript 逻辑。

本地运行方式(依据 zh-cn/README.md 的快速开始说明):

# 1. 获取仓库(如尚未克隆)
git clone https://gitcode.com/gh_mirrors/yo/You-need-to-know-css

# 2. 全局安装 docsify-cli
npm install docsify-cli -g

# 3. 在仓库根目录启动本地服务
docsify serve

# 4. 浏览器打开
# http://localhost:3000

随后在侧边栏进入"常见形状 → 简易饼图",即可看到 5 个演示并直接在页面的编辑区修改 CSS 实时观察效果。

六、浏览器支持与生产环境建议

原文档末尾依次嵌入了三个兼容性查询面板,分别针对 css-gradients、css-animation 与 svg 三项特性(zh-cn/pie-chart.md#L165-L186)。就本文两套方案依赖的技术而言:linear-gradient、@keyframes 动画、SVG 及其 stroke-dasharray / stroke-dashoffset 描边属性在现代主流浏览器(Chrome、Firefox、Edge、Safari 等)中均已获得良好支持,可在日常项目中放心使用。

两点生产实践建议:

  • 仓库示例未添加厂商前缀,项目介绍 明确建议在生产环境使用 Autoprefixer 做兼容处理;
  • 方案选型上:纯 CSS 路线(渐变 + 旋转动画)适合占比固定、形态简单的场景,代码量小、无额外标签;SVG 路线能精确表达百分比、天然支持多数据段,且在数据更新时只需调整 stroke-dasharray / stroke-dashoffset,更适合作为动态图表的实现基础。

七、小结与关联文档

本文完整继承了 zh-cn/pie-chart.md 的全部演示内容:从 linear-gradient 半色圆盘、::before 半圆扇叶与 transform: rotate(.3turn) 的静态扇区,到双动画动态填充与负 animation-delay 中途起步,再到 SVG 路线中 stroke-dasharray 的百分比化与三层 circle 的多色拼接,两条路线覆盖了从"能看"到"能改、能算"的完整进阶路径。

关联文档推荐继续阅读:

  • 圆与椭圆:border-radius 水平/垂直双轴语法的完整讲解,是理解半圆扇叶裁剪的基础;
  • 条纹背景:线性渐变与硬色标的大量实战(进度条、优惠券卡片);
  • 打字效果 与 弹跳效果:steps() 阶跃时间函数与 cubic-bezier 调速的更多动画实例;
  • 项目介绍:仓库配色规范(网易严选色板)与生产环境兼容性建议;
  • 常用 CSS 片段:配套的复位、清除浮动等基础工具代码。
登录后查看全文
You-need-to-know-css