Get new jQuery plugins just once a week



September 13, 2014


fuzzyDropdown | jQuery plugin for fuzzy searchable dropdowns

fuzzyDropdown is a jQuery plugin that converts a select box into a fuzzy searchable dropdown.

Created by Mudit Ameta



fuzzyDropdown jQuery plugin

fuzzy dropdown


fuzzy-dropdown is a jQuery plugin that converts a select box into a fuzzy searchable dropdown (using ~~ subsequence-search).

What is fuzzy string matching/searching?

In computer science, approximate string matching (often colloquially referred to as fuzzy string searching) is the technique of finding strings that match a pattern approximately (rather than exactly). - Wikipedia

Now, back to your regularly scheduled readme

fuzzy-dropdown proxies your interactions to the underlying select box. Hence you can add event handlers to the select box like before and have everything just work. Also, the dropdown is fully navigable via arrow keys. Look at the example in the examples/ directory for usage. Did you say demo?









npm install fuzzy-dropdown

If you plan on using fuzzy-dropdown as a standalone plugin, i.e., include jquery on your page separately followed by including fuzzy-dropdown separately, then include node_modules/fuzzy-dropdown/dist/fuzzy-dropdown.min.js.

If you plan on importing fuzzy-dropdown as a module (for use with browserify, etc) then just go ahead and require('fuzzy-dropdown') and it'll work like it's supposed to.


The javascript

$( your_select_box_selector ).fuzzyDropdown( options );

fuzzyDropdown takes the following options:

  mainContainer: '#fuzzSearch',
  arrowUpClass: 'fuzzArrowUp',
  selectedClass: 'selected',
  enableBrowserDefaultScroll: true

The markup

<select id="fuzzOptionsList">
  <option value="1">Tapout</option>
  <option value="2">Four Seasons</option>
  <option value="3">Ike's Place</option>
  <option value="4">Coats</option>
<div id="fuzzSearch">
  <div id="fuzzNameContainer">
    <span class="fuzzName"></span>
    <span class="fuzzArrow"></span>
  <div id="fuzzDropdownContainer">
    <input type="text" value="" class="fuzzMagicBox" placeholder="search.." />
    <span class="fuzzSearchIcon"></span>
    <ul id="fuzzResults">


The styling

fuzzy-dropdown by itself does no styling. All the styling is controlled via css.

This gives you complete freedom to style your dropdown however you want and it'll all just work. Below is some example css.

* {
  box-sizing: border-box;
#fuzzSearch {
  width: 50%;
#fuzzNameContainer {
  height: 40px;
  padding: 4px 10px;
  border: 1px solid #999;
  box-shadow: inset 0 0 2px 0px #333;
  width: 100%;
  cursor: pointer;
  line-height: 1.9em;
.fuzzName {
  display: inline-block;
  width: 96%;
  white-space: nowrap;
  overflow: hidden;
  text-overflow: ellipsis;
.fuzzArrow {
  width: 0;
  border-style: solid;
  border-color: #333 transparent transparent transparent;
  border-width: 7px;
  display: inline-block;
  cursor: pointer;
  position: relative;
  top: -3px;
  -webkit-transition: all 0.1s ease-in;
  transition: all 0.1s ease-in;
.fuzzArrow:hover {
  border-top-color: #888;
.fuzzArrow.fuzzArrowUp {
  border-color: transparent transparent #333 transparent;
  top: -11px;
#fuzzDropdownContainer {
  display: none;
  width: 100%;
  margin: 0 0 5px 0;
  border: 1px solid #999;
  padding: 12px 4px 4px;
  position: relative;
.fuzzMagicBox {
  width: 99%;
  height: 26px;
  margin: 0 auto;
.fuzzSearchIcon {
  width: 20px;
  height: 30px;
  position: relative;
  display: inline-block;
  background: transparent;
  top: -20px;
  left: 95%;
.fuzzSearchIcon:before, .fuzzSearchIcon:after {
  content: '';
  display: block;
  position: absolute;
  right: 5px;
.fuzzSearchIcon:before {
  width: 8px;
  height: 8px;
  border-radius: 50%;
  border: 1px solid #aaa;
.fuzzSearchIcon:after {
  height: 7px;
  border-right: 1px solid #aaa;
  top: 9px;
  -webkit-transform: rotate(-32deg);
  -ms-transform: rotate(-32deg);
#fuzzResults {
  cursor: pointer;
#fuzzResults li:hover {
  color: #aaa;
#fuzzResults li.selected {
  color: #aaa;
#fuzzResults li {
  list-style: none;
  margin: 20px 0;

And you're done!


Related posts:


To install using Bower
bower install fuzzyDropdown

fuzzyDropdown jQuery plugin

jQuery plugin

Sign up for our weekly newsletter.

* We won't spam you ever
Couple Gift Ideas