SxProgress (进度条)

  • Implemented

展示任务执行进度。支持确定进度和不确定进度的走马灯模式。对齐 Microsoft Fluent UI Blazor Progress (v4.13.2) 的 API 结构,并说明 NextUI 当前实现状态。

使用场景

  • 任务执行进度展示
  • 数据加载指示
  • 表单提交进度

约束说明

  • Valuenull 时为不确定状态。
  • Min/Max 控制进度范围。

行为说明

  • Paused 为真时暂停动画。
  • ShowValue 为真时显示百分比。

API

Parameters (参数)

状态 参数名 类型 默认值 描述
Implemented Value double? null 当前进度值。
Implemented Min double 0 最小值。
Implemented Max double 100 最大值。
Implemented Color string var(--sx-colorBrandBackground1) 进度条颜色。
Implemented Paused bool false 是否暂停动画。
Implemented ShowValue bool false 是否显示百分比。
Implemented Size ControlSize Medium 尺寸。
Implemented OnProgressChanged EventCallback<double?> null 进度变化回调。
Implemented Id (继承) string? null 组件 Id。
Implemented Class (继承) string? null CSS 类名。
Implemented Style (继承) string? null 自定义样式。
Implemented Title (继承) string? null HTML title
Implemented AdditionalAttributes (继承) IEnumerable<KeyValuePair<string, object>>? null 额外属性。

Events (事件)

状态 事件名 类型 描述
Implemented OnProgressChanged EventCallback<double?> 进度值改变时触发。

示例

<SxProgress Value="75" ShowValue="true" />

参考设计 (References)