LoadingBar

贴在顶部的进度条，支持不确定滑动动画与确定百分比两种模式。

最后更新 2026-10-25 19:27:08

说明

全局顶部加载条由 Container 放置一次、跟随 UIService：调用 ShowLoading 进入不确定循环滑动，SetProgress / Increase 推进 0-100 的确定进度，HideLoadingAsync 先补满到 100% 再淡出，LoadingColor 取语义色。也可作为局部 / 独立实例——放一个 LoadingBar 组件（Global=false），Absolute 为真时贴附到最近的定位父容器顶部，用同名命令式方法驱动，用于局部区域加载。

常见能力：

全局浮层跟随 UIService
不确定滑动
确定百分比
五种主题色
自定义高度
局部绝对定位（Global=false）

用法

@* 全局：Container 已放置，页面无需引用 *@
UI.LoadingColor = "info";
UI.ShowLoading();                 // 不确定
await Task.Delay(2000);
await UI.HideLoadingAsync();      // 补满并淡出

UI.SetProgress(0);                // 确定进度
UI.Increase(20);

@* 局部：Absolute 贴附父容器顶部，命令式 @ref 驱动 *@
// <LoadingBar @ref="bar" Absolute Color="info" />
// bar.Show(); await bar.HideAsync();

API 参数

参数	类型	默认值	说明
`Absolute`	`bool`	`false`	绝对定位：贴附到最近的定位父容器顶部，而非浏览器窗口顶部。用于局部区域加载。
`Color`	`string`	`null`	主题色：primary（默认）/ success / warning / danger / info。全局模式下取 UIService.LoadingColor。
`Global`	`bool`	`false`	全局模式：跟随 UIService 的加载状态（由 Container 放置）。为 false 时使用本实例的命令式 API。
`Height`	`int`	`3`	条体高度（像素），默认 3。
`Visible`	`bool`	`true`	取得或设置组件是否可见，默认为false。
`VisibleChanged`	`EventCallback<bool>`	—	事件取得或设置组件可见性变化时的回调事件。
`Class`	`string`	`null`	取得或设置组件的CSS类名，用于自定义样式。
`Disabled`	`bool`	`false`	取得或设置组件是否禁用，默认为false。
`Style`	`string`	`null`	取得或设置组件的内联样式，用于自定义样式。

所有组件均继承 BaseComponent，除上表参数外还支持 Class、Style、Disabled、Visible。