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
2.5 KiB
2.5 KiB
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
Alert统一使用title;正文仍用description。Space统一使用orientation。- 所有提示与确认框改为
App.useApp()取得的实例:- 组件与自定义 hook 在函数体首部声明
const { message } = App.useApp();。 - 确认框改为
const { modal } = App.useApp();后调用modal.confirm。 - 删除
components/AdminMessage.ts这一静态转出口,避免再次绕过上下文。
- 组件与自定义 hook 在函数体首部声明
- 暂不迁移
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
- 机械迁移
Alert与Space属性,跑typecheck、lint、test、build。 - 把静态提示 API 改为
App.useApp(),删除静态转出口。 - 用 Admin 浏览器回归验证创建品牌、页面方案和会话过期提示流程。
- 升级 Ant Design 7 前重新评估
List的使用点。