avalonia-viewmodels-zafiro

Avalonia ViewModels with Zafiro

技能概述

提供 Avalonia 应用程序中创建 ViewModel、向导流程和管理导航的最佳实践与模式，结合 Zafiro 工具包和 ReactiveUI 实现响应式 MVVM 架构。

适用场景

跨平台 Avalonia 应用开发

需要为 Windows、macOS、Linux 等多平台构建一致的 UI 架构时，使用这套模式可以确保 ViewModel 逻辑在不同平台上保持统一和可维护。

复杂向导流程实现

当应用需要多步骤用户引导流程（如项目创建向导、配置向导）时，Wizard Pattern 提供声明式、可维护的实现方式，避免回调地狱和状态混乱。

响应式状态管理需求

需要精细控制 UI 状态同步、命令执行状态和进度报告时，ReactiveUI 的响应式模式和 IEnhancedCommand 可以优雅地处理这些复杂交互逻辑。

核心功能

Functional-Reactive ViewModel 模式

使用 ReactiveUI 的 ReactiveObject、WhenAnyValue 等组件构建响应式 ViewModel，实现状态变化与 UI 的自动同步，减少手动事件处理代码。

声明式 Wizard 构建

通过 SlimWizard 和 WizardBuilder 以声明式方式构建多步骤流程，每个步骤逻辑独立可测试，整体流程清晰易读，支持复杂的状态流转和验证。

自动组合与发现

利用 [Section] 属性自动注册 UI 区域，DataTypeViewLocator 自动匹配 ViewModel 与 View，在 CompositionRoot 中统一管理依赖注入，实现松耦合的架构设计。

常见问题

Avalonia 中如何正确实现 ViewModel？

Avalonia 推荐使用 MVVM 模式，ViewModel 应继承自 ReactiveObject 并使用 WhenAnyValue 来处理属性变化和命令逻辑。避免在 ViewModel 中直接引用 View，保持 ViewModel 的纯净和可测试性。

Zafiro Toolkit 是什么，如何与 Avalonia 配合使用？

Zafiro 是一个增强 Avalonia 开发体验的工具包，提供 IEnhancedCommand、SlimWizard、Section 属性等组件，简化命令管理、向导流程和导航发现。它与 ReactiveUI 深度集成，可以无缝配合使用。

Avalonia 中实现向导流程的最佳方式是什么？

推荐使用 SlimWizard 和 WizardBuilder 模式，将每个步骤定义为独立的 ViewModel，通过声明式 API 组装流程。这种方式比传统的回调或事件驱动更清晰，每个步骤的状态管理和验证逻辑都可以独立编写和测试。