[ PROMPT_NODE_23716 ]
containers
[ SKILL_DOCUMENTATION ]
# 语义化容器
为数据类型使用正确的容器可以简化 XAML 并提高可维护性。`Zafiro.Avalonia` 为常见的布局模式提供了专门的控件。
## ? HeaderedContainer
当某个部分需要标题或页眉时,优先使用 `HeaderedContainer` 而不是 `Border` 或 `Grid`。
xml
### 关键属性:
- `Header`:页眉的内容或字符串。
- `HeaderBackground`:页眉区域的画刷。
- `ContentPadding`:内容区域的内边距。
## ↔️ EdgePanel
使用 `EdgePanel` 将元素定位在容器边缘,无需复杂的 `Grid` 定义。
xml
### 插槽 (Slots):
- `StartContent`:左对齐(或起始端)。
- `Content`:填充中间剩余空间。
- `EndContent`:右对齐(或末端)。
## ? Card
一个用于对相关信息进行分组的简单容器,通常用在 `HeaderedContainer` 内部或作为列表中的独立元素。
xml
## ? 最佳实践
- 使用 `Classes` 应用主题变体(例如 `Classes="Section"`, `Classes="Highlight"`)。
- 必要时通过样式中的模板自定义容器的内部部分,而不是嵌套更多控件。