Avalonia 本身不内置 Docking(停靠)功能,但可以通过第三方库 Avalonia.Dock 实现专业、可拖拽、可停靠、支持标签页和布局序列化的多窗格界面。它模仿 Visual Studio 或 Rider 的布局体验,是目前 Avalonia 生态中最成熟稳定的停靠方案。
安装 Avalonia.Dock
在项目中通过 NuGet 安装核心包:
Avalonia.Dock:核心控件与布局逻辑 Avalonia.Dock.Controls(可选):提供预置的工具栏、标题栏等 UI 组件 Avalonia.Xaml.Behaviors(如需行为绑定,推荐搭配使用)安装后,在 XAML 中添加命名空间引用:
基础停靠布局结构
核心是
DockManager+
LayoutRoot+
LayoutPanel+
LayoutDocumentPane/
LayoutAnchorablePane。典型结构如下: DockManager 是根容器,管理整个停靠系统状态 LayoutRoot 是唯一子元素,代表当前布局拓扑 LayoutPanel 表示一个可分割的区域(水平/垂直),内部可嵌套其他 Panel 或 Pane LayoutDocumentPane 用于承载「文档式」内容(如编辑器标签页),支持关闭、最大化、新建标签 LayoutAnchorablePane 用于承载「工具窗口式」内容(如属性面板、解决方案资源管理器),可浮动、自动隐藏、停靠到边缘
定义可停靠内容(Anchorable)
每个可停靠窗口需封装为
LayoutAnchorable,并设置
Title、
Icon、
CanFloat、
CanAutoHide等属性:
注意:
LayoutAnchorable必须放在
LayoutAnchorablePane内,或由
DockManager动态添加(例如通过菜单命令打开)。
保存与恢复布局
调用
DockManager.Save()可序列化当前布局为 XML 字符串;
DockManager.Load(xml)可还原。建议在应用退出前保存到本地文件,启动时尝试加载: 保存路径推荐使用
AppData目录下的 JSON/XML 文件 首次运行无配置时,可预设默认布局(如左窗格放资源树、右窗格放属性、中央放编辑器) 注意处理
LayoutContent类型反序列化失败问题——确保所有自定义视图类型已注册或可通过默认构造函数实例化
