用途:Syncfusion Essential JS 2 Circular Gauge 用于在圆形刻度上可视化数值,适合仪表盘、监控系统、KPI 展示、进度指示、速度表、温度监控等测量类应用。
主要能力:支持 Needle、RangeBar、Marker 三种指针;轴、范围、刻度、标签、注释、图例与工具提示;指针动态更新与拖拽交互;样式、主题、渐变、响应式布局、无障碍、导出与打印。
使用方式:TypeScript 通过 npm 安装 @syncfusion/ej2-circulargauge,导入 CircularGauge 并按需注入功能模块(Annotations、GaugeTooltip、Legend、Gradient、ImageExport、PdfExport、Print),创建实例后调用 appendTo('#gauge') 挂载到宿主元素。JavaScript 使用版本化 CDN 或本地全局脚本,构造函数为 ej.circulargauge.CircularGauge,同样调用 appendTo。示例采用 ES5 兼容语法。
限制与注意:宿主元素 ID 与选择器必须一致;指针值应保持在轴范围内;更新指针优先用 setPointerValue,更新注释用 setAnnotationValue,避免整体重建;拖拽使用 enablePointerDrag、enableRangeDrag 及 dragStart/dragMove/dragEnd,而非 allowDragging;保持 Syncfusion 包版本一致以避免依赖冲突。其余细节暂未提供。