Ant Design 4.0
正式版于 2 月 28 日提前发布,本文将帮助你从 antd 3.x
版本升级到 antd 4.x
版本。
升级准备
- 请先升级到 3.x 的最新版本,按照控制台 warning 信息移除/修改相关的 API。
- 升级项目 React 16.12.0 以上。
- 如果你仍在使用 React 15,请参考React 16 升级文档
- 其余 React 16 废弃生命周期 API 请参考 迁移导引
4.0 有哪些不兼容的变化
设计规范调整
- 行高从
1.5
(21px
) 调整为1.5715
(22px
)。 - 基础圆角调整,由
4px
改为2px
。 - Selected 颜色和 Hovered 颜色进行了交换。
- 全局阴影优化,调整为三层阴影区分控件层次关系。
- 气泡确认框中图标的使用改变,由问号改为感叹号。
- 部分组件选中颜色统一改为
@blue-1: #E6F7FF
,对应hover
颜色改为@gray-2: #FAFAFA
。 - 报错色色值调整,由
@red-5: #F5222D
改为@red-5: #FF4D4F
。 - 分割线颜色明度降低,由
#E8E8E8
改为#F0F0F0
。 - DatePicker 交互重做,面板和输入框分离,范围选择现可单独选择开始和结束时间。
- Table 默认背景颜色从透明修改为白色。
- Tabs 火柴棍样式缩短为和文字等长。
兼容性调整
- IE 最低支持版本为 IE 11。
- React 最低支持版本为 React 16.9,部分组件开始使用 hooks 进行重构。
移除废弃的 API
- 移除了 LocaleProvider,请使用
ConfigProvider
替代。 - 移除了 Mention,请使用
Mentions
替代。 - 移除了 Alert 的
iconType
属性,请使用icon
替代。 - 移除了 Modal.xxx 的
iconType
属性,请使用icon
替代。 - 移除了 Form.create 方法,
form
现可由Form.useForm
获取。 - 移除了 Form.Item 的
id
属性,请使用htmlFor
替代。 - 移除了 Typography 的
setContentRef</