Form

🛠 Status: Pilot Phase

Lion Web Components are still in an early alpha stage; they should not be considered production ready yet.

The goal of our pilot phase is to gather feedback from a private group of users. Therefore, during this phase, we kindly ask you to:

• not publicly promote or link us yet: (no tweets, blog posts or other forms of communication about Lion Web Components)
• not publicly promote or link products derived from/based on Lion Web Components

As soon as Pilot Phase ends we will let you know (feel free to subscribe to this issue https://github.com/ing-bank/lion/issues/1)

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.