Changelog
1.0.0-beta.2
February 3, 2022
๐ New features
- New
@formkit/nuxt
package is a full featured Nuxt 3 module that makes using FormKit with Nuxt 3 as simple as possible!
defaultConfig
now includes a new package @formkit/dev
which decodes FormKitโs error codes to helpful console messages (no action required) (#56).
- FormKit is officially open-source under the MIT license!
- The
preserve
key now applies to all descendants (#53).
- Exports all the text formatter functions in the
@formkit/i18n
package (#54).
- Adds ๐ณ๐ฑ Dutch language support (thanks @arjendejong12).
- Adds ๐ญ๐ท Croatian language support (thanks @antemarkic).
- Improves ๐ฉ๐ช German language support (thanks @tosling).
๐ Documentation
- New installation documentation. You no longer need an auth token to install from the
@formkit
organization!
- Nuxt installation documentation
- Improved internationalization documentation for selective message overrides.
๐ Bug fixes
- Fixes a bug that caused multi-select checkboxes to not display the current value when set from parent node and when using
options
prop that is stored in an external variable (#55)
- Fixed a bug that caused the
placeholder
on select inputs to be removed if something caused the input to re-render (#52).
- Fixed the select placeholder color (#51)
1.0.0-beta.1
January 28, 2022
๐ New features
- Forms are automatically disabled when an async submit handler is pending (#44).
- Added a new prop
submit-behavior
to opt-out of the new automatically disabled forms.
- Exports the Vue to FormKit bindings plugin as
bindings
in the @formkit/vue
package.
- The type
button
and submit
are automatically ignored.
- Introduces a new
messages
key to the defaultConfig
to allow partial overrides to locales. This allows selective message overrides for already registered locales (#42).
- The schema compiler now supports "undefined" as a valid output (in other words
$: undefined
would output the value undefined
instead of the string "undefined").
- Adds ๐ฎ๐ฑ Hebrew locale (thanks @Hepi420)
- Adds ๐จ๐ณ Chinese locale (thanks @myleslee)
๐ Bug fixes
- Fixed an issue that caused checkboxes with
options
to not properly hydrate when re-populated from a group
, list
, or form
(#45).
- Fixed an issue that caused checkboxes with
options
to not display incorrectly when missing a the label prop (#41).
- Significantly improved TypeScript support for โsyntheticโ props (#43).
1.0.0-alpha.5
January 20, 2022
โ ๏ธ Breaking changes
- Changes the
validation-behavior
prop on the <FormKit>
component to validation-visibility
.
- Changes the
schema
prop on the <FormKit>
component to sections-schema
.
๐ New features
- Adds the native
file
input type with support for some value-added features:
- Display only re-population.
- Drag and drop.
- Input clearing.
- Adds the
createInput
helper function to make custom inputs easy to write.
- New
incomplete-message
prop allows inline customization (or disabling) of the message displayed by a form when it attempts to submit and all its inputs are not valid.
- Updates the
defaultConfig
to accept custom inputs.
- Adds a prefix section key which allows content to be injected immediately before an input element.
- Adds a suffix section key which allows content to be injected immediately after an input element.
- ๐ท๐บ Russian locale (thank you @andreimakushkin!)
- Refactors Genesis theme to use much more robust CSS variable structure.
- Adds a new feature to schemas that allows users to prefix
props
and attrs
properties with __raw__
to pass the raw value instead of its parsed result (#36).
๐ Documentation
๐ Bug fixes
- Fixes a bug that prevented the incomplete message from displaying on forms (#29).
- Fixes TypeScript typings for
@submit
and @submit-raw
events.
- Fixes the order of numbers in the
length
and between
validation messages to always place the lower number first (#35).
- Fixes an issue (#32)with select lists where the
:options
prop would not accept number values.
1.0.0-alpha.4
December 16, 2021
๐ New features
- New validation rule โhintsโ โ modifiers that change a validation ruleโs behavior. Supported hints allow you to:
- Run a rule when the field is empty.
- Force a rule to run even when previous rules are failing.
- Debounce a validation rule.
- Make a validation rule optional.
- When an input is inside a form and unmounted (such as a
v-if
), it now removes itโs value from the form data and de-registers its core node.
- New
preserve
prop allows inputs to not remove their data from groups, lists, and forms when they are removed.
๐ Bug fixes
- Fixed an issue that caused numeric value radio and checkbox options to render incorrectly.
- Fixed a bug that caused the
placeholder
to not render when the prop came after the options
prop.
- Fixed a bug that caused the delay value to not be respected when set using ancestor config.
1.0.0-alpha.3
December 13, 2021
๐ New features
- Form error handling is here. You can now set input errors on an entire form, group or list with the
input-errors
prop or the $formkit.setErrors()
methods. Read more about it on the form docs.
- New
$formkit.setLocale()
reactively changes the language of all displayed messages.
- Adds ๐ซ๐ท French and ๐ฉ๐ช German locales (thank you @HoreKk and @digitalkaoz)
- Adds new
rootConfig
proxy object that is used to store global base config and prop values (significant refactor of configuration system).
- Added ledger dependency tracking to instances of
FormKitObservedNode
.
- The submit button on forms now use the locale for the default โSubmitโ label.
- New
child
node event emitted when a parent has a child added to it.
- The
length
rule can now take max/min arguments in either order length:15,5
or length:5,15
evaluate the same.
- Adds a new
getNode
function to directly access a FormKit node using the composition API.
- Improves the
@formkit/theme
css import location.
๐ Bug Fixes
- Fixed a bug that caused children of
list
inputs to sometimes throw an exception when display validation errors.
- Improved several of the validation error messages.
- Fixed an issue with select inputs prevented raw
node.input()
calls to not trigger reactivity in Vue.
1.0.0-alpha.2
November 30, 2021
๐ New features
- A new
$formkit
schema shorthand for using FormKit inputs in a schema (Issue #15).
- New
disabled
prop on form, list, and group inputs automatically disables all child inputs (Issue #16).
- New
submitAttrs
prop on forms allows you to pass attributes to the formโs submit button.
- Added a new universal
ignore
prop that prevents an inputโs data from being used in a form.
๐ Bug fixes
- Fixed an issue that prevented schemas from rendering expressions when used inside the
children
property of a FormKit component. (Issue #21).
- Added a check in case a
rootClasses
function incorrectly returns undefined
(Issue #17).
- Fixed a bug that caused a form's submit button to pollute the formโs data object with a
submit_x
property (Issue #22).
- Fixed a bug that caused
$cmp
schema nodes to fail to remount if the schemaโs root object was reset causing a full re-parse (Issue #14).