lion/packages/input
CircleCI 4a1c289ff5 chore: release new versions
- @lion/button@0.1.25
 - @lion/calendar@0.1.21
 - @lion/checkbox-group@0.1.23
 - @lion/checkbox@0.1.21
 - @lion/choice-input@0.1.21
 - @lion/field@0.1.21
 - @lion/fieldset@0.1.21
 - @lion/form-system@0.0.24
 - @lion/form@0.1.23
 - @lion/input-amount@0.1.21
 - @lion/input-date@0.1.21
 - @lion/input-datepicker@0.1.18
 - @lion/input-email@0.1.21
 - @lion/input-iban@0.1.22
 - @lion/input@0.1.21
 - @lion/overlays@0.2.6
 - @lion/popup@0.1.25
 - @lion/radio-group@0.1.23
 - @lion/radio@0.1.21
 - @lion/select@0.1.21
 - @lion/textarea@0.1.21
 - @lion/tooltip@0.1.25
 - @lion/validate@0.2.9
2019-06-20 09:03:28 +00:00
..
src fix: update storybook/linting; adjust story labels, eslint ignores 2019-04-28 15:02:31 +02:00
stories fix: import from entry points so stories can be extended 2019-05-07 19:46:41 +02:00
test fix: update storybook/linting; adjust story labels, eslint ignores 2019-04-28 15:02:31 +02:00
CHANGELOG.md chore: release new versions 2019-06-20 09:03:28 +00:00
index.js feat: release inital public lion version 2019-04-26 10:37:57 +02:00
lion-input.js feat: release inital public lion version 2019-04-26 10:37:57 +02:00
package.json chore: release new versions 2019-06-20 09:03:28 +00:00
README.md feat: release inital public lion version 2019-04-26 10:37:57 +02:00

Input

lion-input component is a webcomponent that enhances the functionality of the native <input> element.

Features

  • based on field
  • extra visual elements can be added via slots
    • label: can also be provided via the label attribute, but the slot can be used to change the html and CSS of the label. For example add an sr-only class to the label to make it visually hidden. A label is always needed for accessibility reasons.
    • help-text: a helper text shown below the label to give extra clarification.
    • prefix: does not have an active use case yet, but the option is in place.
    • suffix: can be used for addons to the input like a calculator, datepicker or addressbook. In these cases a button with an icon is used.
    • before: does not have an active use case yet, but the option is in place.
    • after: can be used to show a currency or percentage.
  • delegates attributes like type, disabled and read-only to the native input
  • can make us of validate

How to use

Installation

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

// validator import example
import { maxLengthValidator } from '@lion/validate';

Example

<lion-input
  label="My label"
  name="myName"
  .modelValue="${foo}"
  .errorValidators="${[['required'], maxLengthValidator(20)]}"
></lion-input>

Making use of slots:

<lion-input name="amount">
  <label slot="label">Amount</label>
  <div slot="help-text">Extra information</div>
  <div slot="after">EUR</div>
</lion-input>