## multiselect2side plugin: documentation and demo page

### Demo Search - Full demo select multiple double side with search option true (1000 elements)

Select multiple="multiple" modified by multiselect2side

Click here to test the select above
Result of a php print_r() function:

---

Click here to hide/show original select

This is the javascript code to launch multiselect2side to #searchable select:

    $().ready(function() {
    	$('#searchable').multiselect2side({'search': 'Search: '});
    });

### Demo 1 - Full demo select multiple double side

Select multiple="multiple" modified by multiselect2side

Click here to test the select above
Result of a php print_r() function:

---

Click here to hide/show original select

This is the javascript code to launch multiselect2side to #first select:

    $().ready(function() {
    	$('#first').multiselect2side({
    		optGroupSearch: "Group: ",
    		search: "<img src='img/search.gif' />"
    	});
    });

### Demo 2 - select multiple double side - moveOptions: false, autoSort: true

Move buttons are disabled but is enable autoSort. Header label not present.

Click here to test the select above
Result of a php print_r() function:

---

Click here to hide/show original select

This is the javascript code to launch multiselect2side to #second select:

    $().ready(function() {
    	$('#second').multiselect2side({
    		selectedPosition: 'right',
    		moveOptions: false,
    		labelsx: '',
    		labeldx: '',
    		autoSort: true,
    		autoSortAvailable: true
    		});
    });

### Demo 3 - select multiple double side - selectedPosition: 'left'

Elements selected are in the left, label of move buttoms are modified.

Click here to test the select above
Result of a php print_r() function:

---

Click here to hide/show original select

This is the javascript code to launch multiselect2side to #third select:

    $().ready(function() {
    	$('#third').multiselect2side({
    		selectedPosition: 'left',
    		moveOptions: true,
    		labelTop: '+ +',
    		labelBottom: '- -',
    		labelUp: '+',
    		labelDown: '-',
    		labelsx: '* Selected *',
    		labeldx: '* Available *',
    		search: "Find: "
    		});
    	$('#third')
    		.multiselect2side('addOption', {name: 'test selected', value: 'test1', selected: true})
    		.multiselect2side('addOption', {name: 'test not selected', value: 'test2', selected: false});
    });

### Demo 4 - Select multiple double side with limited number of selectionable options

Select multiple="multiple" with parameter maxSelected, selectionable options limited to 4

This is the javascript code to launch multiselect2side to #fourth select:

    $().ready(function() {
    	$('#fourth').multiselect2side({maxSelected: 4});

    	$('#fourth')
    		.multiselect2side('addOption', {name: 'test selected', value: 'test1', selected: true})
    		.multiselect2side('addOption', {name: 'test not selected', value: 'test2', selected: false});
    });

### Documentation

To use this jquery plugin:

- include the js in the head section of the page:

      <head>
      ...
      <link rel="stylesheet" href="css/jquery.multiselect2side.css" type="text/css" media="screen" />

      <script type="text/javascript" src="js/jquery.js" ></script>
      <script type="text/javascript" src="js/jquery.multiselect2side.js" ></script>
      ...
      </head>

- in the read function launch the multiselect2side (select multiple double side) relative at your element:

      <script type="text/javascript">
      $().ready(function() {
      	$("select").multiselect2side();
      });
      </script>

For comments see the blog page.

#### Options:

- optGroupSearch - use optgroup label to select elements - default false
- minSize - default minSize of selects - default 6
- selectedPosition - position of selected elements - default 'right'
- moveOptions - show move options - default true
- labelTop - label of top buttom - default 'Top'
- labelBottom - label of bottom buttom - default 'Bottom'
- labelUp - label of up buttom - default 'Up'
- labelDown - label of down buttom - default 'Down'
- labelSort - label of sort buttom - default 'Sort'
- maxSelected - number of max selectable options
- labelsx: Left label - default '* Selected *'
- labeldx: Right label - default '* Available *'
- autoSort: Automatic sort of selected options - default false
- autoSortAvailable: Automatic sort of available options - default false
- search: string for add search funcionality - default false = no search
- caseSensitive: type of search - default false
- delay: the delay in milliseconds the search option waits after a keystroke to activate itself - default 200

#### Methods:

- destroy - destroy multiselect2side
- addOption - add option to select(s). See example #fourth and #third selects above. Options:
  - name: name of new value
  - value: value of new value
  - selected: if true option is inserted in "selected" list, else in "available"

### Download

You can download the entire archive:

- jquery.multiselect2side.zip - a zip archive containing the plugin source, a minified version of jQuery and a demo page.

Or single file:

- jquery.multiselect2side.js - js code.
- jquery.multiselect2side.css - css code.
- close.gif - close icon.
- loading.gif - loading icon.
- search.gif - search icon.

### Release

- 1.1 - May 04 2011 - correct some little bugs
- 1.0 - Apr 04 2011 - new optGroupSearch and minSize options, new methods destroy and addOption
- 0.16 - Mar 15 2011 - new autoSortAvailable option
- 0.15 - Mar 14 2011 - new search options
- 0.14 - Feb 2 2011 - correct FF autoSort bug
- 0.13 - Jan 26 2011 - new autoSort parameter
- 0.12 - Nov 19 2010 - correct opera bug + new demo
- 0.11 - Aug 26 2010 - correct ie6 bug
- 0.10 - Jul 20 2010 - correct ie8 bug (padding-top)
- 0.9 - Jul 16 2010 - new labels button (left and right label)
- 0.8 - May 17 2010 - new sort button (if moveOptions is true)
- 0.7 - May 16 2010 - correct order options bug
- 0.6 - Avr 16 2010 - correct bug with optgroup
- 0.5 - Avr 15 2010 - Now move and updown options are vertically centered
- 0.4 - Avr 12 2010 - New option maxSelected
- 0.3 - Avr 1 2010 - New CSS
- 0.2 - Mar 25 2010 - New parameters moveOptions (default true)
- 0.1 - Mar 22 2010 - New parameters selectedPosition (default 'right')
- 0.0 - Feb 19 2010 - First release of multiselect2side (select multiple double side)

### License

Dual licensed under the MIT and GPL licenses.