## Multiple Select
Multiple select is a jQuery plugin to select multiple elements with checkboxes :).
**Multiple Selected is licensed under the The MIT License. Completely free, you can arbitrarily use and modify this plugin. If this plugin is useful to you, you can give me a <a href="https://github.com/wenzhixin/multiple-select/">star</a>, and I will do better, thanks.**
*Current version: 1.2.1*
## Requirements
* jQuery >= 1.7.0
## Features
* Default option allows to show checkbox.
* Ability to grouping elements.
* Supports to show multiple items in single row.
* Select all options.
* Feature to show placeholder.
## Browser Compatibility
* IE 7+
* Chrome 8+
* Firefox 10+
* Safari 3+
* Opera 10.6+
## Examples
### The Basics1
Multiple Select can take a regular select box like this:
<p id="e1_f">
<select class="w300" multiple="multiple">
<option value="1">January</option>
<option value="2">February</option>
<option value="3">March</option>
<option value="4">April</option>
<option value="5">May</option>
<option value="6">June</option>
<option value="7">July</option>
<option value="8">August</option>
<option value="9">September</option>
<option value="10">October</option>
<option value="11">November</option>
<option value="12">December</option>
</select>
</p>
and turns it into:
<p id="e1_t"></p>
``` html
<head>
<link href="multiple-select.css" rel="stylesheet"/>
</head>
<body>
<select multiple="multiple">
<option value="1">January</option>
...
<option value="12">December</option>
</select>
<script src="multiple-select.js"></script>
<script>
$('select').multipleSelect();
</script>
</body>
```
### The Basics2
Multiple Select can take a regular select box like this:
<p id="e2_f">
<select class="w300" multiple="multiple" disabled="disabled">
<option value="1">January</option>
<option value="2">February</option>
<option value="3">March</option>
<option value="4">April</option>
<option value="5">May</option>
<option value="6">June</option>
<option value="7">July</option>
<option value="8">August</option>
<option value="9">September</option>
<option value="10">October</option>
<option value="11">November</option>
<option value="12">December</option>
</select>
</p>
and turns it into:
<p id="e2_t"></p>
``` html
<head>
<link href="multiple-select.css" rel="stylesheet"/>
</head>
<body>
<select multiple="multiple" disabled="disabled">
<option value="1">January</option>
...
<option value="12">December</option>
</select>
<script src="multiple-select.js"></script>
<script>
$('select').multipleSelect();
</script>
</body>
```
### The Basics3
Multiple Select can take a regular select box like this:
<p id="e3_f">
<select class="w300" multiple="multiple">
<option value="1" selected="selected">January</option>
<option value="2" disabled="disabled">February</option>
<option value="3" selected="selected" disabled="disabled">March</option>
<option value="4">April</option>
<option value="5">May</option>
<option value="6">June</option>
<option value="7">July</option>
<option value="8">August</option>
<option value="9">September</option>
<option value="10">October</option>
<option value="11">November</option>
<option value="12">December</option>
</select>
</p>
and turns it into:
<p id="e3_t"></p>
``` html
<head>
<link href="multiple-select.css" rel="stylesheet"/>
</head>
<body>
<select multiple="multiple">
<option value="1" selected="selected">January</option>
<option value="2" disabled="disabled">February</option>
<option value="3" selected="selected" disabled="disabled">March</option>
...
</select>
<script src="multiple-select.js"></script>
<script>
$('select').multipleSelect();
</script>
</body>
```
### With Optgroups1
Multiple Select can take a regular select box like this:
<p id="e4_f">
<select class="w300" multiple="multiple">
<optgroup label="Group 1">
<option value="1">Option 1</option>
<option value="2">Option 2</option>
<option value="3">Option 3</option>
</optgroup>
<optgroup label="Group 2">
<option value="4">Option 4</option>
<option value="5">Option 5</option>
<option value="6">Option 6</option>
</optgroup>
<optgroup label="Group 3">
<option value="7">Option 7</option>
<option value="8">Option 8</option>
<option value="9">Option 9</option>
</optgroup>
</select>
</p>
and turns it into:
<p id="e4_t"></p>
``` html
<head>
<link href="multiple-select.css" rel="stylesheet"/>
</head>
<body>
<select multiple="multiple">
<optgroup label="Group 1">
<option value="1">Option 1</option>
...
</optgroup>
...
<optgroup label="Group 3">
...
<option value="9">Option 9</option>
</optgroup>
</select>
<script src="multiple-select.js"></script>
<script>
$('select').multipleSelect();
</script>
</body>
```
### With Optgroups2
Multiple Select can take a regular select box like this:
<p id="e5_f">
<select class="w300" multiple="multiple">
<optgroup label="Group 1" disabled="disabled">
<option value="1">Option 1</option>
<option value="2">Option 2</option>
<option value="3">Option 3</option>
</optgroup>
<optgroup label="Group 2">
<option value="4">Option 4</option>
<option value="5">Option 5</option>
<option value="6">Option 6</option>
</optgroup>
<optgroup label="Group 3">
<option value="7">Option 7</option>
<option value="8">Option 8</option>
<option value="9">Option 9</option>
</optgroup>
</select>
</p>
and turns it into:
<p id="e5_t"></p>
``` html
<head>
<link href="multiple-select.css" rel="stylesheet"/>
</head>
<body>
<select multiple="multiple">
<optgroup label="Group 1" disabled="disabled">
<option value="1">Option 1</option>
...
</optgroup>
...
<optgroup label="Group 3">
...
<option value="9">Option 9</option>
</optgroup>
</select>
<script src="multiple-select.js"></script>
<script>
$('select').multipleSelect();
</script>
</body>
```
### The Placeholder
<p id="e6">
<select class="w300" multiple="multiple">
<option value="1">January</option>
<option value="2">February</option>
<option value="3">March</option>
<option value="4">April</option>
<option value="5">May</option>
<option value="6">June</option>
<option value="7">July</option>
<option value="8">August</option>
<option value="9">September</option>
<option value="10">October</option>
<option value="11">November</option>
<option value="12">December</option>
</select>
</p>
``` html
<head>
<link href="multiple-select.css" rel="stylesheet"/>
</head>
<body>
<select multiple="multiple">
<option value="1">January</option>
...
<option value="12">December</option>
</select>
<script src="multiple-select.js"></script>
<script>
$("select").multipleSelect({
placeholder: "Here is the placeholder"
});
</script>
</body>
```
### The Multiple Items
Multiple Select supports to show multiple items in single row.
<p id="e7">
<select class="w300" multiple="multiple">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
<option value="5">5</option>
<option value="6">6</option>
<option value="7">7</option>
<option value="8">8</option>
<option value="9">9</option>
<option value="10">10</option>
<option value="11">11</option>
<option value="12">12</option>
<option value="13">13</option>
<option value="14">14</option>
<option value="15">15</option>
<option value="16">16</option>
<option value="17">17</option>
<option value="18">18</option>
<option value="19">19</option>
<option value="20">20</option>
<option value="21">21</option>
<option value="22">22</option>
<option value="23">23</option>