lion/packages/form
2019-11-13 11:00:48 +01:00
..
src feat: remove all deprecations from lion 2019-11-13 11:00:48 +01:00
stories fix: update storybook/linting; adjust story labels, eslint ignores 2019-04-28 15:02:31 +02:00
test fix(form): sync submit and reset events instead of delegating 2019-08-13 17:28:24 +02:00
CHANGELOG.md chore: release new versions 2019-11-12 20:34:20 +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: release new versions 2019-11-12 20:34:20 +00: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.