SxProgress (进度条)
展示任务执行进度。支持确定进度和不确定进度的走马灯模式。对齐 Microsoft Fluent UI Blazor Progress (v4.13.2) 的 API 结构,并说明 NextUI 当前实现状态。
使用场景
约束说明
Value 为 null 时为不确定状态。
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)