avalonia-layout-zafiro

使用 Zafiro.Avalonia 进行 Avalonia 布局

掌握现代、简洁且易于维护的 Avalonia UI 布局。 专注于语义容器、共享样式和精简的 XAML。

🎯 按需阅读规则

只阅读与布局问题相关的文件！

---

📑 内容索引

文件	说明	阅读时机
themes.md	主题组织和共享样式	设置或优化应用主题时
containers.md	语义容器（HeaderedContainer、EdgePanel、Card）	组织视图和布局时
icons.md	使用 IconExtension 和 IconOptions 添加图标	添加和自定义图标时
behaviors.md	Xaml.Interaction.Behaviors 和避免使用转换器	实现复杂交互时
components.md	通用组件和避免嵌套	创建可复用 UI 元素时

---

🔗 相关项目（示例实现）

如需查看真实案例，请参考 Angor 项目： /mnt/fast/Repos/angor/src/Angor/Avalonia/Angor.Avalonia.sln

---

✅ 整洁布局检查清单

• 是否使用了语义容器？（例如，使用 HeaderedContainer 替代带有手动标题的 Border）
• 是否避免了冗余属性？ 在 axaml 文件中使用共享样式。
• 是否尽量减少了嵌套？ 使用 EdgePanel 或通用组件扁平化布局。
• 是否通过扩展添加图标？ 使用 {Icon fa-name} 和 IconOptions 设置样式。
• 是否优先使用行为而非代码隐藏？ 使用 Interaction.Behaviors 处理 UI 逻辑。
• 是否避免了转换器？ 除非必要，否则优先使用 ViewModel 属性或行为。

---

❌ 反模式

不要：

• 在视图中使用硬编码的颜色或尺寸（字面量）。
• 创建深层嵌套的 Grid 和 StackPanel。
• 在多个元素上重复视觉属性（请使用样式）。
• 对属于 ViewModel 的简单逻辑使用 IValueConverter。

应该：

• 使用 DynamicResource 设置颜色和画刷。
• 将重复布局提取为通用组件。
• 善用 Zafiro.Avalonia 专用面板（如 EdgePanel）实现常见 UI 模式。