Skip to content

v5.0.0

Latest

Choose a tag to compare

@gravity-ui-bot gravity-ui-bot released this 02 Nov 09:30
4aeadee

5.0.0 (2026-10-27)

⚠ BREAKING CHANGES

Peer dependencies

@gravity-ui/uikit ^8.0.0 is required, uikit v7 is not supported. React and React DOM have to be 18 or 19. @types/react is optional now: in 4.x a typo made it required. No optional peers of uikit are needed.

Details

Language is set on Provider

ThemeProvider no longer accepts lang. Move lang to Provider or LangProvider. TypeScript reports a leftover lang, but plain JavaScript ignores it, and the components fall back to English.

Details

Timezone list is not virtualized

The timezone list of RelativeRangeDatePicker (withZonesList) renders all ~420 options, and uikit logs a console.error in development. To keep it virtualized, install @tanstack/react-virtual and wrap the application in <ListVirtualizer minItemsCount={50}> from @gravity-ui/uikit/virtualizer.

Details

hasDate and hasTime are removed

DatePickerState and RangeDatePickerState no longer have the deprecated hasDate and hasTime. Use state.formatInfo.hasDate and state.formatInfo.hasTime.

Details

Props hooks return uikit v8 props

useDatePickerProps, useRelativeDatePickerProps, useRelativeDateFieldProps, useDateFieldProps and useCalendarProps return props for the uikit v8 components. popupProps has no onEscapeKeyDown and onOutsideClick: dismissal comes through onOpenChange(open, event, reason). If you only spread these props, nothing changes.

Details

RelativeRangeDatePickerDialog on mobile

If you render the dialog yourself: the sheet is controlled by open, onClose is called once with the real reason ('escape-key', 'outside-press', 'swipe' or 'navigation') as soon as the sheet starts to close, and onRemove is called after the closing animation. In 4.x applying a value called onClose twice.

Details

Pickers inside Dialog and Modal

A uikit v8 Dialog moves focus to its content about 150ms after mount. A picker focused earlier, for example in a fast test, loses focus, and its popup closes. In tests, wait until the dialog has focus.

Details

Visual changes

Colors come from Themer v2, the hover styles of uikit components apply only on devices that can hover, and the presets and timezone lists of RelativeRangeDatePicker look like the uikit v8 List and Select. Update screenshot baselines and CSS overrides of uikit classes.

Details