node package manager


Vanilla JavaScript Dropdown - replacement for <select>

Build Status Coverage Status Dependencies

Tiny (0.6 KB gzipped!) JavaScript replacement for <select> that makes styling easy and consistent.

— Inspired by the blazing fast, lightweight, cross-platform and crazy popular Vanilla JS framework.

How it works

Reads the original <select> element's options (with respect of selected, if any), creates and attaches the pseudo-select just before the original one, and hides the original.

Upon selection it updates the original <select>, so when you submit your form the value will be there.

JavaScript disabled? No problem! Nicely degrades to original <select>.




Option Required Description
elem yes id of the select you want to replace or a direct DOM element


Method Description
.toggle() Opens the select if closed and vice-versa
.close() Closes the select
.open() Opens the select

Usage example

var select = new CustomSelect({
    elem: 'select'
// open it for the user;

Running the tests

npm test

Browser support and dependencies

Browser Support Dependencies
Chrome yes -
Firefox yes -
Safari yes -
Opera yes -
IE & Edge yes* Polyfill for .classList in IE9

* IE9 and up


This project uses SemVer for versioning. For the versions available, see the tags on this repository.


Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.

See Unlicense for full details.