Repository navigation
v3.1.0
Upgrading from 3.0
Nothing breaks. One prop is deprecated:
hideDetailsis deprecated in favour ofdetails="hidden"and is removed in 4.0. It still works and wins when both are set. Every form control takesdetails: 'reserve' | 'auto' | 'hidden'(defaultreserve).autotakes no space until there is a hint or message.- Set it for a whole section with
<RuiFieldDefaults details="auto">, or for the app withcreateRui({ defaults: { field: { details: 'auto' } } }). A control's own prop wins, then the nearest scope, then the app default. - Nested
RuiFieldDefaultsnow fall through per setting: an inner scope that leaveslabel-placementunset takes the outer scope's value instead of skipping to the app default.
Visual changes to expect:
- The details line under every form control is 20px (was 28px on text fields, text areas, switches, sliders and the category picker, 24px on checkboxes and radios).
- Long errors are clamped to two lines, with the full text in
title. - Grey text buttons keep their secondary text colour in dark mode.
- Accordion and tab panels no longer clip their content once they finish animating, so sticky content inside them works. Content that relied on the permanent clip to stay inside a panel needs its own
overflow-hidden.
New opt-ins that replace common overrides:
RuiButton variant="link"for actions in running text, andcollapse-below="sm" | … | "2xl"for icon-only buttons on narrow screens.RuiChip size="xs"for counts.RuiCard tight-header-gapfor a 16px gap under the header.RuiDataTable'stfootslot styles total rows like body rows.details-under-labelonRuiSwitch,RuiCheckboxandRuiRadio.
In development builds, RuiDataTable now warns once when an overflow: hidden ancestor keeps its pagination bar from sticking.
🚀 Features
- buttons:
- cards:
- chips:
- forms:
- tables:
🐞 Bug Fixes
- Keep four components a single root in development - by @kelsos (99081)
- accordions: Clip accordion and tab panels only while they resize - by @kelsos (5e849)
- buttons: Keep grey text buttons secondary in dark mode - by @kelsos (ebe63)
- forms: Keep the details line a single root element - by @kelsos (02ff9)