Version 2.0
This widget is a complete rewrite of the previous version. Why a new rewrite? Because the original widget's attempt was to create a all-in-one-out-of-the-box-multi-featured SELECT replacement and thus failed to be compliant with the DOMElement's behavior and limitations. Notably, it failed to :
Also, it quickly became slow when loading a few hundred items and some branches had drag and drop issues.
This widget is stable enough to be used in staging environments. However it is still under development, in testing phase, as some features may require more feedbacks yet! (Mainly browser compatiblity.) At this point, expect minor bug fixes within 72 hours, and there will be no more features planned at this point.
The compressed (minified) version is created using the YUI Compressor.
Note : Even though it is a complete rewrite of the widget, I kept the multiselect
widget name (but it is declared as uix.multiselect
instead of ui.multiselect
).
$('selector').multiselect();
To programmatically select/deselect, add/modify/remove items, you may access and modify the DOMElement directly, then call the refresh
widget method to update it.
$('selector').append("<option value='item1'>My Item 1</option>")
.multiselect('refresh');
// manually filter available options
// This will only render visible the available items containing 'My Item' (case insensitive)
$('selector').multiselect('search', 'my item');
$('selector').multiselect('destroy'); // restore original element
See wiki documentation for more information.
sortable
option to true
, options can only be reordered within their own groups. That is, an option cannot be
reordered between two options of a different group. As this widget's purpose is not to extend the original element's behaviour
beyound user interaction and presentation, this limitation shall not be lifted for the time being.