Skip to content

v7.0.0-beta.1

Pre-release
Pre-release

Choose a tag to compare

@heath-freenome heath-freenome released this 20 Nov 23:12
· 1 commit to main since this release

New Major Release

See the v7.x Upgrade Guide for more information.

@rjsf/antd

  • BREAKING CHANGE: Remove support for antd 5: the peer dependency range is now ^6.7.0, since earlier antd 6 releases crash @rjsf/antd forms on first render or don't understand a labelAlign of 'start' or 'end', and ErrorList and CyclicSchemaExpandTemplate always pass Alert its title prop. See the upgrade guide (#5264, #5763)
  • Change DateWidget/DateTimeWidget to show a format: "iso-date-time" value as a naive local date-time instead of converting it to a UTC ISO string, and a stored value that carries an offset as the wall-clock time it represents (#5270, #3930)
  • BREAKING CHANGE: Fix BaseInputTemplate never calling onChangeOverride for a numeric field: such a field now renders an Input with type="number", so the override receives the ChangeEvent, as in every other theme. See the upgrade guide (#5285, #5303)
  • Add ui:options.optgroups support to SelectWidget, grouping its options through rc-select's nested options (#5301)
  • Change WrapIfAdditionalTemplate to render an additional property's key as a select of the names propertyNames.enum allows instead of a free-text input, and fix a deprecated additional property offering its decoration as a key name or renaming itself to it (#5321, #4682)
  • BREAKING CHANGE: Change the default Form export to a ThemedForm generic over the form data, and keep each component's own generic type in the Theme, Templates and Widgets exports instead of any; generateForm() returns a ThemedForm<T, S, F> and the other generators default to unknown. See the upgrade guide (#5311)
  • Fix FieldTemplate showing a field's ui:help in place of its validation errors, so a field with ui:help showed no error message; both now show (#5351, #5326)
  • Fix FieldTemplate dropping a ui:help given as a React element, along with the field's errors (#5351, #5326)
  • Add FieldHelpTemplate to the theme's templates, keeping help text in antd's description color rather than its error tint when the field has errors; restyling .help-block's color for that case needs !important (#5351, #5326)
  • Fix RadioWidget's object options and FieldTemplate's object/array selects, and make SelectWidget report its form data value on focus and blur (#5350, #5309, #5317)
  • Fix realValue options whose String() matches, such as 1 and '1', sharing a DOM value (#5400, #5315)
  • Fix AltDateWidget rendering no hour, minute or second selects for alt-datetime, emitting a date-only value, and letting its Now and Clear buttons change a readonly or disabled field (#5410)
  • Fix TextareaWidget replacing a ui:options.rows of 0 with 4 rows; it now gets the browser's default height, as with @rjsf/core's TextareaWidget (#5387)
  • Fix FieldErrorTemplate giving every React element error the same ...-[object Object] key and a repeated string error the same key twice (#5382)
  • Fix ObjectFieldTemplate giving a property no column span when formContext.colSpan has no valid entry for it, the default span counting hidden properties, and keying a property by another widget or type than it renders with, such as a boolean shown as a select (#5450, #5611, #5791, #5447, #5516)
  • BREAKING CHANGE: Fix AltDateWidget's date parts having no accessible name: each select is named by the label, even a hidden one, and its part, such as When, year, and described by the field's description, help and errors. See the upgrade guide (#5418, #5355, #5357)
  • Fix SelectWidget not giving the aria-label and aria-describedby it is passed to its control (#5418, #5355, #5357)
  • Fix CheckboxesWidget's options staying enabled in a disabled field, where a click still changed the form data, and CheckboxesWidget's and RadioWidget's in a readonly field under readonlyAsDisabled (#5487)
  • Change the theme to declare its presentation, so ui:label: false now hides every field's description, a checkbox's included, as in every other theme, and WrapIfAdditionalTemplate labels the key through hasAdditionalKeyLabel() (#5531, #5490)
  • Fix FieldHelpTemplate repeating the field's id for an anyOf/oneOf option's own ui:help; aria-describedby lists an option's own description and help among the field's in the order they are drawn (#5531, #5490, #5794, #5720)
  • Fix TitleField rendering the titleId() it is handed as a for naming nothing rather than as an id: it puts it on a <span> around the title's text, inside the <label>, so an object's option selector is named "Pet"; its click handler is gone (#5531, #5544, #5490)
  • Fix CheckboxWidget carrying the native required attribute where the schema doesn't demand true, so a required boolean left unchecked now submits as false (#5531, #5388, #5490)
  • Fix SelectWidget's selected option description rendering under an id other than the one the select is described by; aria-describedby lists it before the field's description and help, the order they are drawn in (#5531, #5718, #5490, #5367)
  • Change BaseInputTemplate, PasswordWidget, TextareaWidget, DateWidget and CheckboxWidget to be aria-invalid while errors show and described only by what renders; RadioWidget and CheckboxesWidget name their group by the label, and RangeWidget's handle is named by it (#5544, #5490)
  • Fix FieldTemplate marking a label required for a widget declared uncheckedIsFalse where the schema doesn't demand true; it now reads the plan's label.requiredMarker (#5543, #5388, #5490)
  • Fix FieldTemplate's descriptionLocation: 'tooltip' pointing aria-describedby at a description that doesn't exist, losing a checkbox's description, and adding the icon to the control's name (#5544, #5490)
  • Fix ArrayFieldTemplate drawing the ui:title an anyOf/oneOf option repeats a second time, and dropping an optional array's data control where it draws no heading, as under ui:label: false (#5544, #5490)
  • Fix MultiSchemaFieldTemplate rendering an empty <div> for a selector it isn't given, as while an optional anyOf/oneOf field has no data (#5543, #5401, #5490)
  • Fix ObjectFieldTemplate dropping the optional data control where it draws no heading, as under ui:label: false, and rendering an empty column where there is no control (#5531, #5490)
  • BREAKING CHANGE: Change FieldTemplate to draw a radio, checkboxes or range field's label with no for, as core's does, so a selector aimed at label[for=…] for such a field should aim at label:has(#root_color__label). See the upgrade guide (#5544, #5490)
  • Change RadioWidget under ui:autofocus to focus its checked radio, or the first a user can choose, and CheckboxesWidget the first checkbox a user can choose (#5544, #5490)
  • BREAKING CHANGE: Change AltDateWidget's date parts to sit in a group with the field's id, named by the label, which has no for, each part aria-invalid while errors show, so label[for="root_when"] should be label:has(#root_when__label). See the upgrade guide (#5544, #5490, #5542)
  • Fix AltDateWidget's Now and Clear buttons staying enabled when the field is disabled (#5544, #5490)
  • Fix DateWidget and PasswordWidget ignoring a nameGenerator: their input's name is now htmlName, as in the other widgets (#5544, #5490)
  • Fix WrapIfAdditionalTemplate's key input having no name under ui:label: false, SelectWidget not being aria-required for a required field, and PasswordWidget, TextareaWidget, DateWidget and RadioWidget's radios (a read-only field's excepted) not being required for one (#5544, #5490)
  • BREAKING CHANGE: Change FieldTemplate to put the label id on a <span> around the label's text, apart from antd's * and :, so a group or slider handle named by it is named Color rather than * Color:. See the upgrade guide (#5544, #5490)
  • Fix BaseInputTemplate, PasswordWidget, TextareaWidget, DateWidget and WrapIfAdditionalTemplate's key input staying editable for a ui:readonly field under readonlyAsDisabled: false, DateWidget opening its popup or drawing its clear icon there (#5544, #5882, #5490, #5603)
  • Fix a read-only RadioWidget being required and changing on click (#5544, #5490)
  • Add block as the theme's globalUiOptionsKeys, typed by the new AntdGlobalUISchemaOptions and UiSchema types, so a global block reaches RemoveButton outside a LayoutGridField too (#5611, #5607)
  • Fix ObjectFieldTemplate showing no add button for an object naming no additionalProperties in a form whose additionalPropertiesWhenAbsent is 'allow' (#5620, #2137)
  • Change FieldTemplate to set its form item's error status from the field's own errors, the hasErrors prop, so an anyOf/oneOf option follows its own ui:hideError; a custom field rendering it by hand passes hasErrors with its errors (#5646)
  • Add aria-invalid and a description by its row's errors to WrapIfAdditionalTemplate's key input, the free-text one and the propertyNames select alike, while the object forbids that key, and give its Form.Item antd's error status (#5640, #4630)
  • Fix the widgets ignoring a <ConfigProvider componentDisabled>: every widget, IconButton's buttons and AltDateWidget's Now and Clear are disabled under it, and SelectWidget's and RangeWidget's hidden inputs post nothing (#5487, #5625, #5506, #5593, #5597)
  • Add antd HiddenWidget and RatingWidgets that honor <ConfigProvider componentDisabled> (#5625, #5506, #5593, #5597)
  • Fix a read-only CheckboxWidget being required, and a read-only RadioWidget, CheckboxWidget, CheckboxesWidget or SelectWidget left enabled not being aria-readonly (#5625, #5506, #5593, #5597)
  • Fix BaseInputTemplate, TextareaWidget, PasswordWidget and DateWidget ignoring ui:autofocus (#5625, #5597)
  • Fix SelectWidget and RangeWidget posting nothing in a native submit or new FormData(form): they render hidden inputs under htmlName, and SelectWidget no longer puts name on its root <div> (#5625, #5597)
  • BREAKING CHANGE: Change an additional property's key input id to root_foo__key from root_foo-key, built by the new additionalKeyId(). See the upgrade guide (#5626)
  • BREAKING CHANGE: Fix ObjectFieldTemplate giving a column to a property hidden by deprecatedHandling: 'hide' or a ui:definitions hidden widget: it now leaves the property out, as it does one with its own ui:widget: 'hidden'. See @rjsf/antd and @rjsf/mantine leave out a property hidden by deprecatedHandling or ui:definitions (#5617, fixes #5507)
  • Fix RangeWidget's slider handle not being described by its field's errors, description and help, or marked aria-invalid while errors show (#5715, fixes #5560)
  • BREAKING CHANGE: Change GridTemplate to read a column's span as twelfths of a row, doubled into antd's 24 columns, so span: 12 is now a whole row rather than half; a half step such as 4.5 spans an odd 24th, one finer than a half step is rounded to the nearest one with a warning, and a span over 12 logs a warning to halve it; a column with a flex prop or a flex, flexBasis or width style of its own keeps it in place of its span, logging a warning that its span is ignored. See the upgrade guide (#5707, #5651)
  • Fix a layout grid ui:row nested in another ui:row shrinking to its content rather than taking a line of its own: GridTemplate gives a row without a flex, flexBasis, flexGrow or width style of its own a flex of 1 1 100%, ahead of the rest of its style (#5707, #5651)
  • Fix SelectWidget leaving a select no label names, such as an untitled root or array item select, without an accessible name; it is named by its ui:placeholder, else TranslatableString.SelectPlaceholder ("Select ...") (#5713, #5711)
  • Fix RadioWidget leaving a radiogroup no label names, such as an untitled field's, without an accessible name; it is named by its ui:placeholder, else TranslatableString.RadioGroupName ("Choose an option") (#5713, #5586)
  • Fix renaming an additionalProperties key remounting its field, which lost what its widget held, such as an alt-date's partly picked date (#5733, #5595)
  • Fix the text input rendering a stray 0 beside it when its value is 0 and allowClearTextInputs is set (#5682)
  • Change a text input holding false, which it shows, to offer the clear button for it (#5682)
  • Fix RangeWidget drawing a numeric string, and posting it, at its minimum (#5682)
  • Fix RangeWidget and InputNumber writing a number into a string field, which then failed validation and, for InputNumber, lost the digits past a number's precision: they now write a numeric string, as core's range input does (#5682)
  • Change the number input to show nothing, and offer no clear button, for a boolean or object value (#5682)
  • Change PasswordWidget to show a value of 0 or false, where it was empty (#5682)
  • BREAKING CHANGE: Change the alt-date and alt-datetime widgets to show a number or Date value as empty, where they showed that date, since they can only write a string back. See the upgrade guide (#5682)
  • Fix BaseInputTemplate dropping a pattern, inputMode, accept or multiple a widget passes it as a prop, so the file input of an array took one file at a time, and a number field a widget passes an onChangeOverride getting a native number input that blocked a decimal rather than the text input the other themes render (#5684)
  • Fix WrapIfAdditionalTemplate leaving the key input and the remove button enabled for a property it is handed no rename or remove callback for, such as the root (#5684)
  • BREAKING CHANGE: Change AltDateWidget to show the default years for a yearsRange reaching before 100, such as [50, 2030], where it offered that range and wrote a year before 100 as 19xx. See the upgrade guide (#5685)
  • Fix AltDateWidget spacing its date parts by a NaN gutter when formContext.rowGutter is a pair, a responsive object or a CSS length: they now take half of each side of a pair, and half of a single gutter both ways, as they did of a number, though Row applies a single gutter horizontally only. A numeric string such as '16', which Row turns into invalid CSS, now gives no spacing, as Row draws none for it, where it gave half its number (#5686)
  • Add the AntdFormContext type, the formContext options the antd theme reads (#5686)
  • Fix RangeWidget for an Ajv $data reference in minimum, maximum or multipleOf, which set the range's bound or step to the object and now leaves it at its default, and read a numeric-string bound such as minimum: '5' as its number (#5688)
  • BREAKING CHANGE: Change WrapIfAdditionalTemplate to read ADDITIONAL_PROPERTY_FLAG by its truth rather than its presence, so a schema with it set to undefined or false renders as a plain field, with no key input or remove button. See the upgrade guide (#5689)
  • Fix a required anyOf/oneOf field showing two *s with a titled object or array option selected: only the field's label is marked now (#5743, #5573)
  • BREAKING CHANGE: Fix CheckboxesWidget giving a screen reader no cue that a checked box is required: a required group whose minItems is at least 1, or with ui:required: true, is now named with "required", and a required group with neither, which submits [], no longer shows a *. See the upgrade guide (#5743, #5573)
  • BREAKING CHANGE: Change ObjectFieldTemplate and ArrayFieldTemplate to start an object and an array heading, like a field label above its control, and formContext.labelAlign to align field labels too. See the upgrade guide (#5763, #5745)
  • BREAKING CHANGE: Change ObjectFieldTemplate to key a property in formContext.colSpan by what SchemaField renders it as: its widget, the field its $id names, or an untyped anyOf option's type. See the upgrade guide (#5791, #5516)
  • Fix a field's aria-describedby listing its description before its help, while FieldTemplate draws the help first, below the control (#5794, #5720)
  • Fix ArrayFieldTemplate and ObjectFieldTemplate leaving an object's or an array's group unnamed and undescribed by the field's errors, description and help (#5795, #5723)
  • BREAKING CHANGE: Fix a required multiple SelectWidget blocking a submit of the [] its schema accepts: an array rendered as one widget holding [] is now required, and shows a *, only where its minItems is at least 1 or ui:required: true asks for it. See the upgrade guide (#5822, #5744)
  • Add support for importing and rendering Form from a React Server Component, such as a Next.js App Router page, without wrapping it in a 'use client' module of your own (#5863, #5761)
  • Add the IDs antd-span-twelfths and antd-span-own-width to the warnings for a layout grid column span over 12 and for one ignored beside the column's own flex or width, ending their messages, so setWarningOptions() can make them throw (#5868, #5775)
  • Fix TitleField keeping a title's trailing colon when formContext.colon is null, 0 or '', where the field's label drops it (#5882, #5603)
  • Fix BaseInputTemplate, CheckboxWidget, CheckboxesWidget, DateWidget, PasswordWidget, RadioWidget, RangeWidget, SelectWidget and TextareaWidget not calling onFocus and onBlur for a read-only field, as @rjsf/core does (#5882, #5603)
  • Fix FieldErrorTemplate drawing an empty item for an empty error message (#5882, #5603)
  • BREAKING CHANGE: Change ObjectFieldTemplate to title an expandable object's Add button after the object's title or name, such as Add Address. See the upgrade guide (#5899, #3596)

@rjsf/bootstrap3

  • Add @rjsf/bootstrap3, a theme that keeps the Bootstrap 3 markup @rjsf/core rendered through v6, with a layout grid column's span as its col-xs-* class unless it has one of its own, which it warns about, as it does about a span that isn't a whole number, deprecated from the start and removed in v8 (#5635, #5707, #5616, #5651)
  • Fix a required anyOf/oneOf field showing two *s with a titled object or array option selected: only the field's label is marked now (#5743, #5573)
  • BREAKING CHANGE: Fix CheckboxesWidget giving a screen reader no cue that a checked box is required: a required group whose minItems is at least 1, or with ui:required: true, is now named with "required", and a required group with neither, which submits [], no longer shows a *. See the upgrade guide (#5743, #5573)
  • Fix ArrayFieldTemplate and ObjectFieldTemplate leaving an object's or an array's group undescribed by the field's errors, description and help (#5795, #5723)
  • BREAKING CHANGE: Fix a required multiple SelectWidget blocking a submit of the [] its schema accepts: an array rendered as one widget holding [] is now required, and shows a *, only where its minItems is at least 1 or ui:required: true asks for it. See the upgrade guide (#5822, #5744)
  • Add support for importing and rendering Form from a React Server Component, such as a Next.js App Router page, without wrapping it in a 'use client' module of your own (#5863, #5761)
  • BREAKING CHANGE: Change AddButton to take the title it is passed, which titles an expandable object's Add button after the object, such as Add Address, and to fall back to Add Item instead of Add. See the upgrade guide (#5899, #3596)

@rjsf/chakra-ui

  • Fix the widgets deleting non-style keys from the uiSchema's ui:options.chakra: getChakra() returns a filtered copy rather than changing the caller's object (#5285)
  • Fix ChakraUiSchema accepting anything, since its Omit<UiSchema, 'ui:options'> erased every named member (#5285)
  • Change BaseInputTemplate to render a number/integer field as <input type="text"> with a numeric inputMode, a pattern and a title, without step, min or max; set ui:options.inputType: 'number' or use the updown widget for a native number input (#5303, #4038)
  • Add ui:options.optgroups support to SelectWidget, grouping its options with Select.ItemGroup/Select.ItemGroupLabel (#5301)
  • BREAKING CHANGE: Remove chakra-react-select from peerDependencies; it no longer needs to be installed alongside @rjsf/chakra-ui. See the upgrade guide (#5301)
  • Fix NativeSelectWidget ignoring ui:enumDisabled, leaving every option selectable (#5301)
  • Change WrapIfAdditionalTemplate to render an additional property's key as a select of the names propertyNames.enum allows instead of a free-text input, and fix a deprecated additional property offering its decoration as a key name or renaming itself to it (#5321, #4682)
  • BREAKING CHANGE: Fix BaseInputTemplate, CheckboxesWidget, NativeSelectWidget, SelectWidget, TextareaWidget and UpDownWidget staying flagged invalid under ui:hideError. See the upgrade guide (#5324, #3684)
  • BREAKING CHANGE: Fix CheckboxesWidget flagging its CheckboxGroup invalid whenever a required field was empty, before validation and despite ui:hideError; it now follows the field's visible errors, which mark every checkbox aria-invalid. See the upgrade guide (#5324, #3684)
  • BREAKING CHANGE: Change the default Form export to a ThemedForm generic over the form data, and keep each component's own generic type in the Theme, Templates and Widgets exports instead of any; generateForm() returns a ThemedForm<T, S, F> and the other generators default to unknown. See the upgrade guide (#5311)
  • Fix RadioWidget's and CheckboxesWidget's object options, and make SelectWidget report its form data value on focus and blur and offer an empty string option in the realValue format (#5350, #5317)
  • Fix realValue options whose String() matches, such as 1 and '1', sharing a DOM value (#5400, #5315)
  • Fix AltDateWidget rendering no hour, minute or second selects for alt-datetime, emitting a date-only value, and letting its Now and Clear buttons change a readonly field, or a disabled one rendered by a custom FieldTemplate (#5410)
  • Fix UpDownWidget reporting '' rather than undefined to onFocus/onBlur when an increment or decrement trigger is focused (#5379)
  • BREAKING CHANGE: Fix AltDateWidget's date parts having no accessible name: each select is named by the label, even a hidden one, and its part, such as When, year, and described by the field's description, help and errors. See the upgrade guide (#5418, #5355, #5357)
  • Change SelectWidget to put its aria-label and aria-describedby on its trigger rather than its root (#5418, #5355, #5357)
  • Change getChakra() to return JsxStyleProps instead of Field.RootProps, so Fieldset.Root and Field.Root both accept it; reading a non-style member off the result, which was always undefined, no longer compiles (#5488)
  • BREAKING CHANGE: Fix the chakra option never reaching a widget: widgets now apply it, including a chakra set through ui:globalOptions or ui:chakra. See the upgrade guide (#5488)
  • BREAKING CHANGE: Change getChakra() to take the widget's merged options instead of a uiSchema. See the upgrade guide (#5488)
  • BREAKING CHANGE: Change the chakra option of the theme's UiSchema type to JsxStyleProps, so a non-style prop such as invalid or onClick in the root's ui:options no longer compiles. See the upgrade guide (#5488)
  • Fix getChakra() dropping Chakra style props that share a name with an HTML attribute, such as color, width, height and display, and remove the @emotion/is-prop-valid dependency (#5488)
  • Change the widgets to draw their own label, CheckboxWidget its description too, and name an anyOf/oneOf field by its option selector; WrapIfAdditionalTemplate labels the key through hasAdditionalKeyLabel() (#5531, #5545, #5490)
  • Fix FieldHelpTemplate repeating the field's id for an anyOf/oneOf option's own ui:help (#5531, #5490)
  • Fix the fallback UI's value having no label: the theme declares FallbackField as drawing its own label (#5531, #5490)
  • Fix CheckboxWidget carrying the native required attribute where the schema doesn't demand true, so a required boolean left unchecked now submits as false (#5531, #5388, #5490)
  • Fix SelectWidget's trigger missing the plan's aria-labelledby, so an object's option selector is now named by the object's heading (#5531, #5490)
  • Fix an anyOf/oneOf option's control not being styled invalid in any widget while the field above draws its errors, and CheckboxWidget's box never being styled invalid (#5545, #5490)
  • Change the widgets to put aria-invalid and only the descriptions that render on the element a user focuses: BaseInputTemplate's, TextareaWidget's, UpDownWidget's and CheckboxWidget's input, RangeWidget's thumb, each option, RadioWidget's radiogroup and NativeSelectWidget (#5545, #5490)
  • Fix RadioWidget ignoring ui:autofocus (#5545, #5490)
  • Fix RadioWidget's radiogroup being named by the field's description or an id no element had: it is named by the label it draws, by the plan's aria-label under ui:label: false, or left unnamed, and draws no label holding only a required field's * (#5545, #5490)
  • Fix FieldTemplate drawing no label for RatingWidget, AltDateWidget, AltDateTimeWidget and other widgets that leave it the label; a widget of your own under those keys that draws its own should be declared label: 'self' (#5545, #5388, #5490)
  • BREAKING CHANGE: Change TitleField to put its title id on a <span> around the title's text, with a required heading's * outside it, so a selector or style targeting #…__title now targets the <span> inside the <h5>. See the upgrade guide (#5545, #5490)
  • Fix ArrayFieldTemplate drawing the ui:title an anyOf/oneOf option repeats a second time, and dropping an optional array's data control where it draws no heading, as under ui:label: false (#5531, #5490)
  • Fix MultiSchemaFieldTemplate rendering an empty <div> for a selector it isn't given, as while an optional anyOf/oneOf field has no data (#5543, #5401, #5490)
  • Fix FieldErrorTemplate repeating errorId() for each message of a field with several errors; it renders them in one element, each on its own line (#5545, #5490)
  • Fix ObjectFieldTemplate dropping the optional data control where it draws no heading, as under ui:label: false, and rendering an empty grid item where there is no control (#5531, #5490)
  • Fix SelectWidget rendering its select's control twice, so select:<id>:control appeared twice on the page (#5545, #5490)
  • Fix FieldTemplate's fieldset pointing aria-labelledby at a legend that renders only for a description, so a control or group named by the template's label is no longer announced inside a fieldset of the same name (#5545, #5490)
  • BREAKING CHANGE: Change every widget's control to be named by its label and carry the field's id on the element a user focuses, and a radio group's or slider's label to have no for; selectors aimed at Ark's generated ids, such as select:root_color:trigger, should aim at the field's id. See the upgrade guide (#5545, #5490)
  • BREAKING CHANGE: Change radio and checkbox <input>s to take their optionId(), so focusOnFirstError reaches them. See the upgrade guide (#5545, #5490)
  • Fix RangeWidget's thumb ignoring ui:autofocus (#5545, #5490)
  • Fix RangeWidget's label missing its required *, its dimming for a disabled or read-only field and its invalid state while errors show, as UpDownWidget's has them (#5545, #5490)
  • Fix CheckboxesWidget's fieldset pointing aria-labelledby at an id no element has when it draws no label; the group carrying the field's id is named by its label, drawn outside a <legend> so the name is announced once (#5545, #5490)
  • Fix AltDateWidget's and AltDateTimeWidget's label for naming an id no element had: the date parts' fieldset is named by the label, and each part is described by the field and aria-invalid while errors show (#5545, #5542, #5490)
  • Fix CheckboxWidget's input pointing aria-labelledby at a label that isn't rendered (#5545, #5542, #5490)
  • Fix RangeWidget and UpDownWidget submitting under the field's id rather than htmlName, and CheckboxesWidget ignoring ui:autofocus; TitleField's required marker carries chakra-field__requiredIndicator and the field recipe's style, as a label's does (#5545, #5490)
  • Fix SelectWidget and RangeWidget beneath a radio option selector repeating the field's label id, WrapIfAdditionalTemplate's key select and input being unnamed under ui:label: false, and NativeSelectWidget having no name; it now takes htmlName (#5545, #5490)
  • Fix SelectWidget's trigger and listbox being unnamed where no label names them: they take the field's label, placeholder or translated prompt, and a click on the label focuses the trigger instead of opening the listbox (#5545, #5490)
  • Fix CheckboxWidget not falling back to the schema description for an empty ui:description (#5545, #5490)
  • Fix RadioWidget's group not being required and CheckboxesWidget's label missing a required * (#5545, #5490)
  • Fix SelectWidget, UpDownWidget, CheckboxWidget and AltDateWidget's first date part ignoring ui:autofocus (#5545, #5490)
  • Fix a click on RadioWidget's or RangeWidget's label not focusing a radio or the thumb (#5545, #5490)
  • Fix AltDateWidget's Now and Clear buttons staying enabled when the field is disabled (#5545, #5490)
  • Fix UpDownWidget showing a stored 0 as empty, and showing the old number again after the form clears or resets it (#5563)
  • Fix UpDownWidget reporting a change, which ran onChange and live validation, when it loses focus or takes Enter without being edited (#5563)
  • Fix UpDownWidget clamping a number past ±Number.MAX_SAFE_INTEGER to that bound on blur, which reported a change nobody made (#5563)
  • Change the theme to declare where its widgets draw their own label, labelPlacement: 'above' for every widget and selector and 'beside' for the checkbox, so a custom ArrayFieldItemTemplate gets displayLabel: true for an item whose widget draws its label above it (#5538)
  • BREAKING CHANGE: Change AltDateWidget to hand an unset date part on as undefined rather than '', as useAltDateWidgetProps() now returns it, so a custom SelectWidget, onFocus and onBlur see undefined. See the upgrade guide (#5604, #5378)
  • Add chakra as the theme's globalUiOptionsKeys, so a chakra in ui:globalOptions reaches every widget's options, a custom widget's included; the theme's UiSchema type types it and takes a UserExtensions parameter, and ChakraGlobalUISchemaOptions is exported (#5611, #5607)
  • Fix ObjectFieldTemplate showing no add button for an object naming no additionalProperties in a form whose additionalPropertiesWhenAbsent is 'allow' (#5620, #2137)
  • Change FieldTemplate to set its fieldset's invalid state from the field's own errors, the hasErrors prop, so an anyOf/oneOf option follows its own ui:hideError (#5646)
  • Add aria-invalid and a description by its row's errors to WrapIfAdditionalTemplate's key input, the free-text one and the propertyNames select alike, while the object forbids that key (#5640, #4630)
  • Add the keyNotAllowed prop FieldTemplate hands WrapIfAdditionalTemplate; a custom WrapIfAdditionalTemplate that spreads its leftover props onto an element should leave it out (#5640, #4630)
  • BREAKING CHANGE: Change an additional property's key input id to root_foo__key from root_foo-key, built by the new additionalKeyId(). See the upgrade guide (#5626)
  • Change __createChakraFrameProvider to take { children: ReactNode } rather than any and its returned component to take { document?: Document }, and to throw an error saying it must be rendered inside a frame that provides a document rather than failing on document.head (#5410)
  • Fix ObjectFieldTemplate leaving an empty grid cell for a property hidden by deprecatedHandling: 'hide' or a ui:definitions hidden widget (#5617, fixes #5507)
  • BREAKING CHANGE: Change GridTemplate to read a column's span as its colSpan unless it has a colSpan of its own, logging a warning that its span is ignored, and to lay a ui:row without templateColumns, templateAreas, gridTemplate or grid, as a prop or in its style or css, out on 12 tracks, each child full width unless it spans fewer, and warn about a column span that isn't a whole number. See the upgrade guide (#5707, #5651)
  • Fix NativeSelectWidget leaving a select no label names, such as an untitled root or array item select, without an accessible name; it is named by its ui:placeholder, else TranslatableString.SelectPlaceholder ("Select ...") (#5713, #5711)
  • Fix RadioWidget leaving a radiogroup no label names, such as an untitled field's, without an accessible name; it is named by its ui:placeholder, else TranslatableString.RadioGroupName ("Choose an option") (#5713, #5586)
  • Fix renaming an additionalProperties key remounting its field, which lost what its widget held, such as an alt-date's partly picked date (#5733, #5595)
  • Fix the text input rendering a stray 0 beside it when its value is 0 and allowClearTextInputs is set (#5682)
  • Change a text input holding false to show that value and offer the clear button for it, where it was empty (#5682)
  • Change an empty RangeWidget to leave its name out of a native form submit, and to commit its minimum when a press or a key leaves the thumb there (#5682)
  • Fix RangeWidget writing a number into a string field, which then failed validation: it now writes a numeric string, as core's range input does (#5682)
  • BREAKING CHANGE: Change the alt-date and alt-datetime widgets to show a number or Date value as empty, where they showed that date, since they can only write a string back. See the upgrade guide (#5682)
  • Fix BaseInputTemplate dropping a pattern, inputMode, accept or multiple a widget passes it as a prop, so the file input of an array took one file at a time (#5684)
  • Fix WrapIfAdditionalTemplate leaving the key input and the remove button enabled for a property it is handed no rename or remove callback for, such as the root (#5684)
  • BREAKING CHANGE: Change AltDateWidget to show the default years for a yearsRange reaching before 100, such as [50, 2030], where it offered that range and wrote a year before 100 as 19xx. See the upgrade guide (#5685)
  • Fix RangeWidget for an Ajv $data reference in minimum, maximum or multipleOf, which set the range's bound or step to the object and now leaves it at its default, and read a numeric-string bound such as minimum: '5' as its number (#5688)
  • BREAKING CHANGE: Change WrapIfAdditionalTemplate to read ADDITIONAL_PROPERTY_FLAG by its truth rather than its presence, so a schema with it set to undefined or false renders as a plain field, with no key input or remove button. See the upgrade guide (#5689)
  • BREAKING CHANGE: Fix a required anyOf/oneOf field showing no * with a null or untitled object option selected, or one on the option rather than the field: the selector's label is marked now, and the option's isn't, though its control stays required. A custom widget drawing its own label marks it from templateMarksRequired(). See the upgrade guide (#5743, #5573)
  • BREAKING CHANGE: Fix CheckboxesWidget giving a screen reader no cue that a checked box is required: a required group whose minItems is at least 1, or with ui:required: true, is now named with "required", and a required group with neither, which submits [], no longer shows a *. See the upgrade guide (#5743, #5573)
  • Fix RangeWidget reporting no value to the form's onFocus and onBlur (#5752, #5600)
  • Fix CheckboxWidget's aria-describedby listing its description before the field's help, which FieldTemplate draws above the checkbox (#5794, #5720)
  • BREAKING CHANGE: Change ObjectFieldTemplate to render an object's title, description and contents inside a div with role="group" carrying the field's id, named by the title and described by the field's errors, description and help. See the upgrade guide (#5795, #5723)
  • BREAKING CHANGE: Change ArrayFieldTemplate to give the element around an array's title, description and items role="group" and the field's id, named by the title and described by the field's errors, description and help. See the upgrade guide (#5795, #5723)
  • BREAKING CHANGE: Fix a required multiple SelectWidget blocking a submit of the [] its schema accepts: an array rendered as one widget holding [] is now required, and shows a *, only where its minItems is at least 1 or ui:required: true asks for it. See the upgrade guide (#5822, #5744)
  • Add support for importing and rendering Form from a React Server Component, such as a Next.js App Router page, without wrapping it in a 'use client' module of your own (#5863, #5761)
  • Fix FieldErrorTemplate drawing an empty item for an empty error message (#5882, #5603)
  • BREAKING CHANGE: Change AddButton to an icon button titled Add Item, without its visible Add Item text, and ObjectFieldTemplate to title an expandable object's Add button after the object's title or name, such as Add Address. See the upgrade guide (#5899, #3596)

@rjsf/core

  • BREAKING CHANGE: Change GridType and Operators from enums to as const objects with same-named union types, exported from the package root now that deep imports are removed; values and GridType.ROW access are unchanged, but a member used as a type must be written typeof GridType.ROW. See the upgrade guide (#5244, #5674, #5599)
  • BREAKING CHANGE: Change withTheme() to return a plain function component instead of a forwardRef-wrapped one. See the upgrade guide (#5260, #5266)
  • BREAKING CHANGE: Change FormProps['onSubmit']'s event type to SubmitEvent<HTMLFormElement> instead of FormEvent<any>. See the upgrade guide (#5260, #5266)
  • BREAKING CHANGE: Remove the deprecated Form methods getUsedFormData(), getFieldNames() and omitExtraData() (use SchemaUtils.omitExtraData()). See the upgrade guide (#5262)
  • BREAKING CHANGE: Remove the deprecated removeEmptyOptionalObjects prop. See the upgrade guide (#5262)
  • BREAKING CHANGE: Remove boolean liveValidate/liveOmit values (use 'onChange'). See the upgrade guide (#5262)
  • BREAKING CHANGE: Remove the deprecated ui:rootFieldId directive (use idPrefix). See the upgrade guide (#5262)
  • BREAKING CHANGE: Change the extraErrorsBlockSubmit prop to extraErrorsAreWarnings: extraErrors now block submission unless extraErrorsAreWarnings is true. See the upgrade guide (#5268, #4964)
  • Fix a customError a field or widget raises through onChange being dropped on submit; it now blocks submission like schema errors do (#5268, #5438)
  • BREAKING CHANGE: Remove the private _internalFormWrapper prop from FormProps and ThemeProps; use tagName to render another element in place of <form>. See the upgrade guide (#5271)
  • BREAKING CHANGE: Remove the experimental_ prefix from FormProps: experimental_defaultFormStateBehavior is now defaultFormStateBehavior and experimental_customMergeAllOf is now customMergeAllOf. See the upgrade guide (#5267)
  • BREAKING CHANGE: Change getTestRegistry() to be exported from the @rjsf/core/testing entry point, the only one that needs @rjsf/validator-ajv8, now an optional peer dependency. See the upgrade guide (#5272)
  • BREAKING CHANGE: Change TimeWidget and DateTimeWidget to write a format: "time"/"date-time" value with seconds and the browser's UTC offset (14:30:00-04:00, not 14:30), as RFC 3339 requires; iso-time/iso-date-time get seconds but no offset. See the upgrade guide (#5270, #3930)
  • BREAKING CHANGE: Remove getDefaultRegistry(); use the new generateTheme(), generateFields(), generateWidgets(), generateTemplates() or generateButtonTemplates(), or import one of the newly exported components directly. See the upgrade guide (#5266)
  • BREAKING CHANGE: Change the Form.getRegistry() static to a buildRegistry() export from @rjsf/core taking the same arguments. See the upgrade guide (#5266)
  • BREAKING CHANGE: Change the data parameter of the onBlur and onFocus props from any to unknown, so a handler that types it (e.g. value: string) needs a type guard. See the upgrade guide (#5266)
  • BREAKING CHANGE: Change markdown to opt-in: Form renders plain text unless you register templates.MarkdownTemplate from @rjsf/core/markdown, and markdown-to-jsx is now an optional peer. See the upgrade guide (#5263)
  • BREAKING CHANGE: Change markdown rendering to no longer parse raw HTML. See the upgrade guide (#5263)
  • BREAKING CHANGE: Change FileWidget's file information to follow ui:enableMarkdownInDescription. See the upgrade guide (#5263)
  • BREAKING CHANGE: Remove RichDescription.TEST_IDS and RichHelp.TEST_IDS; use MarkdownTemplate.TEST_IDS.markdown from @rjsf/core/markdown. Add MarkdownTemplate to @rjsf/core's component exports. See the upgrade guide (#5263)
  • Fix ui:placeholder being ignored on multi-select arrays, file arrays, custom array widgets and boolean fields (#5285)
  • Fix a ui:FieldTemplate or ui:FieldErrorTemplate override being ignored on a LayoutMultiSchemaField (#5285)
  • Fix FileWidget wiping the selection when a picker re-fires change with an empty file list after its dialog is cancelled; useFileWidgetProps now reads an empty selection as a cleared value (#5285)
  • BREAKING CHANGE: Change fields, widgets and templates to identify a field by a fieldPath string (friends[0].firstName) and an id instead of fieldPathId, which FieldProps['onChange'], childFieldPathId and IChangeEvent drop. See the upgrade guide (#5280, #5217)
  • BREAKING CHANGE: Change IChangeEvent to a standalone interface with every member readonly and formData typed EventFormData<T>; copy the event's formData into your own state instead of assigning into the event. See the upgrade guide (#5298, #5311)
  • Change Form to apply ui:emptyValue and ui:initialValue to its defaults, a new array row, an added property and the properties an item of an array's default leaves out included, and to enforce ui:required: true wherever the field renders, on submit and in live validation alike, with precompiled validators too, counting [] on a group of checkboxes as no answer and reading the anyOf/oneOf option shown and any option inside it, whose ui:required defaults to the field's, and to mark a checkbox it asks of, with aria-required, while it holds no value (#5277, #5743, #5870, #5898, #4983, #5573, #5918, #5894)
  • Change SchemaField and LayoutGridField to take a field's required state from its own ui:required, not ui:globalOptions or a grid cell's config (#5277, #5344, #4983)
  • Add a one-time warning when a falsy ui:required, such as false or null, makes a schema-required field optional without ui:initialValue or ui:emptyValue (#5277, #5379, #4983)
  • Add CoreUiOptionsChecks, describing @rjsf/core's built-in widgets, fields and ui:options, to pass as StrictUiSchema's Checks type argument (#5275, #5372, #4916, #5726, #5610, #5742, #5392)
  • BREAKING CHANGE: Remove the experimental_componentUpdateStrategy prop: Form and SchemaField compare props shallowly, so function props such as customValidate, templates and formContext must be stable references. See the upgrade guide (#5297, #5438, #5217)
  • BREAKING CHANGE: Change the formData passed to onChange and the other callbacks to share unchanged subtrees with the previous value, the formData you passed included; treat it as immutable. See the upgrade guide (#5297, #5556, #5217)
  • Change Form and LayoutGridField to keep unchanged state and uiSchema references, so typing in one field re-renders no sibling (#5297, #5217)
  • Fix a oneOf/anyOf of constants with no type rendering as an unsupported field; it now renders a select, inferring the type from the constants (boolean constants keep boolean and default ui:widget to select) (#5305, #4666)
  • BREAKING CHANGE: Fix BooleanField ignoring a constant anyOf and falling back to plain Yes/No options; a boolean with constant options under both anyOf and oneOf now shows the anyOf titles. See the upgrade guide (#5305, #4666)
  • Fix BooleanField labelling every non-true constant No, so an untitled oneOf of null, true and false showed null and false alike (#5305, #4666)
  • Fix NumberField dropping a leading sign while typing, so -0.5, -0, +5 and -.5 are no longer rewritten mid-typing; a lone -. now resolves to -0 (#5303, #4038)
  • Change BaseInputTemplate to render a number/integer field as <input type="text"> with a numeric inputMode, pattern and title instead of <input type="number">, without step, min or max; a widget's own pattern or inputMode still wins (#5303, #4038)
  • Add ui:options.optgroups to group SelectWidget options under <optgroup>s; a multiple select still reports its values in enum order (#5301, #1813, #580)
  • Add a dropdown for an additionalProperties/patternProperties key when propertyNames enumerates the allowed names, leaving out names already used; the add button takes the first free name, preferring one a field can be rendered for and the schema doesn't forbid, and hides once all are taken. WrapIfAdditionalTemplate gets a propertyNamesEnum prop (#5321, #5429, #4682, #5330)
  • Add a keyName prop to FieldTemplate, from which WrapIfAdditionalTemplate now reads an additional property's key instead of the label (#5321, #4682)
  • Fix MultiSchemaField's option selector and ArrayField's multi-select and file widgets showing their error state under ui:hideError; ArrayField and ObjectField now also pass hideError to their templates (#5324, #3684)
  • BREAKING CHANGE: Fix LayoutMultiSchemaField passing its FieldTemplate neither rawErrors nor hideError, so a layout grid field's label and control now get error styling and a custom FieldTemplate can tell errors are hidden. See the upgrade guide (#5324, #5406, #5327, #3684)
  • Add errorSchema to FieldTemplateProps, holding all the field's errors even under ui:hideError, so a template that renders errors itself can reach them (#5324, #5606, #3684)
  • Fix a custom ArrayFieldTemplate receiving no errorSchema for an ordinary (non-tuple) array (#5324, #3684)
  • Fix a schema allowing several types (type: ['string', 'number']), or an unconstrained additionalProperties entry, being stuck on one type: with useFallbackUiForUnsupportedType on, SchemaField renders FallbackField, whose type selector offers the allowed types (#5323, #5238)
  • Change FallbackField's type selector to offer integer and null and start on the current data's type (#5323, #5238)
  • Change FallbackField to convert the value on a type switch without inventing data: a value with no reading in the new type clears instead of becoming 0 or [object Object], a boolean array item or additionalProperties entry becomes false, and old errors clear (#5323, #5804, #5238)
  • Fix FallbackField's value field dropping the schema's other keywords (properties, items, format, minimum…) and crashing on a ui:widget the chosen type has no widget for (#5323, #5238)
  • Fix FallbackField rendering its label or help twice and marking its type selector required (#5323, #5238)
  • Fix FallbackField falling out of step with the allowed types or outside data, and its value field losing focus on each change (#5323, #5238)
  • Fix a schema pairing several types with an anyOf/oneOf keeping the options on the first type: FallbackField now renders the option selector within the type selector, dropping it when null is chosen; a list with an option naming its own type has that type selector only within options naming none (#5323, #5724, #5238, #5390)
  • Fix the fallback UI renaming an untitled multi-type property Value, and an object or boolean union losing its title and description (#5323)
  • Change FallbackField to let a ui:widget given as a component render a multi-type union itself, as a ui:field does, instead of wrapping it in a type selector (#5323)
  • Fix FallbackField's type selector leaving the type it is on when the user clears an additionalProperties entry or array item, clears it to its ui:emptyValue, or picks a type that clears it (#5323, #5804, #5784)
  • Change FallbackField to build its schemas and uiSchema only when useFallbackUiForUnsupportedType is on (#5323)
  • Fix a multi-type union with an anyOf/oneOf that renders as optional data controls showing its label before it has data, unlike the same anyOf without the union (#5323)
  • Fix the fallback UI's type selector showing a Type label when ui:options.label is false (#5323)
  • Change a ui:widget given as a component to render within the type selector for a schema with no type of its own (an unrecognized type or an unconstrained additionalProperties entry), rather than replacing it as for a union (#5323)
  • BREAKING CHANGE: Change clearing a custom error a field raised through onChange(value, path, errorSchema) to also remove it from the ErrorListTemplate, where it stayed until the next validation. See the upgrade guide (#5312)
  • BREAKING CHANGE: Change noValidate to also turn off liveValidate='onBlur', which used to validate and show errors regardless. See the upgrade guide (#5312)
  • Remove Form's internal getStateFromProps() method, which was never part of FormRef (#5438)
  • Fix extraErrors and a field's custom errors being added to the error list again on every change that raises a custom error while validation errors show (#5312, #5041)
  • Fix a later extraErrors change bringing back the previous schema's validation errors after the schema changed or noValidate was set (#5312)
  • Fix live validation of data replaced from outside, or re-run for a changed validation callback, showing different errors than typing the same value would (#5312, #5556)
  • BREAKING CHANGE: Change FormRef.validate() to take only the form data, and drop FormRef's S and F type parameters; to validate against another schema, call schemaUtils.getValidator().validateFormData(). See the upgrade guide (#5312, #5438)
  • Fix the ErrorList and the onChange payload keeping an error the changed field no longer showed when new props were applied without live validation (#5341)
  • Fix an ErrorSchema a field raises through onChange being lost on a path with a validator error: it replaces the validator's errors below that path, {} clears them, and it is not listed twice with extraErrors (#5341, #5556)
  • Fix ArrayField adding, copying, moving or removing an item dropping the array's own errors, such as minItems (#5341)
  • Fix an additional property added from outside the form after mount not rendering (#5339)
  • Fix a field edit being dropped when the form data root is null or undefined; it now creates the object or array the field lives in (#5339)
  • BREAKING CHANGE: Remove edit from IChangeEvent; it only restated whether you passed formData or initialFormData, so check your own props. See the upgrade guide (#5339)
  • Fix a throwing customValidate, onChange, onSubmit or onError taking the form down: the error comes out of the FormRef call or event that caused it, or is reported as uncaught for a field's change, blur or focus (#5438)
  • BREAKING CHANGE: Change the T generic's default to unknown and F's to FormContextType: a handler with no type argument gets unknown form data, so pass a type to Form or IChangeEvent, or pass formData for Form to infer it. See the upgrade guide (#5311, #5438)
  • BREAKING CHANGE: Change withTheme() to return the new ThemedForm<T, S, F> type, a component generic over its form data like Form, instead of ComponentType<FormProps<T, S, F>>; statics such as displayName leave the returned type. See the upgrade guide (#5311)
  • BREAKING CHANGE: Change IChangeEvent.formData to a required member typed EventFormData<T>, which FormRef.getFormData() also returns: T for an object or array root, T | undefined for a scalar. See the upgrade guide (#5311, #5438, #5556)
  • BREAKING CHANGE: Change withTheme() to use only the theme's fields, widgets and templates, ignoring other props such as noHtml5Validate; pass those to the themed Form. See the upgrade guide (#5311)
  • Change FormRef.setFieldValue() to take the field's value as unknown instead of T, so a typed form's ref can set a field (#5311, #5438)
  • Change SchemaField and MultiSchemaField to log each uiSchema misconfiguration warning once per page instead of on every render, naming the field by its id and fieldPath (#5344, #3051)
  • Fix a FieldTemplate that checks rawHelp dropping a ui:help given as a React element; SchemaField now passes it as rawHelp (#5351, #5326)
  • Fix a ui:help on a layout grid's discriminated oneOf/anyOf cell not rendering in any theme (#5351, #5606, #5326)
  • Change ObjectField and ArrayField to share one frozen empty uiSchema when none is passed, so a custom ObjectFieldTemplate or ArrayFieldTemplate writing to it now throws a TypeError (#5366)
  • Fix a re-render that only rebuilt validator or customMergeAllOf resetting data the user cleared or switched to its default; a real validator change now needs a new key (#5376, #5556, #5294)
  • Fix liveValidate: 'onBlur' showing errors before any blur when the form data was replaced from outside, and merging every extraErrors entry in twice there (#5376)
  • Fix live validation dropping every extraErrors entry when the form data was replaced from outside (#5376, #5556)
  • Fix extraErrors and customErrors being duplicated when a re-render under liveValidate: 'onChange' changed only props such as className (#5376, #4408)
  • Fix live validation running against the old schema after validator, customMergeAllOf or defaultFormStateBehavior changed (#5376)
  • Change ObjectField to pass the object's own errors to ObjectFieldTemplate as rawErrors, as ArrayField does (#5354, #5332)
  • Change SchemaField to stop passing a field's own errors as rawErrors to the field beside a oneOf/anyOf selector, which shows them, while an ArrayField there still keeps them as it changes items; MultiSchemaField passes the field's id to MultiSchemaFieldTemplate (#5354, #5332)
  • BREAKING CHANGE: Change a schema with both anyOf and oneOf to render from its anyOf, and a select over object or array constants to render through StringField. See the upgrade guide (#5350, #5309, #5317)
  • Fix OptionalDataControlsField's Add button storing {} instead of [] for an anyOf/oneOf whose options are all arrays (#5361, #5316)
  • Fix a $id naming FallbackField replacing a non-select anyOf/oneOf with an unsupported-field box while useFallbackUiForUnsupportedType is off; the option selector renders instead (#5362, #5333)
  • Fix ui:fieldReplacesAnyOrOneOf hiding the anyOf/oneOf options for a ui:field that resolves to FallbackField or to no registered field, where an object union rendered nothing (#5362, #5333)
  • Fix a ui:field resolving to FallbackField exhausting the browser's memory; it renders one type selector over one value field (#5362, #5538, #5611, #5333)
  • Fix the fallback UI's type selector offering all seven types for a schema whose type, enum or const narrows them (#5362, #5333)
  • Change the fallback UI to render a schema allowing a single type as the plain field for that type, without a type selector or the FallbackFieldTemplate wrapper's blank row (#5362, #5611, #5333)
  • Fix a ui:field or $id naming FallbackField wrapping a typeless non-select anyOf/oneOf in a selector of all seven types, where switching type changed nothing on screen but cast the value away (#5362, #5333)
  • Fix a schema that only implies its type, such as properties with no type, reached through a ui:field or $id naming FallbackField, rendering a selector of all seven types or nothing instead of its properties; getSchemaOwnTypes() now agrees with getSchemaType() (#5362, #5611, #5333)
  • Fix a ui:field that replaces the anyOf/oneOf options being rendered again inside each option that has no uiSchema of its own (#5362, #5333)
  • Fix a schema whose only allowed type is null, such as ['foo', 'null'] beside an anyOf, rendering neither its options nor a field for them with the fallback UI on (#5362, #5333)
  • Fix realValue options with the same String(), such as 1 and '1', sharing a DOM value, and the examples <datalist> rendering duplicate keys, suggesting null, object or array values, or rendering when empty (#5400, #5315)
  • BREAKING CHANGE: Change BooleanField to label boolean enum values ui:enumNames doesn't name Yes/No, and apply ui:enumNames only to enum values. See the upgrade guide (#5364, #5636, #5727, #5319)
  • Change BooleanField to apply ui:enumOrder to its Yes/No options (#5364, #5636, #5319)
  • Change BooleanField to keep a constant option's empty title (#5364, #5636, #5319)
  • Fix the formData handed to customValidate ignoring the form's customMergeAllOf and defaultFormStateBehavior when computing defaults (#5340, #4385)
  • BREAKING CHANGE: Fix a layout grid's discriminated oneOf/anyOf cell missing its FieldTemplate props: it gets the rjsf-field* and ui:classNames classes and ui:style, which its selector no longer gets, honors ui:widget: 'hidden' and renders its description. See the upgrade guide (#5406, #5327)
  • Add getFieldClassNames() and omitConsumedStyling(), which SchemaField uses for its FieldTemplate's classes and styling, so a custom field rendering its own FieldTemplate can match the rjsf-field* contract (#5406, #5606, #5327)
  • BREAKING CHANGE: Change a layout grid's discriminated oneOf/anyOf cell to honor ui:disabled, in both directions, and a deprecated schema like any other field, through the new getDeprecatedHandling(). See the upgrade guide (#5606, #5327)
  • Fix IconButton putting a React element icon into a glyphicon-[object Object] class name instead of rendering it (#5382)
  • Fix a new additionalProperties entry with an integer or nullable type list (['number', 'null']…) defaulting to the string New Value instead of 0 or false (#5379, #5428)
  • Change RichDescription and RichHelp to pass a frozen empty uiSchema to MarkdownTemplate when none is passed, so a custom MarkdownTemplate writing to it now throws a TypeError (#5379)
  • Fix a non-boolean falsy ui:label, such as 0 or null, not hiding an object field's title and description or the fallback UI's type selector label (#5379)
  • Fix a precompiled form throwing in MultiSchemaField when transformChange refuses or rewrites an option switch, and read a then beside the kept option as adding to it rather than overriding its keywords. See the upgrade guide (#5371, #5536, #5556, #5338, #5373)
  • Fix a ui:field or LayoutGridField cell render given as a memo(), forwardRef() or lazy() component not rendering. One that isn't a usable component now logs a warning, once per uiSchema entry however many items or extra keys it reaches, and its field renders as if no ui:field were given; null or false still opts the field out (#5433, #5611, #5823, #5363, #5658)
  • Fix a type list of three or more entries starting with null, such as ['null', 'string', 'number'], rendering NullField: it renders the field of its first non-null type, or of another listed type when only that one has the field's widget, such as StringField for a textarea (#5428, #5331)
  • Change the type selector of useFallbackUiForUnsupportedType to start a type list holding no value on the type its ui:widget renders, and a value of an unlisted type on a type whose field can show it, and fix a global widget the selected type lacks throwing No widget (#5428, #5331)
  • Fix a fixed-items ArrayField throwing Cannot read properties of null for a null held by a type list such as ['null', 'array'] (#5428, #5331)
  • Fix adding a property to an ObjectField holding a string, as a type list such as ['null', 'object', 'string'] allows, spreading the string's characters into the new object (#5428, #5331)
  • Change a new additionalProperties entry under an enum or a constant anyOf/oneOf to start on the first option not in ui:enumDisabled unless its type's default is such an option, so enum: ['a', 'b'] starts at 'a' rather than New Value (#5428, #5331)
  • Fix checking an option of a multi-select ArrayField holding null, as a type list such as ['null', 'array'] allows, writing the null into the array beside the checked option (#5428, #5331)
  • Fix ObjectField seeding a new property with null, which only a null field can render: it now seeds from the subschema that renders it (a matching patternProperties, additionalProperties or unevaluatedProperties), honoring its const, default and type (#5429, #5330)
  • Change ObjectField to seed null for a name an unevaluatedProperties: false or a matching false patternProperties subschema forbids, as it did for additionalProperties: false (#5429, #5330)
  • BREAKING CHANGE: Change ObjectField to seed a new property from an additionalProperties with a $ref beside other keywords by layering those keywords over the referenced schema rather than discarding them, so { type: 'string', $ref: '#/definitions/aNumber' } seeds a string. See the upgrade guide (#5429, #5330)
  • Fix ObjectField not rendering the data's extra keys, nor offering the add button, for an object whose only keyword describing them is unevaluatedProperties (#5429, #5330)
  • Fix ObjectField leaving New Value in a field that can't show it when a new, unedited property is renamed onto a name another subschema describes, such as a numeric pattern (#5429, #5481, #5330)
  • Fix ObjectField settling an if inside a new property's subschema against an empty object rather than the default the property is about to hold (#5429, #5330)
  • Fix FallbackField silencing an unevaluatedProperties: false on a union-typed object and offering an add button for keys the schema forbids (#5429, #5330)
  • BREAKING CHANGE: Change Form to a function component: type its ref as FormRef<T> and read data through its methods or the event rather than state, setState() or formElement. See the upgrade guide (#5438, #5556)
  • BREAKING CHANGE: Change Form to apply each edit as it is made: onChange now runs before the inputs show the value, and a later edit in the same event builds on the one before. This also undoes some of 6.11.1's change handling. See the upgrade guide (#5438, #5556, #5750, #5748)
  • BREAKING CHANGE: Change the react peer dependency floor from >=19 to >=19.2, the release that added <Activity>, whose hidden content Form treats as unmounted. See the upgrade guide (#5438, #5556)
  • Fix a dependencies or if/then/else swap keeping the old branch's default for an object- or array-typed property: the new subschema's default now replaces a value still equal to the old one, while an edited value is kept (#5464, #5537, #5349)
  • Fix setFieldValue('', data) on a form that isn't live-validated keeping the errors of a replaced root string, number or array or a root that changed type, and a root object's own errors, such as minProperties, staying after a property changes (#5469, #5034)
  • BREAKING CHANGE: Change an error a field raises through onChange to be kept apart from the validator's errors, so it survives a parent passing formData back and the next validation, and an empty raise clears it. See the upgrade guide (#5470, #5556, #5347, #5348)
  • BREAKING CHANGE: Change the errorSchema a field passes to onChange to hold only the errors it raises, so one matching an extraErrors message survives clearing extraErrors. See the upgrade guide (#5471, #5348)
  • Fix a field's raised errors staying behind when ArrayField items move, optional data or an additional property is removed or renamed, or an option switches, so a stale raise no longer blocks submit (#5471, #5348)
  • Fix a field's raised error not showing at once under noValidate (#5471, #5348)
  • Fix Form listing an extraErrors message twice, in the ErrorList, on its field and in the errors passed to onError and onChange, when the validator reports the same message at the same path (#5443, #5442)
  • Fix DateTimeWidget showing 0 as empty, true as a 1970 date, and crashing on a value Date can't convert; an invalid date, text that isn't a date or a year before 1 now gives an empty input (#5473, #5431)
  • BREAKING CHANGE: Fix AltDateWidget's date parts having no accessible name: each select is named by the field's label and part, such as When, year, and described by its description, help and errors. See the upgrade guide (#5418, #5355, #5357)
  • Fix SelectWidget not passing its aria-label and aria-describedby to its <select> (#5418, #5355, #5357)
  • Fix AnyOfField committing an option that no longer describes changed data for a render, and a ui:title of null hiding the schema title of a field or option label; AnyOfField, LayoutMultiSchemaField and FallbackField no longer opt out of the React Compiler (#5482)
  • Change SchemaField to memoize the retrieved anyOf/oneOf options and uiOptions, so a re-render changing neither schema nor data no longer makes AnyOfField and OneOfField retrieve every option again (#5482)
  • BREAKING CHANGE: Change AnyOfField and OneOfField to render the options they are handed as they are, since SchemaField now retrieves each option once; a custom field rendering them with raw option schemas has to retrieve each first. See the upgrade guide (#5482)
  • Fix Form clearing array and scalar values a sibling edit didn't affect, matching v6, while a conditional that flipped still filters, keeping the #5250 fix (#5460, #5556, #5537, #5451)
  • Add the itemLabel array option, naming the item property, or '.' for strings and numbers, that titles each item's move, copy and remove buttons, such as Remove report.pdf; ArrayFieldItemButtonsTemplate receives the titles as itemButtonProps (#5474, #4424)
  • Fix DateTimeWidget wiping a value whose local year has five or six digits, such as the epoch 1e15, on edit; a year past 9999 now stays on screen and fails date-time format validation, following up #5473 (#5510)
  • BREAKING CHANGE: Change a non-object field's selected anyOf/oneOf option, and one of another type than object under a type list naming object, to render with every keyword of the field that describes its value, not only required and type, such as items or format, while the field keeps its title, description and default. See [the upgrade guide](https://rjsf-team.github.io/react-jsonschema-form/docs/migration-guides/v7.x%20upgrade%20guide#a-non-object-fields-anyofoneof-option-renders-with-its-parents-keyword