Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/2degrees/jquery.selectmultiple

Good-looking UI widget to replace the native select[multiple] widget
https://github.com/2degrees/jquery.selectmultiple

Last synced: about 14 hours ago
JSON representation

Good-looking UI widget to replace the native select[multiple] widget

Awesome Lists containing this project

README

        

# jQuery.selectmultiple

Fed-up with the poor usability of the native HTML select mutiple element? If so, use **jQuery.selectmultiple** and allow users to understand how they can choose multiple options without using the `[Ctrl]` or `[Cmd]` key!

## Dependencies

* jQuery 1.7.2+
* jQuery UI 1.8.20+
* jquery.ui.core.js
* jquery.ui.mouse.js
* jquery.ui.widget.js
* jquery.ui.sortable.js

*NB: An older version of jQuery UI might work (no testing done). However, jQuery 1.7.0 will be required due to the new event based syntax.*

## Usage

Include the plugin-script along with the jQuery and the required jQuery UI dependencies (see above), e.g.

```html

```

Then inside a javascript file (or inline in a script tag), call the ``selectmultiple()`` method on the wrapped set you wish to update, e.g.

```javascript
$('select[multiple]').selectmultiple();
```

### AMD

Alternatively you can include the module with require.js or similar:

``` javascript
require(['jquery', 'jquery.selectmultiple'], function ($) {
$(function () {
$('select[multiple]').selectmultiple();
});
});
```

*NB* This relies on jQuery UI being available under the name 'jquery.ui'.

## Notes

Any options passed to the widget, will be passed as options to the underlying sortable widget to allow for customization of that widget.

## Supported browsers

* Internet Explorer 6+
* Firefox 12.0 on Ubuntu 11.10, OS X Lion 10.7.3
* Chromium 18.0.1025.168 on Ubuntu 11.10
* Chrome 18.0.1025.168 on OS X Lion 10.7.3
* Safari 5.1.5 (7534.55.3) on OS X Lion 10.7.3