mirror of
https://github.com/AtomUI/AtomUI.git
synced 2026-10-23 17:59:22 +08:00
chinboy
9f6ec36645
统一文档目录的入口文件名为 `overview.md`，取代原先的 `index.md`。单 Control 目录本来就用 `overview.md`，此前只有目录级入口用 `index.md`，两套命名并存；现在全库一致。 改名覆盖 42 个入口文件：`docs/` 根、一级分类目录、Architecture 分组与跨模块系统目录、Module 目录、Control 平台与分类目录、Guide 与 Reference 子目录。`docs/AI/generated/index.md` 是手工 维护的导航页，一并改名。 生成产物 `docs/AI/generated/llms/**/index-cn.md` 保持原名，它属于 LLMs Generator 的输出契约。 同步更新 28 个正式文档与 `AGENTS.md` 中的入站链接，以及两处目录树示意图。改名后全部相对链接 可解析，LLMs Generator `verify` 通过（78 控件 / 159 文件），单 Control 四件套文件名契约未变。 新增 `docs/engineering/contributing/documentation-structure-guidelines.md` 承载入口命名、文档 拆分标准、事实所有权和链接规范。此前该规则只写在带日期的设计过程记录里，不适合作为长期来源。 `docs/superpowers/specs/2026-08-10-documentation-information-architecture-design.md` 保留原文 并加取代说明，其余结论继续有效。
1.6 KiB
1.6 KiB
AtomUI.Controls 模块概览
AtomUI.Controls 是公共控件和通用 Primitives 模块。它依赖 AtomUI.Core、AtomUI.Controls.Shared、AtomUI.Fonts.AlibabaSans、AtomUI.Icons.AntDesign 和 AtomUI.Generator。
职责
- 提供桌面控件包复用的基础控件、抽象控件和 Primitives。
- 提供公共主题 Provider：
CommonControlThemesProvider与BrowserCommonControlThemesProvider。 - 注册公共控件 Token、本地化 Catalog 和内置 Translation Bundle。
- 提供 Icon、ItemsControl、ScrollViewer、Form、Watermark、QRCode、Badge 抽象等公共能力。
注册入口
入口位于 src/AtomUI.Controls/ThemeManagerBuildExtensions.cs：
builder.UseCommonControls();
该方法会：
- 注册源生成器生成的公共控件 Token 类型。
- 根据
RuntimePlatform.Features.SupportsNativeWindow选择桌面或浏览器公共主题 Provider。 - 通过生成式模块注册把公共 Catalog 和内置翻译加入
builder.Localization。
UseDesktopControls() 会先调用 UseCommonControls()，所以普通桌面应用无需单独调用本方法。
关键目录
| 目录 | 说明 |
|---|---|
Primitives/ |
桌面控件复用的基础装饰、动效、视觉层 |
Icon/ |
图标控件与图标主题 |
ItemsControl/ |
ItemsControl 相关反射扩展和主题 |
Form/ |
表单验证基础能力 |
Grid/、FlexPanel/ |
布局基础 |
Badge/、Buttons/、Select/ |
多个桌面控件复用的抽象层 |
具体桌面控件文档应放在 ../../controls/desktop/overview.md，本模块文档只解释公共基础层。