@vaadin/select
TypeScript icon, indicating that this package has built-in type declarations

24.4.0 • Public • Published

@vaadin/select

A web component for selecting a single value from a list of options presented in an overlay.

Documentation + Live Demo ↗

npm version

<vaadin-select label="Sort by"></vaadin-select>
<script>
  document.querySelector('vaadin-select').renderer = (root) => {
    if (root.firstElementChild) {
      return;
    }

    // Note that innerHTML is only used for demo purposes here!
    // Consider using Lit or another template library instead.
    root.innerHTML = `
      <vaadin-list-box>
        <vaadin-item value="recent">Most recent first</vaadin-item>
        <vaadin-item value="rating-desc">Rating: high to low</vaadin-item>
        <vaadin-item value="rating-asc">Rating: low to high</vaadin-item>
        <vaadin-item value="price-desc">Price: high to low</vaadin-item>
        <vaadin-item value="price-asc">Price: low to high</vaadin-item>
      </vaadin-list-box>
    `;
  };
</script>

Screenshot of vaadin-select

Installation

Install the component:

npm i @vaadin/select

Once installed, import the component in your application:

import '@vaadin/select';

Themes

Vaadin components come with two built-in themes, Lumo and Material. The main entrypoint of the package uses the Lumo theme.

To use the Material theme, import the component from the theme/material folder:

import '@vaadin/select/theme/material/vaadin-select.js';

You can also import the Lumo version of the component explicitly:

import '@vaadin/select/theme/lumo/vaadin-select.js';

Finally, you can import the un-themed component from the src folder to get a minimal starting point:

import '@vaadin/select/src/vaadin-select.js';

Contributing

Read the contributing guide to learn about our development process, how to propose bugfixes and improvements, and how to test your changes to Vaadin components.

License

Apache License 2.0

Vaadin collects usage statistics at development time to improve this product. For details and to opt-out, see https://github.com/vaadin/vaadin-usage-statistics.

Package Sidebar

Install

npm i @vaadin/select

Weekly Downloads

22,323

Version

24.4.0

License

Apache-2.0

Unpacked Size

120 kB

Total Files

46

Last publish

Collaborators

  • web-padawan
  • diegocardoso
  • alvarezguille
  • platosha
  • jouni
  • manolo
  • yuriyyev
  • vaadin-owner
  • tomivirkki
  • artur-
  • sunzhewyq
  • sosa-vaadin