1. 项目概述
这个基于ArkTS和Canvas的仪表盘组件是我在开发HarmonyOS应用时的一个实用案例。它完美展示了如何利用Canvas 2D API创建精确、美观的数据可视化控件。不同于简单的进度条,这个270度半圆形仪表盘(135°-405°范围)通过精细的几何计算和视觉设计,实现了专业级的仪表效果。
在实际项目中,这类组件特别适合需要直观展示百分比或范围值的场景,比如设备状态监控、健康数据跟踪等。通过Canvas绘制,我们可以完全控制每个元素的样式和位置,避免了使用预制组件时的各种限制。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心设计解析
2.1 几何布局设计
仪表盘的核心是一个270度的圆弧,从135°开始到405°结束。这个角度范围的选择有几个关键考虑:
- 视觉效果:270度提供了足够的显示空间,同时保持了半圆形的简洁美感
- 可读性:刻度标签可以清晰地分布在圆弧周围
- 交互友好:指针移动范围适中,不会显得过于拥挤或稀疏
圆心固定在(150,150)坐标点,所有元素都基于这个中心点进行计算。这种同心设计确保了视觉一致性,避免了元素错位的问题。
2.2 图层绘制顺序
Canvas绘制遵循特定的图层顺序,这对最终效果至关重要:
- 外圈装饰环(最底层)
- 背景圆弧(灰色底衬)
- 进度圆弧(红色进度条)
- 刻度线和数字标签
- 指针及其阴影
- 中心圆点(最后绘制,覆盖指针根部)
这种绘制顺序确保了正确的视觉层级,比如指针会覆盖在进度条上方,而中心圆点又能完美遮盖指针的根部。
3. 关键实现细节
3.1 角度计算与转换
仪表盘的核心逻辑是将数值百分比转换为对应的角度。代码中这个转换是这样实现的:
typescript复制const percentage = this.value / 100
const currentAngle = startAngle + (endAngle - startAngle) * percentage
这里有几个要点需要注意:
- startAngle和endAngle使用弧度制(Math.PI * 0.75和Math.PI * 2.25)
- 计算时确保角度范围正确映射到0-100%的值域
- 指针角度与进度条角度保持一致,确保视觉同步
