#### Forms - Multiselect

Statistics Invoices Schedule

###### Basic examples Different multiselect options

##### Basic examples

Default select
Default selected options
Options with divider
Option groups support
Options with and without groups
Dropdown with max height
With Select all option
Select all option response
Filtering option
Select All and Filtering options
Full featured example
Disabled select
Disabled options
Disabled optgroups
Prevent deselect

##### Advanced usage

Within a group with addon
Within a group with button
Within a group with button dropdown
Within a group with segmented button dropdown
Within a group with checkbox
Within a group with radio
Remove active option class
Alternative labels for options
Limit options number
Custom empty text
As a link
onChange notice
onChange desktop notification
onDropdownShow event
onDropdownHide event

###### Sizing options Width and height sizing

##### Width sizing

Full width button:
Fixed width
Auto width button:
Custom percent width

##### Height sizing

Large select
Default select
Small select
Mini select

###### Other options Contextual alternatives and other options

##### Contextual alternatives

Default class
Primary class
Danger class
Success class
Warning class
Info class

##### Other options

Single select
Clickable optgroups
Disable if no options are given
Custom button color
Custom menu color
Custom colors

###### Advanced examples More complex multiselect examples

##### Further examples

###### Showing values

Use "Select" and "Deselect" to select or deselect cheese and tomatoes. Use "Values" to display the currently selected elements by using `$('.multiselect').val()`

###### Toggle selection

Use the button to toggle the selection. Don't forget to include `$.uniform.update();` to update checkboxes or radios state dynamically.

###### Order options

Record the order the options are selected. When selecting an item an ordering number will be incremented and saved within the option.

###### Simulate selections

Simulate single selections using checkboxes. The behavior will be similar to a multiselect with radio buttons.

###### Close dropdown automatically

Close dropdown after 3 selections automatically.

###### Reset button

Using a reset button together with a multiselect. Select options then click Reset button to reset selections.

###### Multiselect templates

The templates can be overriden using the `templates` configuration option. The example below uses a `div` for dividers.

##### Multiselect methods

###### Destroy method

This method is used to destroy the plugin on the given element - meaning unbinding the plugin.

###### Refresh method

This method is used to refresh the checked checkboxes based on the currently selected options within the select. Click 'Select', then click refresh. The plugin will update the checkboxes.

###### Rebuild method

Rebuilds the whole dropdown menu. All selected options will remain selected (if still existent!).

###### Select method

Selects an option by its value (which has to be given as string). Works also using an array of values.

###### Deselect method

Deselect an option by its value (which has to be given as string). Works also using an array of values.

###### Disable method

Disable both the underlying select and the dropdown button.

###### Enable method

Enable both the underlying select and the dropdown button.