用途:本技能用于在 Blazor 应用中实现 Syncfusion Blazor ProgressBar 组件,适用于展示文件上传/下载、数据处理进度,显示确定或不确定的加载状态,可视化任务完成百分比,实现媒体播放或流式内容的缓冲状态,创建线性或环形进度指示,添加自定义样式与动画,展示多阶段分段进度,以及实现符合 WCAG 的无障碍进度指示。
主要能力:组件支持 Linear(水平条)与 Circular(环形/饼图)两种类型;状态包括 Determinate、Indeterminate、Buffer、Active、Striped;支持颜色、厚度、分段、半径、圆角、边距、RTL 等定制;提供注释、标签、范围颜色、渐变、次要进度等特性;支持动画速度与延迟配置;提供 ValueChanged、ProgressCompleted、AnimationComplete、AnnotationRender、TextRender、Loaded 等事件;具备 WCAG 2.2 合规与键盘导航支持。
必要用法:首次使用需安装 NuGet 包 Syncfusion.Blazor.ProgressBar,导入命名空间并注册服务,在页面中添加样式表和脚本引用。基本用法示例:使用 SfProgressBar 并设置 Type、Value、Minimum、Maximum、Height、TrackThickness、ProgressThickness 等属性;动画通过子组件 ProgressBarAnimation 配置 Enable、Duration、Delay;事件通过 ProgressBarEvents 绑定;动画完成等生命周期事件可用;状态变化后可用 RefreshAsync() 重新渲染。
适用场景与限制:适用于文件上传进度、简单加载指示、多步骤向导、视频缓冲、仪表盘 KPI 指示、下载进度与自定义时间标签、确定任务进度等。Striped 仅适用于 Linear 类型;不确定持续时间时使用 Indeterminate;百分比标签需设置 ShowProgressValue="true";样式未生效需检查样式表引用;事件未触发需检查 ProgressBarEvents 组件与方法签名;动画过快或频繁更新时建议调整 Duration 或禁用动画。具体价格、平台支持范围及未提及的扩展能力暂未提供。