#jQuery Combobox plugin

Yet another combobox plugin. Were developed for my own purposes and successfully used in many projects.

##Features

• works with jQuery 1.8+

##Quick start

Three options are available:

• Download the latest release
• Clone the repo: git clone git@github.com:jslayer/jquery-combobox.git
• Install with Bower: bower install jquery-combobox

##Usage

Basic usage:

$('select').combobox([{options}], [{classes}]);

##Parameters

###Options

####width and height

int Determines the width/height of the element. Defaults is false - width/height will depend on the width/height of the source element.

####btnWidth

int Determines the element's button width (in px). Defaults is 15.

####showSpeed and hideSpeed

mixed Speed of the show/hide animation effect. Defaults is fast.

####hideSelected

bool If is true the selected element will he hidden from the dropdown list. By default is false.

####listMaxHeight

int Maximum height of the dropdown list. Vertical scrollbar appears when list height is greater than this value. Defaults is false - no limit.

####hoverEnabled

bool Enables hover feature. For performance reasons by default is false

####theme

string Set the "theme" prefix - it will be used in CSS classes for generated elements. Defaults is combo

####filter

function You can setup your own content filter; This callback accept name of the filter and the initial value; Than you should return this or modified value;

Supported filters:

• selected - The text of the selected box.

###Classes

List of default element's CSS classes suffixes and their default values.

• wrapper - wrapper
• focus - focus
• disabled - disabled
• multiple - multiple
• button - button
• group - group
• groupLabel - group-label
• list - list
• selected - selected
• itemHover - item-hover
• itemActive - item-active
• wrapHover - wrapper-hover
• wrapActive - wrapper-active
• listLong - list-long

The applyed css classes will be prepared from theme_name-suffix_name

##Events

You can bind several event handlers to the source (select) element, to catch some usefull events.

###before_show and before_hide

Called before show/hide dropdown.

###combo_init

Combobox init event.

###update_position

Called just before update the position of the dropdown. This even receive offset object, so you can easily change the dropdown position.