Avalonia 中没有内置的
SplitView控件（不像 UWP 或 WinUI），但可以通过组合
Grid、
ToggleButton和动画来实现功能完整、视觉流畅的可折叠侧边栏。核心思路是：用一个列宽可变的
Grid控制侧边栏显示/隐藏，配合状态切换和可选的滑入动画。
1. 基础结构：Grid + ToggleButton 实现折叠逻辑
在 XAML 中定义两列布局：第一列为侧边栏（宽度绑定到布尔状态），第二列为内容区（剩余空间）。用
ToggleButton触发折叠/展开。 侧边栏列宽设为
*（展开）或
0（折叠），通过
BooleanToVisibilityConverter或自定义值转换器控制更直观；推荐用
Width绑定配合
IValueConverter返回
GridLength
ToggleButton.IsChecked绑定到 ViewModel 的
IsPaneOpen属性，作为主控开关 内容区域设置
Grid.Column="1"，并用
Width="*"自动填充剩余空间
2. 平滑折叠动画（可选但推荐）
Avalonia 支持基于属性的动画，可对侧边栏容器（如
Panel或
Border）的
Width或
Opacity添加过渡效果。 在侧边栏外层包裹一个
Panel，绑定其
Width到
PaneWidth（double 类型，例如 240 或 0） 在 ViewModel 中更新
PaneWidth时，用
Animatable.Animate方法驱动平滑变化（需引用
Avalonia.Animation） 示例：从 240 → 0 动画持续 200ms，缓动函数用
Easing.EaseOutCubic更自然
3. 响应式行为与遮罩层（类似 SplitView.DisplayMode = Overlay）
当侧边栏为 overlay 模式时，需在内容区上方叠加半透明遮罩，并拦截点击收起面板。
用Grid叠加层级：底层放内容，中层放遮罩（
Rectangle或
Border，
Opacity="0.5"，
IsVisible="{Binding IsPaneOpen}"）
遮罩添加 PointerPressed事件处理，触发
IsPaneOpen = false，实现点击关闭 遮罩
ZIndex设为高于内容、低于侧边栏，确保点击穿透侧边栏但响应遮罩
4. 键盘与焦点管理（提升可用性）
折叠状态下，侧边栏内控件不应获得焦点；展开后应支持 Tab 导航并默认聚焦首项。
设置侧边栏容器的IsEnabled="{Binding IsPaneOpen}"，禁用折叠时的交互
在 IsPaneOpen变为 true 后，调用
FocusManager.Instance?.FocusFirst()或手动
Focus()到菜单根元素 监听
Escape键：在主窗口或侧边栏上处理
KeyDown，当
e.Key == Key.Escape && IsPaneOpen时关闭面板
