更新日志

文档贡献者

Ant Design of React 快速上手

6.0.0

2025-11-22

🏆 Ant Design 6.0.0 已发布！

升级必读

🌟 如果你想升级到 Ant Design 6.0，请仔细查阅我们的迁移文档。

主要变化

🔥 组件语义化结构。感谢 @thinkasany 与 @meet-student 主导整个语义化结构的开发工作。
- 🔥 antd 组件支持语义化结构以及 ConfigProvider 配置。#53659 #53535 #52759 #53028 #52340 #52895 #52258 #52376 #53055 #53226 #53150 #53429 #52976 #52961 #52948 #53890 #53694 #53789 #53225 #53324 #52793 #53698 #53272 #53489 #52172 #52823 #53303 #52764 #53229 #53159 #53174 #52250 #52972 #52893 #52866 #52859 #52849 #52811 #52780 #52781 #52745 #52470 #52669 #52303 #52141 #52171 #54145 #53958 #55430
- 🔥 antd 组件语义化支持函数根据 props 动态生成。#54967 #54977 #54962 #54960 #55099 #54986 #54988 #54987 #55199 #54985 #55119 #54980 #55054 #54979 #55161 #55157 #55021 #55081 #55096 #55044 #55060 #54984 #54983 #55117 #54982 #55190 #55007 #55118 #54978 #54968 #54966 #54994 #54965 #55101 #54963 #55109 #54996 #54969 #55126 #54959 #55056 #55114 #54956 #54957 #55013 #54958 #55031 #54955 #55058 #55032 #54948 #54950 #54949 #54917 #54919 #54813 #55796 @meet-student @hcjlxl @Arktomson @zjr222 @Linkodt @xkhanhan @lovelts @tanjiahao24 @li-jia-nan @Susuperli @ccc1018 @nmsn @GinWU05
🔥 新增 Masonry 瀑布流组件。#52162 @OysterD3
ConfigProvider
- 🆕 ConfigProvider 支持 Table rowKey 全局配置。#52751 @guoyunhe
- 🆕 ConfigProvider 支持 Card.Meta 的配置。#52214 @thinkasany
- 🆕 ConfigProvider 支持Tooltip / Popover / Popconfirm 组件的箭头配置。#52434 @thinkasany
- 🆕 ConfigProvider 支持 Space 组件 root 配置。#52248 @thinkasany
Tooltip
- 🔥 ConfigProvider 支持配置 tooltip.unique 让 Tooltip 支持平滑移动。#55154 @zombieJ
- ⚡️ 优化 Tooltip 开发模式下性能（约 ~40%）以提升研发体验。#53844 @zombieJ
Input
- 🔥 InputNumber 增加 mode="spinner" 拨轮模式。#55592 @guoyunhe
- 🗑 Input.Search 重构废弃内部 addon* 的使用，用 Space.Compact 替换。#55705 @EmilyyyLiu
- 🐞 修复 Input.TextArea 的 styles.textarea 无法覆盖内置样式的问题。#55579 @meet-student
🆕 Pagination 快速跳转输入框现在限制只能输入数字。#55700 @afc163
Mentions
- 🛠 重构 Mentions DOM 结构并支持 suffix 语义化结构以及 size 属性。#55638 @zombieJ
- 🐞 修复 Mentions 的 autoResize=false 时，无法拖拽缩放尺寸的问题。#54039 @jin19980928
🆕 Watermark 新增 onRemove 以支持被用户手工删除的事件触发。#55551 @984507092
🆕 Breadcrumb 支持 ConfigProvider separator 全局配置。#54680 @guoyunhe
🆕 Alert closable 支持 onClose 和 afterClose 方法。#54735 @EmilyyyLiu
🆕 Radio.Group 支持 vertical 纵向排列语法糖。#54727 @EmilyyyLiu
Cascader
- 🆕 Cascader 支持 aria-* 和 data-* 属性。#53910 @kiner-tang
- 🆕 Cascader.Panel 添加 optionRender 允许自定义渲染选项。#54843 @EmilyyyLiu
🆕 Upload accept 配置支持自定义过滤逻辑。#55543 @zombieJ
Rate
- 🆕 Rate 支持 size 以配置大小。#55028 @guoyunhe
- 🆕 Rate tooltips 支持所有的提示属性配置。07b1610 @Jerryqun
🆕 Select 支持键盘和鼠标交互时 onActive 回调。#53931 @Wxh16144
🆕 Typography copyable 支持 HTTP 环境。#55073 @JeeekXY
Form
- 🔥 Form useWatch 支持动态更改监听字段名称。#54260 @zombieJ
- 🆕 Form 现在取值会排除 Form.List 中未被注册的字段值。#55526 @crazyair
- ⚡️ 优化 Form 在大量字段卸载时 useWatch 的性能。#54212 @zombieJ
🆕 Flex 增加 orientation 属性用于布局，原 vertical 语法糖仍然保留。#53648 @EmilyyyLiu
DatePicker
- 🆕 DatePicker 语义化结构新增面板 container 支持。#55388 @meet-student
- 🆕 DatePicker 新增 previewValue ，以控制鼠标悬停在选项时是否输入框展示预览值。#55258 @meet-student
- 🐞 修复 DatePicker 在清空时，onChange 参数 dateString 返回值错误的问题。#55155 @EmilyyyLiu
Drawer
- 🆕 Drawer 新增 resizable 支持拖拽能力。#54883 @cactuser-Lu
- 💄 Drawer 遮罩添加模糊效果。#54707 @EmilyyyLiu
🆕 ColorPicker presets 支持渐变色预设值。#53250 @zombieJ
Collapse
- 🆕 Collapse expandIconPosition 替换为expandIconPlacement，并使用逻辑位置以优化 RTL 体验。#54311 @EmilyyyLiu
- 🐞 修复 Collapse 语义化结构 icon 作用元素不正确的问题。#55499 @thinkasany
- 🐞 修复 Collapse 动态修改语义化 icon 不生效的问题。#55452 @thinkasany
Table
- 🆕 Table scrollTo 方法支持 offset 以设置滚动偏移量。#54385 @zombieJ
- 🆕 Table pagination.position 替换为 pagination.placement。#54338 @EmilyyyLiu
- ⌨️ ⌨️ 优化 Table column 为 sortable 时的 aria-description 可访问性属性。#53087 @jon-cullison
- 🆕 重构 Table column.fixed 用 start 和 end 的逻辑位置以支持 RTL。#53114 @zombieJ
- 🐞 修复 Table 在使用 sticky 或 scroll.y 时出现重复的筛选下拉框和提示气泡显示的问题。修复 Table 渲染初始阶段列头不显示的问题。#54910 @afc163
- 🐞 修复 Table 在动态修改 childrenColumnName 时，数据不会刷新的问题。#55559 @li-jia-nan
Progress
- 🆕 Progress gapPosition 替换为 gapPlacement，并使用位置描述值 start 和 end 取代 left 和 right。#54329 @EmilyyyLiu
- 🐞 修复 Progress 在变更 props 时，指示内容不会更新的问题。#55554 @thinkasany
🛠 Grid 使用 CSS 逻辑位置以支持 RTL 体验。#52560 @li-jia-nan
Notification
- 🛠 Notification 提供 closable 属性将 onClose 与 closeIcon 收敛至其中。#54645 @EmilyyyLiu
- 🆕 Notification 支持自定义进度条颜色。#52964 @yellowryan
Image
- 🆕 Image 的预览遮罩 cover 支持设置遮罩位置。#54492 @kiner-tang
- 🛠 Image 移除默认的查看图标和文案（仍然可以通过 cover 配置）。#54379 @765477020
- 🐞 修复 Image 在 RTL 下预览文案的展示问题。#53596 @aojunhao123
Modal
- 🆕 Modal closable 支持 onClose 属性以任意方式关闭时触发。#54607 @EmilyyyLiu
- 🆕 ConfigProvider 支持配置 Modal 的 okButtonProps 和 cancelButtonProps。#53684 @guoyunhe
- 🛠 Modal 调整 DOM className 以与语义化结构规范保持一致。#54472 @thinkasany
- ⌨️ 将 Modal 在 closable 对象中配置的 aria-* 属性应用到关闭按钮上。#53289 @EmilyyyLiu
- 🐞 修复 Modal 快速切换 open 状态时，屏幕交互会被锁定的问题。#52753 @zombieJ
Tabs
- 🆕 Tabs tabPosition 替换为 tabPlacement，并使用位置描述值 start 和 end 取代 left 和 right。#54358 @EmilyyyLiu
- 💄 Tabs 移除激活态文字阴影。#53617 @guoyunhe
- 🐞 Tabs 修复空内容 TabPane 的焦点行为，提升无障碍体验。#52856 @aojunhao123
- 🛠 移除 Tabs 废弃 API。#52768 @aojunhao123
Theme
- 🔥 支持通过 ConfigProvider 的 theme 中开启 zeroRuntime，屏蔽 cssinjs 样式生成。#54334 @MadCcc
- 🆕 杂项：CSS-in-JS 支持配置 autoPrefixTransformer 添加浏览器样式前缀。#54427 @zombieJ
- 🆕 Design Token: 在 useToken 中透出 css 变量。#53195 @MadCcc
- 💄 杂项：从 reset.css 中移除 mark 样式。#52974 @afc163
- 🔥 杂项：默认使用 CSS 变量。#52671 @MadCcc
- 💄 Design Token 新增 colorBorderDisabled token 以统一禁用状态下的边框颜色。#52421 @aojunhao123
Segmented
- 🆕 Segmented 支持 items.tooltip 属性以配置提示信息。#54273 @EmilyyyLiu
- 🆕 Segmented 增加 orientation 属性用于布局，原 vertical 语法糖仍然保留。#53664 @EmilyyyLiu
- 🛠 改善 Segmented 组件可访问性。#52618 @aojunhao123
🛠 重命名 Steps 的 labelPlacement 为 titlePlacement 以统一 API。#53873 @zombieJ
Space
- 🛠 Space 使用 separator 代替 split。#53983 @thinkasany
- 🛠 Space 使用 orientation 代替 direction 属性。#53669 @EmilyyyLiu
🆕 Spin 支持 styles.wrapper。#53448 @crazyair
Splitter
- 🆕 Splitter 使用 orientation 代替 layout，并增加 vertical 属性。#53670 @EmilyyyLiu
- 🆕 Splitter 新增自定义拖拽图标。#52216 @wanpan11
Tour
- 🐞 修复 Tour 在滚动时，弹层不跟随的问题。#53140 @dependabot
- 🐞 修复 Tour dom 结构中 panel 的 className 拼写错误。#55178 @thinkasany
Button
- 🆕 Button iconPosition 替换为 iconPlacement 并支持逻辑位置描述。#54279 @EmilyyyLiu
- 🛠 Button variant 与 color 样式重构为 css variables 版本以降低尺寸。#54100 @zombieJ
- 🆕 Button 新增自定义普通、虚线类型的按钮在禁用状态下的背景颜色。#52839 @yellowryan
Tag
- 🆕 Tag 新增 CheckableTagGroup 子组件。#53256 @guoyunhe
- 🆕 Tag 自定义颜色支持变体。#53097 @guoyunhe
- 🆕 Tag 新增 disabled 和 href 属性。#52229 @aojunhao123
- 🐞 修复 Tag 通过 ConfigProvider 修改 variant 时，Tag 不会更新的问题。#55555 @thinkasany
- 💄 移除 Tag margin 样式。#52123 @li-jia-nan
Timeline
- 🆕 Timeline 支持 titleSpan 以配置 title 占用尺寸。#54072 @zombieJ
- 🆕 Timeline 支持 orientation=horizontal 布局。#54031 @zombieJ
🆕 TimeLine items.position 替换为 items.placement 并使用逻辑位置以优化 RTL 体验。#54382 @EmilyyyLiu
🆕 Transfer 新增 actions 属性可用于自定义操作按钮。#54104 @afc163
🆕 Carousel dotPosition 替换为 dotPlacement，使用位置描述值 start 和 end 取代 left 和 right。#54294 @EmilyyyLiu
🆕 Divider 使用 orientation 替换 type，并且支持 vertical 语法糖。#53645 @EmilyyyLiu
🛠 AutoComplete 将搜索相关属性合并至 showSearch 属性。#54184 @EmilyyyLiu
🆕 Menu 支持 popupRender 属性自定义弹出层。#53566 @Zyf665
🆕 Message 支持 pauseOnHover 以配置用户在悬浮时暂停倒计时。#53785 @EmilyyyLiu
💄 reset.css 移除对 IE 的兼容。#55108 @thinkasany
🛠 Slider 支持 orientation 用于配置布局方向。#53671 @EmilyyyLiu
💄 移除 InputNumber 移动端对于控制器默认隐藏。#54900 @Wxh16144
💄 Image 遮罩添加模糊效果。#54714 @EmilyyyLiu
💄 Modal 遮罩添加模糊效果。#54670 @EmilyyyLiu
🐞 修复 Statistic.Timer 在页面进入非激活态时，onFinish 和 onChange 未触发的问题。#53894 @Psiphonc
🛠 废弃 List 组件并且从官网移除。#54182 @zombieJ
🛠 BackTop 完成生命周期以被移除。#52206 @li-jia-nan
🗑 Icon 占位组件完成生命周期以被移除。#52241 @li-jia-nan
🛠 移除 Dropdown.Button，请使用 Space.Compact。#53793 @Meet-student
🛠 Badge 重构 offset 样式偏移为 CSS 逻辑位置。#55245 @li-jia-nan
🛠 杂项：替换 classNames 库为 clsx。0246702 #55164 @lijianan
🛠 杂项：移除 MediaQueryList 针对旧版浏览器的兼容代码。#55396 @li-jia-nan
🛠 杂项：移除 React 19 兼容代码，现在 antd 默认支持 React 19。#55274 @li-jia-nan
🛠 杂项：移除 copy-to-clipboard 依赖。#54448 @765477020
🔥 杂项：提升构建目标版本，不再支持 IE。#53390 @zombieJ
🆕 杂项：颜色相关组件现在支持预设颜色名（如 red, blue, green 等等）。#53241 @zombieJ
🌐 添加马拉地语国际化翻译。#55179 @divyeshagrawal
TypeScript
- 🤖 优化 Notification duration 定义，现在禁止关闭为 false。#55580 @wanpan11

Ant Design

更新日志

发布周期

6.0.0

升级必读

主要变化

5.x

4.x

3.x

2.x

1.11.4