mcpField
S
syncfusion-aspnetcore-lineargauge

syncfusion-aspnetcore-lineargauge

github.com/syncfusion设计与 UI053 次安装2 周前更新
代码仓库

关于 syncfusion-aspnetcore-lineargauge

为 Syncfusion Linear Gauge 提供的实现指南,面向在 ASP.NET Core 项目中构建数值仪表的开发者。内容涵盖指针、范围、注释和交互,可用于温度、进度及监控指标展示。

主要功能

  1. 01Marker 与 Bar 指针
  2. 02数值范围着色
  3. 03文本、图像及 HTML 注释
  4. 04拖动、工具提示与事件
  5. 05指针动画与外观定制
  6. 06打印与图像导出

适用场景

  1. 01显示温度或速度
  2. 02构建进度指示器
  3. 03比较仪表盘中的实际值与目标值
  4. 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.md
annotations.md
api-reference.md
appearance-and-styling.md
examples-and-use-cases.md
gauge-dimensions.md
getting-started.md
interactions-and-events.md
pointers-and-indicators.md
ranges-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