โŒ˜K
285
Theme

Docs Navigation

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).