@lion/select-rich

Provides a select with options that can contain html

Usage no npm install needed!

<script type="module">
  import lionSelectRich from 'https://cdn.skypack.dev/@lion/select-rich';
</script>

README

Inputs >> Select Rich >> Overview ||10

This web component is a 'rich' version of the native <select> element. It allows providing fully customized options and a fully customized invoker button and is meant to be used whenever the native <select> doesn't provide enough styling,theming or user interaction opportunities.

Its implementation is based on the following Design pattern: https://www.w3.org/TR/wai-aria-practices/examples/listbox/listbox-collapsible.html

import { LitElement, html } from '@mdjs/mdjs-preview';
import '@lion/listbox/define';
import '@lion/select-rich/define';

export const main = () => html`
  <lion-select-rich name="favoriteColor" label="Favorite color">
    <lion-option .choiceValue=${'red'}>Red</lion-option>
    <lion-option .choiceValue=${'hotpink'}>Hotpink</lion-option>
    <lion-option .choiceValue=${'blue'}>Blue</lion-option>
  </lion-select-rich>
`;

Features

  • Fully accessible
  • Flexible API
  • Fully customizable option elements
  • Fully customizable invoker element
  • Mimics native select interaction mode (windows/linux and mac)

Installation

npm i --save @lion/select-rich

import { LionSelectRich, LionOptions, LionOption } from '@lion/select-rich';
// or
import '@lion/select-rich/define';
import '@lion/listbox/define';

No need to npm install @lion/option separately, it comes with the rich select as a dependency