Files
persionalBrand/docs/adr/0034-antd6-static-api-and-list.md
T
que01 06619a191f
CI / Static checks (push) Has been cancelled
CI / Production build (push) Has been cancelled
CI / API integration (push) Has been cancelled
CI / Taro builds (acheng-campus-food) (push) Has been cancelled
CI / Taro builds (atelier-solopreneur) (push) Has been cancelled
CI / Taro builds (linjing-editorial) (push) Has been cancelled
CI / Browser regression (push) Has been cancelled
refactor: 提示与确认框改用 App 上下文实例
2026-10-21 10:34:34 +08:00

49 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 0034 Ant Design 6 弃用项收口
- 状态:已采纳
- 日期:2026-10-21
## Context
Admin 升级到 Ant Design 6.6 后,开发态控制台持续出现弃用提示:
- `Alert.message` 已改名为 `title`。
- `Space.direction` 已改名为 `orientation`。
- 静态 `message.*` 与 `Modal.confirm` 无法读取 `ConfigProvider` 的动态主题上下文。
- `List` 标记为 deprecated,官方建议 6.6+ 改用 `Listy`。
这些提示不影响功能,但会淹没真正有价值的新警告,也让后续升级到 Ant Design 7 时缺少明确清单。
## Decision
1. `Alert` 统一使用 `title`;正文仍用 `description`。
2. `Space` 统一使用 `orientation`。
3. 所有提示与确认框改为 `App.useApp()` 取得的实例:
- 组件与自定义 hook 在函数体首部声明 `const { message } = App.useApp();`。
- 确认框改为 `const { modal } = App.useApp();` 后调用 `modal.confirm`。
- 删除 `components/AdminMessage.ts` 这一静态转出口,避免再次绕过上下文。
4. 暂不迁移 `List` → `Listy`:
- `Listy` 是虚拟滚动列表,API 与 `List` 不兼容(需要 `itemHeight`、`renderItem` 等)。
- 当前 `List` 仅用于审计日志、失败计数和模板模块清单等小数据量场景,最大条数受分页或模板规模限制。
- 用 `Listy` 替换属于渲染行为变更,需要单独的可视回归,不应混在机械迁移里。
## Alternatives
- 保留静态 `message` / `Modal.confirm`:提示不继承动态主题,且 Ant Design 7 会移除,拒绝。
- 用自建单例桥接 `App` 上下文:等于重新发明静态 API,并引入第二种提示模式,拒绝。
- 本轮直接把 `List` 换成 `Listy`:改动面大、收益低,且缺少分页与固定高度语义,推迟。
## Consequences
- Admin 源码不再出现 `Alert.message`、`Space.direction`、静态 `message` 和 `Modal.confirm`。
- 提示与确认框跟随 `ConfigProvider` 主题与国际化。
- `List` 的弃用提示仍会出现在开发态控制台,作为已知技术债登记。
- 触发迁移 `List` → `Listy` 的条件:Ant Design 7 升级,或某个 `List` 数据源增长到需要虚拟滚动的规模。
## Migration plan
1. 机械迁移 `Alert` 与 `Space` 属性,跑 `typecheck`、`lint`、`test`、`build`。
2. 把静态提示 API 改为 `App.useApp()`,删除静态转出口。
3. 用 Admin 浏览器回归验证创建品牌、页面方案和会话过期提示流程。
4. 升级 Ant Design 7 前重新评估 `List` 的使用点。