关于 syncfusion-aspnetcore-lineargauge
为 Syncfusion Linear Gauge 提供的实现指南,面向在 ASP.NET Core 项目中构建数值仪表的开发者。内容涵盖指针、范围、注释和交互,可用于温度、进度及监控指标展示。
主要功能
- 01Marker 与 Bar 指针
- 02数值范围着色
- 03文本、图像及 HTML 注释
- 04拖动、工具提示与事件
- 05指针动画与外观定制
- 06打印与图像导出
适用场景
- 01显示温度或速度
- 02构建进度指示器
- 03比较仪表盘中的实际值与目标值
- 04监控实时数值变化
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ syncfusion/ aspnetcore-ui-components-skills --skill syncfusion-aspnetcore-lineargauge安装后在 Claude Code 中输入/syncfusion-aspnetcore-lineargauge确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/advanced-features.mdannotations.mdapi-reference.mdappearance-and-styling.mdexamples-and-use-cases.mdgauge-dimensions.mdgetting-started.mdinteractions-and-events.mdpointers-and-indicators.mdranges-and-values.md详细介绍
实现 Syncfusion 线性仪表
何时使用此技能
在以下情况下使用此技能:
- 以线性仪表格式显示数值(温度、速度、性能指标)
- 创建带有可拖动指针的交互式仪表
- 在刻度上可视化范围和阈值
- 为仪表添加注释和自定义元素
- 实现支持实时数据更新的仪表盘仪表
- 构建温度计样式或进度指示器组件
组件概览
线性仪表组件以线性方式可视化轴上的数值。所有元素均使用可缩放矢量图形(SVG)进行渲染。主要功能包括:
- 多个指针 - 支持 Marker 和 Bar 指针类型
- 范围高亮 - 定义颜色范围以突出显示数值区间
- 注释 - 在仪表任意位置添加文本、图像或 HTML 元素
- 交互功能 - 拖放指针、工具提示和事件
- 动画 - 加载时及数值变化时的平滑指针动画
- 自定义 - 颜色、主题、边框、刻度和容器类型(Normal、RoundedRectangle、Thermometer)
- 无障碍功能 - 符合 WCAG 2.2 标准,支持屏幕阅读器
- 打印和导出 - 打印和导出仪表图像
快速入门示例
以下是一个最简线性仪表实现:
<ejs-lineargauge id="linear" title="Temperature Gauge" orientation="Horizontal">
<e-lineargauge-axes>
<e-lineargauge-axis minimum="0" maximum="200">
<e-lineargauge-ranges>
<e-lineargauge-range start="0" end="50" color="blue"></e-lineargauge-range>
<e-lineargauge-range start="50" end="150" color="green"></e-lineargauge-range>
<e-lineargauge-range start="150" end="200" color="red"></e-lineargauge-range>
</e-lineargauge-ranges>
<e-lineargauge-pointers>
<e-lineargauge-pointer value="75" type="Bar"></e-lineargauge-pointer>
</e-lineargauge-pointers>
</e-lineargauge-axis>
</e-lineargauge-axes>
</ejs-lineargauge>
常见模式
模式 1:温度显示
- 垂直方向,使用温度计容器
- 范围颜色:蓝色(冷)、绿色(正常)、红色(热)
- 使用单个 Bar 指针显示当前温度
模式 2:进度指示器
- 水平方向,使用百分比数值
- 单个范围,取值为 0-100
- 使用 Bar 指针显示完成百分比
模式 3:仪表盘指标
- 水平方向,包含多个范围
- 使用 Marker 指针显示实际值与目标值
- 使用注释添加标签和备注
模式 4:实时监控
- 绑定
ValueChange事件 - 为指针动画指定时长
- 使用工具提示显示悬停信息
文档与导航指南
入门
📄 阅读: references/getting-started.md
- 安装和软件包设置
- 线性仪表基础实现
- CSS 导入和主题配置
- 初始配置和渲染
仪表尺寸
📄 阅读: references/gauge-dimensions.md
- 容器大小和尺寸(像素或百分比)
- 方向(水平/垂直)
- 尺寸配置
- 响应式行为和边距控制
范围和值
📄 阅读: references/ranges-and-values.md
- 范围定义和颜色
- 多个范围的配置
- 值绑定和轴缩放
- 最小值/最大值
- 范围样式和渐变颜色
指针和指示器
📄 阅读: references/pointers-and-indicators.md
- 指针类型和样式(Marker、Bar)
- 标记形状(Circle、Rectangle、Triangle、Diamond、Image、Text)
- 动画和移动
- 多个指针
- 指针样式和自定义
外观和样式
📄 阅读: references/appearance-and-styling.md
- 视觉自定义
- 容器类型(Normal、RoundedRectangle、Thermometer)
- 颜色和主题
- 标题样式
- 边框和刻度
- 标签自定义
交互和事件
📄 阅读: references/interactions-and-events.md
- 单击事件和拖动操作
- 值变化事件
- 动画完成事件
- 鼠标事件(按下、移动、松开、离开)
- 工具提示渲染和处理
注释
📄 阅读: references/annotations.md
- 添加文本和图像注释
- 定位注释(x、y 坐标)
- Z-index 和图层
- 水平和垂直对齐
- 多个注释
高级功能
📄 阅读: references/advanced-features.md
- 无障碍支持(WCAG 2.2、屏幕阅读器)
- 打印和导出功能
- 国际化(i18n)
- API 方法和属性
- RTL 支持
示例和用例
📄 阅读: references/examples-and-use-cases.md
- 仪表盘仪表
- 速度指示器
- 温度显示
- 性能指标
- 实际应用模式和最佳实践
评论
支持 Markdown