暂时更改一部分Skill
This commit is contained in:
1 parent
84b28f9672
commit
6d4629e4ac
53 files changed
+5293
-10
No files matched your search
@@ -0,0 +1,95 @@
|
||||
---
|
||||
name: reference-loading-status
|
||||
description: LoadingStatus 完整 API 参考和使用指南。当用户管理异步加载状态、显示加载进度、处理加载错误、绑定 LoadingCover 或 LoadingStatusIndicator 控件时自动加载。
|
||||
disable-model-invocation: false
|
||||
---
|
||||
|
||||
# LoadingStatus 完整参考
|
||||
|
||||
`LoadingStatus` 位于 `PipeReviewReport.Framework.ViewModels` 命名空间。
|
||||
|
||||
## API 概览
|
||||
|
||||
```csharp
|
||||
namespace PipeReviewReport.Framework.ViewModels;
|
||||
|
||||
public class LoadingStatus : BindableBase
|
||||
{
|
||||
// 核心属性
|
||||
public double? Progress { get; set; } // 进度(null = 不确定)
|
||||
public string Message { get; set; } // 加载提示文字
|
||||
public string ErrorMessage { get; set; } // 错误信息
|
||||
public bool HasError { get; set; } // 是否发生错误
|
||||
public bool IsLoading { get; set; } // 是否正在加载
|
||||
|
||||
// 计算属性
|
||||
public bool IsLoadedSuccess => !IsLoading && !HasError;
|
||||
public bool IsLoadingActive => IsLoading || HasError;
|
||||
|
||||
// 状态切换
|
||||
public void Initialize(string message = "") // 开始加载,IsLoading = true
|
||||
public void Done(string message = "") // 加载完成,IsLoading = false
|
||||
public void Error(string errorMessage) // 发生错误,HasError = true
|
||||
public void SetProgress(double progress) // 更新进度
|
||||
public void Reset() // 重置到初始状态
|
||||
public void CopyErrorMessage() // 复制错误信息到剪贴板
|
||||
}
|
||||
```
|
||||
|
||||
## ViewModel 使用模式
|
||||
|
||||
```csharp
|
||||
internal class XxxViewModel : ViewModelBaseEx
|
||||
{
|
||||
public LoadingStatus LoadingStatus { get; } = new();
|
||||
|
||||
public IDelegateCommand LoadCommand => field ??= new AsyncCommand(Load);
|
||||
private async Task Load()
|
||||
{
|
||||
try
|
||||
{
|
||||
LoadingStatus.Initialize("读取文件...");
|
||||
await DoStuff();
|
||||
LoadingStatus.Done();
|
||||
}
|
||||
catch (OperationCanceledException)
|
||||
{
|
||||
LoadingStatus.Reset();
|
||||
}
|
||||
catch (Exception ex)
|
||||
{
|
||||
Debug.WriteLine(ex);
|
||||
LoadingStatus.Error(ex.Message);
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## View 绑定 — LoadingCover
|
||||
|
||||
在内容 Grid 之上放置 `LoadingCover` 作为覆盖层,自动处理三态显示:
|
||||
|
||||
```xml
|
||||
<Grid>
|
||||
<!-- 实际内容 -->
|
||||
<ContentControl Content="{Binding ...}"/>
|
||||
|
||||
<!-- 加载覆盖层 -->
|
||||
<f:LoadingCover
|
||||
LoadingStatus="{Binding LoadingStatus}"
|
||||
RefreshCommand="{Binding LoadCommand}"/>
|
||||
</Grid>
|
||||
```
|
||||
|
||||
`LoadingCover` 三态:
|
||||
- **加载中**:半透明遮罩 + 环形进度 + `Message` 文字
|
||||
- **错误**:半透明遮罩 + 警告图标 + `ErrorMessage` + 刷新按钮(绑定 `RefreshCommand`)+ 复制错误按钮
|
||||
- **成功**:完全隐藏
|
||||
|
||||
## View 绑定 — LoadingStatusIndicator
|
||||
|
||||
轻量级内联状态指示:
|
||||
|
||||
```xml
|
||||
<f:LoadingStatusIndicator LoadingStatus="{Binding LoadingStatus}"/>
|
||||
```
|
||||
Reference in new issue
Block a user