SuperAPI AI 工具集

syncfusion-react-progress-bar

前端与建站

查看项目

更新于 10-15 14:22

技能介绍

用途

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 与许可条款。