Input: Overview

A web component that enhances the functionality of the native <input> element.

export const main = () => html`<lion-input label="First Name"></lion-input>`;

Features

• 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 u-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, placeholder and readonly to the native input.
• Can make use of validation.

Installation

npm i --save @lion/ui

import '@lion/ui/define/lion-input.js';