Skip to content

A lightweight vanilla javascript library that replaces native select elements with customizable dropdowns

License

Notifications You must be signed in to change notification settings

bluzky/nice-select2

Repository files navigation

Nice Select

A lightweight Vanilla JavaScript plugin that replaces native select elements with customizable dropdowns.

Install

npm i nice-select2

Usage

Include nice-select2 script.

<script src="path/to/nice-select2.js"></script>

Include the styles, either the compiled CSS...

<link rel="stylesheet" href="path/to/nice-select2.css" />

Or import nice-select2 using ES6 syntax

import NiceSelect from "nice-select2";
@import "~nice-select2/dist/css/nice-select2.css";
// or
@import "~nice-select2/src/scss/nice-select2.scss";

Finally, initialize the plugin.

Using the minimified file directly:

NiceSelect.bind(document.getElementById("a-select"), {searchable: true, placeholder: 'select', searchtext: 'zoek', selectedtext: 'geselecteerd'});

Using as import in webpack:

new NiceSelect(document.getElementById("a-select"), {searchable: true});

Instance method

  • update() : update nice-select items to match with source select
  • focus(): open dropdown list and focus on the search box if search is enabled
  • disable(): disable select
  • enable(): enable select
  • destroy(): destroy NiceSelect2 instance
  • clear(): clear all selected options

Full documentation and examples at https://bluzky.github.io/nice-select2/.