lion/packages/form
Thomas Allmer 4a93599228 chore: update storybook version
Co-authored-by: Joren Broekema <Joren.Broekema@ing.com>
2020-01-13 13:58:03 +01:00
..
src fix(form): event order of reset and submit 2019-12-06 10:30:50 +01:00
stories chore: update storybook version 2020-01-13 13:58:03 +01:00
test fix(form): event order of reset and submit 2019-12-06 10:30:50 +01:00
CHANGELOG.md chore: release new versions 2020-01-08 15:32:29 +00:00
index.js feat: release inital public lion version 2019-04-26 10:37:57 +02:00
lion-form.js feat: release inital public lion version 2019-04-26 10:37:57 +02:00
package.json chore: update storybook version 2020-01-13 13:58:03 +01:00
README.md chore: fix style of markdown files 2019-07-24 15:20:19 +02:00

Form

lion-form is a webcomponent that enhances the functionality of the native form component. It is designed to interact with (instances of) the form controls.

Features

  • data synchronization with models
  • easy retrieval of form data based on field names
  • advanced validation possibilities
  • advanced user interaction scenarios via interaction states
  • registration mechanism for form controls.
  • accessible out of the box

How to use

Installation

npm i --save @lion/form
import '@lion/form/lion-form.js';

Example

<lion-form>
  <form>
    <lion-fieldset name="fullName">
      <lion-input label="First Name" name="firstName" .modelValue="${model.firstName}"></lion-input>
      <lion-input label="Last Name" name="lastName" .modelValue="${model.lastName}"></lion-input>
    </lion-fieldset>
    <lion-textarea
      label="Description"
      name="description"
      .modelValue="${model.description}"
    ></lion-textarea>
  </form>
</lion-form>

Note that the example above is rendered using lit-html

For more information about fields that are designed for lion-form, please read Forms.