Avalonia中实现全局加载动画需在主窗口根布局内添加ZIndex=999且IsVisible绑定至ViewModel中IsLoading属性的透明遮罩Grid，内含ProgressBar与提示文字，并确保其与内容同级以保证层级正确。
在Avalonia中实现全局加载动画（Loading遮罩），核心思路是：**用一个覆盖全窗口的透明层 + 加载指示器（如旋转动画、文字提示）+ 控制其可见性绑定**。它不依赖第三方库，纯XAML + ViewModel即可完成。
1. 创建Loading遮罩的XAML模板
在主窗口（如MainWindow.xaml）的根布局内，添加一个ZIndex较高的Grid作为遮罩容器，确保它盖在所有内容之上：
- 使用
IsVisible="{Binding IsLoading}"控制显隐 - 背景设为半透黑色（
#80000000）以产生遮罩感 - 内部居中放置一个
ProgressBar或自定义旋转动画（如Path+RotateTransform） - 建议加一句提示文字（如“加载中…”），提升用户体验
示例片段：
<Grid ZIndex="999"
IsVisible="{Binding IsLoading}"
Background="#80000000">
<StackPanel HorizontalAlignment="Center" VerticalAlignment="Center">
<ProgressBar IsIndeterminate="True" Width="60" Height="60" />
<TextBlock Text="加载中..." Margin="0,12,0,0" Foreground="White" />
</StackPanel>
</Grid>
2. 在ViewModel中管理加载状态
定义可绑定的IsLoading属性，并确保实现INotifyPropertyChanged。推荐封装成方法，避免手动设值出错：
- 用
ObservableProperty（CommunityToolkit.Mvvm）或手写SetProperty更新 - 关键：加载逻辑应包裹在
try/finally中，确保异常后也能关闭遮罩 - 如需支持嵌套加载（多个操作同时进行），可用计数器代替布尔值
简易实现（布尔模式）：
private bool _isLoading;
public bool IsLoading
{
get => _isLoading;
private set => SetProperty(ref _isLoading, value);
}
public async Task LoadDataAsync()
{
IsLoading = true;
try
{
await Task.Delay(1500); // 模拟异步操作
// 处理结果...
}
finally
{
IsLoading = false;
}
}
3. 确保遮罩层级正确（关键细节）
Avalonia的ZIndex行为与WPF不同：它只在同一父容器内生效。因此必须注意：
- 遮罩Grid必须和主内容（如
ContentControl或Panel）处于同一个父级容器（比如都放在顶层Grid里） - 不要把它放在
Content或DataTemplate中——否则会被子内容层级覆盖 - 若使用
Window自带的Content属性，建议将整个结构包进一个顶层Grid，再把遮罩和业务内容并列放进去
4. 进阶：复用为全局服务（可选）
如果多个页面都需要加载遮罩，可抽象为ILoadingService：
- 提供
Show()/Hide()或WithLoadingAsync(Func<task>)</task>方法 - 内部通过
WeakReferenceMessenger或IClassicDesktopStyleApplicationLifetime.MainWindow找到当前窗口，动态注入遮罩 - 适合中大型项目，小项目直接绑定更轻量
不复杂但容易忽略的是层级和绑定上下文——只要遮罩Grid和内容同级、IsLoading能正确通知更新，就能稳定工作。
