TL;DR

Ant Design now respects user accessibility preferences with improved support for prefers-reduced-motion, ensuring smoother experiences for all users.

Fixes Worth Knowing

• Components (Avatar, List, Pagination, Steps, Table) now correctly respond to dynamic responsive configuration changes.
• Fixed issues with AutoComplete, Button, and Switch styling, including background colors, icon alignment, and reduced motion support.
• Resolved several layout problems within ConfigProvider, Descriptions, Dropdown, Form, Input.Search, Modal, Pagination, and Table components.
• Corrected Icon sizing and rendering issues, specifically with the TwitchFilled icon.

Before You Upgrade

If you dynamically change the prefixCls prop on the ConfigProvider, ensure your application handles the updated CSS variable prefixes correctly.

TL;DR

Ant Design now supports responsive breakpoints via a new responsive prop, allowing for easier adaptation of components to different screen sizes.

Breaking

• Removed useBreakpoint hook (previously for custom breakpoint logic).
• responsive prop replaces size on several components (affects component rendering).

New

• Added responsive prop to components like Grid and Space (simplifies responsive layouts).
• Introduced a new useResponsive hook (provides access to current breakpoint).

Fixes Worth Knowing

• Fixed an issue where dropdown menus wouldn’t close when clicking outside on mobile (improves mobile usability).

Before You Upgrade

• Replace any usage of the useBreakpoint hook with the new useResponsive hook and update component size props to responsive.

TL;DR

Ant Design’s Breadcrumb component now correctly displays link colors, even with custom rendering, and fixes issues with notification background colors when using custom CSS variables.

Breaking

• Breadcrumb link styles have increased priority (CSS specificity) to prevent overrides.

Fixes Worth Knowing

• Fixed an issue where Input.Search (search input field) incorrectly warned about a deprecated property.
• Corrected a layout bug in the Splitter (resizable panel) component when panel proportions didn’t equal 100%.
• Notification background colors now display correctly when cssVar is disabled.

TL;DR

The DatePicker component now supports ranges with custom formats, improving flexibility for displaying and parsing date intervals.

Breaking

• The DatePicker API for range selection has been updated (requires adjusting custom range pickers).

New

• DatePicker now allows custom formatting for range start and end dates (improves date display).

Fixes Worth Knowing

• Fixed an issue where Select component options would not properly clear when the data source was updated (improves data handling).

Before You Upgrade

• Review and update any custom DatePicker range pickers to align with the new API.

TL;DR

Ant Design’s Select dropdown now reliably displays scrollbars even with few options, improving usability.

Fixes Worth Knowing

• Select dropdowns now show scrollbars when needed.
• Transfer component (data movement) correctly handles page inversion.
• Clicking tooltips within Form components no longer unexpectedly toggles Switch components.
• Segmented component (segmented controls) className styling is now prioritized correctly.

TL;DR

Ant Design gains a new Segmented component (segmented control) and significantly improves accessibility across several components, including Checkbox, Dropdown, and Breadcrumb.

Breaking

• The children property of the Menu component will be removed in the next major version; use items instead (data-driven menu items).

New

• Segmented Component: A new Segmented component for creating segmented controls has been added.
• Table Filter Reset: Table column filters can now reset to default values instead of empty.
• Tree Enhancements: The Tree component now supports render-props for the switcherIcon and rootClassName/rootStyle properties.

Fixes Worth Knowing

• Fixed a React 18 compatibility issue causing warnings with Notification and Message.
• Resolved issues with Select and AutoComplete scrolling with keyboard navigation.
• Fixed a bug where Upload's prefixCls wasn't applying to the file list.

Before You Upgrade

• If you are using the Menu component, migrate from using children to using the

TL;DR

Ant Design now fully supports Webpack 5, resolving compatibility issues for users upgrading their build tools.

New

(No new features)

Fixes Worth Knowing

TypeScript definitions are corrected, improving type safety and developer experience for TypeScript users (a JavaScript/TypeScript syntax).

Before You Upgrade

If you are using Webpack 5, no action is needed. If you are using TypeScript, ensure your TypeScript version is compatible with the latest Ant Design definitions.

TL;DR

This release introduces significant improvements to the DatePicker component, including a redesigned range selection experience and enhanced accessibility.

Breaking

• The defaultOpenValue prop on DatePicker is removed (previously used for pre-selecting dates).
• onOpenChange now receives a boolean instead of an object (indicates if the picker is open/closed).

New

• Range Selection: DatePicker range selection is now more intuitive with a clearer visual flow.
• Accessibility: Improved keyboard navigation and screen reader support for DatePicker.

Fixes Worth Knowing

• Fixed an issue where DatePicker would sometimes lose focus after selection.

Before You Upgrade

• Update any code using defaultOpenValue to use defaultValue instead.
• Adjust any code relying on the object return value of onOpenChange to expect a boolean.

TL;DR

Ant Design now fully supports Less 3, resolving build issues for users on that version.

Fixes Worth Knowing

Resolved compatibility issues with Less 3 (CSS preprocessor), ensuring projects using this version can build correctly.

Before You Upgrade

If you were experiencing build errors while using Less 3, no action is needed – simply update to this version.

TL;DR

Ant Design now correctly handles missing children in the Upload component and improves compatibility with older versions of Internet Explorer (IE8) for textareas.

Breaking

• Upload component requires children. (Components nested inside)

Fixes Worth Knowing

• Textarea input fields now function correctly in IE8. (Older web browser)

TL;DR

Form validation in Ant Design forms is now more stable, eliminating visual jumping during the validation process.

Fixes Worth Knowing

• Form item height no longer jumps during validation.
• Table corner rounding styles are corrected.

Before You Upgrade

No specific action is needed for this update.