Zeek.Avalonia.Navigation

Zeek.Avalonia.Navigation 是 Avalonia 桌面区域导航模块，负责 Region、页面注册、导航参数、页面复用、关闭和释放边界。

适用场景

• 需要在桌面应用中管理主区域、Tab、ItemsControl 或嵌套区域导航。
• 需要显式注册 View / ViewModel，并保持 AOT 友好。
• 需要页面复用、保留、关闭当前、关闭其他或释放页面资源。

安装 / 引用

<PackageReference Include="Zeek.Avalonia.Navigation" />

快速开始

在根模块依赖 AvaloniaNavigationModule，并按正式文档显式注册页面和区域宿主。ViewModel 通过构造函数注入 IRegionNavigator 发起导航；如果应用层有自己的基础 ViewModel，也可以实现 IRegionNavigatorAware，由 Navigation 在创建页面后写入当前导航作用域。

IRegionManager 直接提供 item 查询、激活、关闭当前、关闭指定、关闭其他和关闭全部；扩展类只保留 FindItem<TViewModel>(...) 这一项便捷查询。

AOT / Trim

• AOT 支持等级：Required。
• Trim 策略：显式页面注册或 source generator 增强，不扫描程序集查找 View / ViewModel。
• 反射策略：不以命名约定反射发现页面。

Sample

• ../../samples/Zeek.NavigationSample/
• ../../samples/Zeek.NavigatorScopeSample/
• ../../samples/Zeek.NavigationContentControlSample/
• ../../samples/Zeek.NavigationTabControlSample/
• ../../samples/Zeek.NavigationItemsControlSample/
• ../../samples/Zeek.NavigationCompositionSample/
• ../../samples/Zeek.NavigationHeavyControlSample/

完整文档

• ../../docs/modules/Zeek.Avalonia.Navigation.md

当前限制

• 本模块不是 Prism 克隆，不提供全局 BaseViewModel 或 MVVM 框架绑定。
• 本模块不负责 Dialogs、Feedback、权限、菜单或业务路由守卫。