标签不能当百分比仪表盘用,仅渲染横向进度条;Chart.js环形图需设cutout和双数据点;纯CSS半圆仪表盘靠rotate+overflow实现;Canvas手绘需处理DPR、清屏、弧度及动画细节。

标签不能当百分比仪表盘用——它只渲染横向进度条,不支持环形、指针或刻度,语义上也仅表示“已知范围内的标量值”,不是可视化控件。
用 Chart.js 的 doughnut 图模拟环形百分比
这是新手最快落地的方案:把饼图压成环形,用两个数据点表达“已用”和“剩余”。关键不是画图,而是绕过常见配置陷阱。
-
cutout: '70%'必须设,否则是实心饼图;值越大环越细,建议 60%–80% - 数据必须是数组,比如湿度 65%,得传
[65, 35],不能只传65 -
canvas元素必须有id,且 JS 初始化时要严格匹配:new Chart(document.getElementById('humidityChart'), {...}) - 漏引 CDN 会报
Chart is not defined;漏写type: 'doughnut'会静默失败
纯 CSS + JS 实现轻量半圆仪表盘
不依赖库、体积小、适合嵌入表格或卡片。核心是用 transform: rotate() 控制填充层角度,靠 overflow: hidden 裁出扇形。
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- HTML 结构要分层:65%
- CSS 中
.gauge设为半圆形容器(border-radius: 100% 100% 0 0),.gauge-fill用transform-origin: bottom center确保旋转轴在底部中点 - JS 映射:65% → 半圆 180° →
rotate(117deg)(即180 * 0.65) - 加
transition: transform 0.4s ease-out让转动平滑;别用linear,指针会生硬
Canvas 手绘数字仪表盘(需精确控制时)
当你要带刻度、指针、动态插值、高 DPI 适配,或者数值来自 WebSocket 高频推送, 是唯一可控路径。
- 每次重绘前必须调用
ctx.clearRect(0, 0, canvas.width, canvas.height),否则旧指针残留 - 角度计算单位别混:
Math.sin()/Math.cos()用弧度,ctx.rotate()也用弧度,别转成度数再传 - 指针动画别硬写
setInterval,用requestAnimationFrame驱动,并加缓动:currentValue += (targetValue - currentValue) * 0.08 - 移动端必须处理
devicePixelRatio:canvas 的width/height属性要乘以 DPR,CSS 样式尺寸保持不变 - 刻度文字对齐极易错位——
textBaseline别信默认值,上刻度用'top',下刻度用'bottom',配合textAlign: 'center'
真正难的不是画出一个圆,而是让百分比变化时,指针不跳、文字不糊、刻度不偏、缩放不失真。这些细节藏在 canvas 坐标系、CSS 坐标变换和浏览器渲染管线的交界处,改一行 transform-origin 或漏一次 clearRect,整个仪表盘就“活”不起来。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










