用途
Syncfusion React Progress Bar 是一个轻量级 React 组件,用于可视化任务进度,提供线性、圆形或半圆形三种形态的进度反馈。该技能面向需要在 React 应用中展示进度指示、加载状态、文件上传下载进度、任务完成百分比、数据处理或长时间运行操作可视化等场景的开发者。
主要能力
- 多种类型:Linear(线性)、Circular(圆形)、Semicircle(半圆形)。
- 多种状态:Determinate(已知进度,默认)、Indeterminate(未知进度,用于加载/处理)、Buffer(次级/缓冲进度,双进度指示)。
- 动画:支持可配置的持续时间和延迟,实现平滑过渡。
- 自定义:颜色、高度、宽度、标签、主题、CSS 类等。
- 事件:进度跟踪、开始/完成回调。
- 无障碍:符合 WCAG 2.1,支持 ARIA。
- RTL 支持:支持从右到左的语言布局。
- 高级特性:圆角样式、饼图进度、分段进度渲染、范围颜色、最小/最大值设定。
使用方式
安装包 @syncfusion/ej2-react-progressbar 后,从该包导入 ProgressBarComponent 组件即可使用。核心属性包括:
id:组件唯一标识。type:"Linear" | "Circular" | "Semicircle",默认 "Linear"。value:当前进度值(0-100),默认 0。secondaryProgress:次级/缓冲进度值,默认 0。isIndeterminate:不确定/加载模式,默认 false。height/width:尺寸(CSS 值),默认 "100%"。showProgressValue:是否显示百分比文本,默认 false。animation:动画配置{ enable, duration, delay }。progressColor/trackColor:进度填充色与轨道背景色。progressThickness/trackThickness:厚度(像素),默认 4。isStriped/isGradient:条纹或渐变填充效果。cornerRadius:"Round" | "Auto",默认 "Auto"。enableRtl:RTL 布局,默认 false。enablePieProgress:圆形类型的饼图视图,默认 false。enableProgressSegments/segmentCount:分段进度渲染及段数,默认 1。rangeColors:不同范围的颜色配置。minimum/maximum:进度最小/最大值,默认 0 / 100。progressValueFormat:值显示格式,默认 "N0 '%'"。labelOnTrack:是否在轨道上显示标签,默认 true。labelStyle:标签字体样式。
文档指南按主题组织:入门(安装、基础实现、CSS 导入与主题、首个示例、TypeScript 与 JavaScript)、类型与形状、状态与模式、自定义与样式、动画事件与无障碍、API 参考。
适用场景
- 文件上传/下载进度显示。
- 未知时长的加载状态(加载旋转指示器)。
- 数据处理进度跟踪。
- 多任务缓冲/流式场景(如视频缓冲、任务队列)。
- 多步骤工作流进度。
- 与 React Query、Redux 等状态管理集成。
限制
资料未提供该组件的收费、价格、平台兼容性、性能指标或具体效果数据,这些信息暂未提供。使用前请参考官方文档确认最新 API 与许可条款。