文档贡献者
antd 遵循 Semantic Versioning 2.0.0 语义化版本规范。
2026-03-24
@ant-design/cli，支持离线查询 Ant Design 组件知识、分析项目用法及提供迁移指导。#57413 @afc163onValuesChange 时丢失同级字段值的问题。#57399 @zombieJuseToken 缺少 screenXXXLMin 导致生成错误的 antd.css 的问题。#57372 @sealye09classNames 和 styles。#57396 @QDyanbingfetchPriority 属性未正确透传到 <img> 元素的问题。#57392 @aojunhao123itemHoverColor 时，SubMenu 父级菜单项 hover 状态颜色不生效的问题。#57374 @EmilyyyLiucollapsedIconSize 后折叠图标看起来未居中的问题。#57360 @QDyanbingrender 属性返回 JSX 元素时搜索功能失效的问题。#57133 @WustLCQshowLine 时自定义 switcherIcon 缺少 switcher-line-icon 类名导致样式异常的问题。#57303 @QDyanbingonRemove 时的 TypeScript 报错。#57344 @QDyanbing2026-03-16
:focus-visible 外框样式，提升键盘可访问性。#57266 @ug-heroSimSun 字体的问题。#57273 @mavericusdevxxxl 断点在媒体尺寸映射中的错误。#57246 @guoyunhe2026-03-09
rules 与 dependencies 配合使用时，时序问题导致的校验失败的问题。#57147 @zombieJborderless 形态下与 Input 或 Select 并排时高度异常的问题。#57162 @QDyanbingcomponentSize 设置的问题。#57093 #57106 @QDyanbingsize 受控面板时其他面板尺寸可能计算错误的问题。#57142 @js0753titleHeight 时会连线错位的问题。#56785 @QDyanbingcsp 配置没有对所有的动态 style 生效的问题。#57159 @zombieJstyle 设置 visibility: hidden 的问题。#56720 @claytonlin1110picture-card 模式下无数据时仍然存在无效空白区域的问题。#57157 @QDyanbinges_US 国际化配置。#57137 @yuriidumych-maxsize 枚举值定义，针对 Badge、Card、Progress、Steps、Switch 及 Spin 使用 medium 替代 default，针对 Descriptions 使用 medium 和 large 替代 middle 和 default，针对 Table 和 Divider 使用 medium 替代 middle。#57127 #57106 @QDyanbingsize className 在所有组件元素上的设置值。#57106 @QDyanbingonCancel 入参不支持 KeyboardEvent 类型的问题。#57048 @eureka9282026-02-24
value 为空字符串时下拉框高度不正确的问题。#56976 @zombieJvalue 为空字符串时值回显异常的问题。#56966 @luozz1994copyable 和 ellipsis 时，悬停复制按钮会触发省略号 tooltip 的问题；修复从复制按钮移回文字后省略号 tooltip 不再出现的问题。#56855 @claytonlin1110status="active" 时动画溢出的问题。#56972 @aibayanyu20prefers-reduced-motion 媒体查询支持，禁用过渡动画以改善无障碍体验。#56902 @li-jia-nanvariant="borderless" 时高度与 Select 不一致的问题。#57014 @njlazzar-suconfirm 方法在 icon 为空时布局出现多余空白的问题。#57024 @Arktomsonaria-disabled 属性。#57049 @meet-student2026-02-10
maskClosable 全局配置。#56739 @luozz1994suffixIcon 全局配置。#56709 @guoyunheexpandIcon 和 loadingIcon 全局配置。#56482 @guoyunhescroll 全局配置。#56628 @ClaytonclassName 与 style，以及 ColorPicker 的 arrow 属性。#56573 @zombieJloadingIcon 全局配置。#56439 @guoyunherangePicker.separator 全局配置。#56499 @guoyunhetooltipIcon 和 tooltipProps 全局配置。#56372 @guoyunhexxxl（1920px）断点以适应 FHD 屏幕。#56825 @guoyunheindicator 定制。#56710 @zombieJ-content-value div DOM，优化语义化结构并支持通过 classNames 与 styles 覆盖。#56811 @zombieJnotFoundContent 不生效的问题。#56756 @QdabuliuQicon 子元素 -inner DOM 节点以更好适配语义化结构。#56783 @zombieJroot 语义化错误应用到弹出元素的问题。#56607 @zombieJsize 默认值从 default 改为 medium 以保持一致性。#56440 @guoyunheicon 子元素 -inner DOM 节点以更好适配语义化结构。#56783 @zombieJ2026-02-02
nativeElement 属性的问题。#56803 @smith3816orientation 时默认 align 不生效的问题。#55950 @YingtaoMo2026-01-26
type="text" 时组件 Token 不生效的问题。#56291 @QDyanbingfontSize 变大时各元素上下错位的问题。#56715 @QDyanbing2026-01-20
className 被清空的问题。#56593 @QdabuliuQsuffixIcon 为 null 后不会更新 DOM 的问题。#56637 @AlanQttenundefined 和 null 值被注入到 CSS 的问题。#56636 @li-jia-nanbackground 过渡为 background-color。#56598 @li-jia-nangenCssVar 方法以生成更加稳定的 CSS 变量名。#56635 @li-jia-nan2026-01-13
genCssVar 方法以生成更加稳定的 css 变量名。#56562 #56559 #56557 #56555 #56550 #56547 #56546 #56529 @li-jia-nanmarginSize 属性用于展示二维码留白区。#56569 @afc163keyboard 属性以配置键盘操作。#56581 @cactuser-LumaxWidth design token。#56540 @guoyunhetel 类型校验。#56533 @guoyunhetext 属性时，ref 无效的问题。#56532 @zombieJlocale 配置现在支持只填充部分内容。#56376 @QDyanbingtheme.cssVar 对图标无效的问题。#56504 @seanparmeleeitems 语义化属性无效的问题。#56517 @zombieJpagination 配置 totalBoundary 与 showSizeChanger 属性。#56475 @chiaweileesize 属性。#56009 @guoyunhedropdownIcon 自定义。#56250 @guoyunherole 配置。#56126 @Parederpadding: undefined 的无效样式。#56564 @li-jia-nansize="small" 时，清除按钮位置对齐问题。#56525 @QDyanbing2026-01-05
aria- 属性时，会同时给多个 DOM 添加的问题。#56451 @zombieJscroll.y 属性时，隐藏的测量表头挂载筛选下拉组件并参与事件判断，导致筛选下拉意外关闭的问题。 #56425 @QDyanbing2025-12-29
2025-12-24
hover 时无法立刻显示 Dropdown 的问题。#56273 @zombieJuseWatch 时，删除项会触发两次渲染，第一次为不正确的中间状态的问题。#56319 @QDyanbingitemRender 时的链接颜色异常的问题。#56253 @guoyunhedisabled 属性。#56280 #56093 @zenggpzqbxshowSearch 和 disabled 时鼠标样式不为禁用的问题。#56340 @QDyanbingrole 属性和 aria 属性。#56278 @aojunhao1232025-12-15
allowClear 时聚焦边框丢失的问题。#56105 @tuzixiangsdata-* 与 aria-* 属性的问题。#56165 @QDyanbingtheme.cssVar.prefix 与 theme.cssVar.key 不支持传入空字符串的问题。#56146 @QDyanbingclosable.placement 配置失效的问题。#55985 @meet-studentonValuesChange 对存在嵌套数据的 Form.List 缺失内容的问题。#56129 @zombieJselectorBg token 不生效的问题。#56052 @ug-hero2025-12-08
trigger 属性。#55932 @aojunhao123resizable的布尔类型设置。#55861 @cactuser-LucellFontSizeSM 和 cellFontSizeLG token 不生效的问题。#55770 @guoyunhe@ant-design/react-slick 版本以删除 classnames。#56080 @yoyo837rc-overflow 到 @rc-component/overflow、rc-virtual-list 到 @rc-component/virtual-list 以删除 rc-util。#56074 @yoyo8372025-12-02
flex 属性不能设置为 0 的问题。#55829 @li-jia-nangap 属性不能设置为 0 的问题。#55803 @li-jia-nancolorText token 在无前后缀的 filled 变体下不工作的问题。#56019 @ug-herosolid 变体下悬浮态的文字颜色。#55825 @andriib-ship-itborderRadiusSM 和 borderRadiusLG token 未生效问题。#56018 @ug-herocolorBgMask token 不生效的问题。#56031 @ug-herotheme.hashed 为 true，从而会导致多版本混用样式冲突的问题。#55880 @zombieJhoist: false 下通过 vite 编译。#55938 @afc163classNames 及 styles 配置类型缺失的问题。#55984 @meet-student2025-11-22
🏆 Ant Design 6.0.0 已发布！
🌟 如果你想升级到 Ant Design 6.0，请仔细查阅我们的迁移文档。
🔥 组件语义化结构，阅读《语义化发现组件精致的美》了解更多。
classNames and styles for component and ConfigProvider #52171classNames and styles for component and ConfigProvider #52141classNames and styles for component and ConfigProvider #52258classNames and styles for component and ConfigProvider #52376classNames and styles for component and ConfigProvider #52340classNames and styles for component and ConfigProvider #52669classNames and styles #52470 @coding-iceclassNames and styles for component and ConfigProvider #52759classNames and styles for component and ConfigProvider #52764classNames and styles for component and ConfigProvider #52745classNames and styles for component and ConfigProvider #52781classNames and styles for component and ConfigProvider #52780classNames and styles for component and ConfigProvider #52793classNames and styles for component and ConfigProvider #52811classNames and styles for component and ConfigProvider #52823classNames and styles for component and ConfigProvider #52849classNames and styles for component and ConfigProvider #52859classNames and styles for component and ConfigProvider #52866classNames and styles for component and ConfigProvider #52893classNames and styles for component and ConfigProvider #52895classNames and styles for component and ConfigProvider #52976classNames and styles for component and ConfigProvider #52961classNames and styles for component and ConfigProvider #52972classNames and styles for component and ConfigProvider #53055classNames and styles for component and ConfigProvider #52948classNames and styles for component and ConfigProvider #53028classNames and styles for component and ConfigProvider #53174classNames and styles for component and ConfigProvider #53150classNames and styles #53225 @wanpan11classNames and styles for component and ConfigProvider #53226classNames and styles for component and ConfigProvider #53159classNames and styles for component and ConfigProvider #53229classNames and styles for component and ConfigProvider #53303classNames and styles for component and ConfigProvider #53429 @zombieJclassNames and styles for component and ConfigProvider #53535 @zombieJclassNames and styles for components and ConfigProvider #53489classNames and styles for component and ConfigProvider #53324classNames and styles for component and ConfigProvider #53272classNames and styles for component and ConfigProvider #53694classNames and styles for component and ConfigProvider #53698classNames and styles for component and ConfigProvider #53789 @zombieJclassNames and styles for component and ConfigProvider #53659classNames and styles for component and ConfigProvider #53890ConfigProvider
rowKey 全局配置。#52751 @guoyunheroot 配置。#52248 @thinkasanyTooltip
Input
mode="spinner" 拨轮模式。#55592 @guoyunheaddon* 的使用，用 Space.Compact 替换。#55705 @EmilyyyLiustyles.textarea 无法覆盖内置样式的问题。#55579 @meet-studentMentions
suffix 语义化结构以及 size 属性。#55638 @zombieJautoResize=false 时，无法拖拽缩放尺寸的问题。#54039 @jin19980928🆕 Watermark 新增 onRemove 以支持被用户手工删除的事件触发。#55551 @984507092
🆕 Breadcrumb 支持 ConfigProvider separator 全局配置。#54680 @guoyunhe
🆕 Alert closable 支持 onClose 和 afterClose 方法。#54735 @EmilyyyLiu
🆕 Radio.Group 支持 vertical 纵向排列语法糖。#54727 @EmilyyyLiu
Cascader
aria-* 和 data-* 属性。#53910 @kiner-tangRate
Form
🆕 Flex 增加 orientation 属性用于布局，原 vertical 语法糖仍然保留。#53648 @EmilyyyLiu
DatePicker
container 支持。#55388 @meet-studentpreviewValue ，以控制鼠标悬停在选项时是否输入框展示预览值。#55258 @meet-studentonChange 参数 dateString 返回值错误的问题。#55155 @EmilyyyLiuDrawer
resizable 支持拖拽能力。#54883 @cactuser-LuCollapse
expandIconPosition 替换为expandIconPlacement，并使用逻辑位置以优化 RTL 体验。#54311 @EmilyyyLiuicon 作用元素不正确的问题。#55499 @thinkasanyTable
scrollTo 方法支持 offset 以设置滚动偏移量。#54385 @zombieJpagination.position 替换为 pagination.placement。#54338 @EmilyyyLiucolumn 为 sortable 时的 aria-description 可访问性属性。#53087 @jon-cullisoncolumn.fixed 用 start 和 end 的逻辑位置以支持 RTL。#53114 @zombieJsticky 或 scroll.y 时出现重复的筛选下拉框和提示气泡显示的问题。修复 Table 渲染初始阶段列头不显示的问题。#54910 @afc163childrenColumnName 时，数据不会刷新的问题。#55559 @li-jia-nanProgress
gapPosition 替换为 gapPlacement，并使用位置描述值 start 和 end 取代 left 和 right。#54329 @EmilyyyLiu🛠 Grid 使用 CSS 逻辑位置以支持 RTL 体验。#52560 @li-jia-nan
Notification
closable 属性将 onClose 与 closeIcon 收敛至其中。#54645 @EmilyyyLiutitle 属性用以替代 message 属性，同时废弃 message 属性。#52759 @thinkasanyImage
cover 支持设置遮罩位置。#54492 @kiner-tangcover 配置）。#54379 @765477020Modal
closable 支持 onClose 属性以任意方式关闭时触发。#54607 @EmilyyyLiuokButtonProps 和 cancelButtonProps。#53684 @guoyunheclassName 以与语义化结构规范保持一致。#54472 @thinkasanyclosable 对象中配置的 aria-* 属性应用到关闭按钮上。#53289 @EmilyyyLiuopen 状态时，屏幕交互会被锁定的问题。#52753 @zombieJTabs
tabPosition 替换为 tabPlacement，并使用位置描述值 start 和 end 取代 left 和 right。#54358 @EmilyyyLiuTheme
theme 中开启 zeroRuntime，屏蔽 cssinjs 样式生成。#54334 @MadCccautoPrefixTransformer 添加浏览器样式前缀。#54427 @zombieJuseToken 中透出 css 变量。#53195 @MadCcccolorBorderDisabled token 以统一禁用状态下的边框颜色。#52421 @aojunhao123Segmented
items.tooltip 属性以配置提示信息。#54273 @EmilyyyLiuorientation 属性用于布局，原 vertical 语法糖仍然保留。#53664 @EmilyyyLiu🛠 重命名 Steps 的 labelPlacement 为 titlePlacement 以统一 API。#53873 @zombieJ
Space
separator 代替 split。#53983 @thinkasanyorientation 代替 direction 属性。#53669 @EmilyyyLiuSplitter
orientation 代替 layout，并增加 vertical 属性。#53670 @EmilyyyLiuTour
panel 的 className 拼写错误。#55178 @thinkasanyButton
iconPosition 替换为 iconPlacement 并支持逻辑位置描述。#54279 @EmilyyyLiuvariant 与 color 样式重构为 css variables 版本以降低尺寸。#54100 @zombieJTag
disabled 和 href 属性。#52229 @aojunhao123variant 时，Tag 不会更新的问题。#55555 @thinkasanymargin 样式。#52123 @li-jia-nanTimeline
🆕 TimeLine items.position 替换为 items.placement 并使用逻辑位置以优化 RTL 体验。#54382 @EmilyyyLiu
🆕 Carousel dotPosition 替换为 dotPlacement，使用位置描述值 start 和 end 取代 left 和 right。#54294 @EmilyyyLiu
🆕 Divider 使用 orientation 替换 type，并且支持 vertical 语法糖。#53645 @EmilyyyLiu
🛠 AutoComplete 将搜索相关属性合并至 showSearch 属性。#54184 @EmilyyyLiu
🆕 Message 支持 pauseOnHover 以配置用户在悬浮时暂停倒计时。#53785 @EmilyyyLiu
💄 reset.css 移除对 IE 的兼容。#55108 @thinkasany
🛠 Slider 支持 orientation 用于配置布局方向。#53671 @EmilyyyLiu
💄 Image 遮罩添加模糊效果。#54714 @EmilyyyLiu
💄 Modal 遮罩添加模糊效果。#54670 @EmilyyyLiu
🐞 修复 Statistic.Timer 在页面进入非激活态时，onFinish 和 onChange 未触发的问题。#53894 @Psiphonc
🛠 BackTop 完成生命周期已被移除。#52206 @li-jia-nan
🗑 Icon 占位组件完成生命周期已被移除。#52241 @li-jia-nan
🛠 移除 Dropdown.Button，请使用 Space.Compact。#53793 @Meet-student
🛠 Badge 重构 offset 样式偏移为 CSS 逻辑位置。#55245 @li-jia-nan
🛠 杂项：移除 MediaQueryList 针对旧版浏览器的兼容代码。#55396 @li-jia-nan
🛠 杂项：移除 React 19 兼容代码，现在 antd 默认支持 React 19。#55274 @li-jia-nan
🛠 杂项：移除 copy-to-clipboard 依赖。#54448 @765477020
🔥 杂项：在打包产物 antd.js 以及 antd.min.js 中启用了 React Compiler 以优化性能，对使用 CJS/ESM 场景的用户可自行选择开启，参考React 官方文档。 #55781 @li-jia-nan
🌐 添加马拉地语国际化翻译。#55179 @divyeshagrawal
TypeScript
去 GitHub 查看 5.x 的 Change Log。
去 GitHub 查看 4.x 的 Change Log。
去 GitHub 查看 3.x 的 Change Log。
去 GitHub 查看 2.x 的 Change Log。
去 GitHub 查看 0.x 到 1.x 的 Change Log。