jquery/jquery-picklist/README.md

#jQuery PickList#

jQuery PickList, or `jquery-picklist`, is a jQuery-based widget that turns a regular multiple option select box into a side-by-side pick list.

For detailed usage demos, visit: http://code.google.com/p/jquery-ui-picklist/wiki/Demos

##Features##

  * Fully customizable button & list labels and CSS class names
  * Support for items with rich HTML content
  * CTRL + click selects multiple items
  * SHIFT + click selects a range of items
  * Double-clicking moves items
  * Compatible with ordinary form submission
  * Works in all major browsers (IE, FF, Chrome, Opera, and Safari)
  * Many options for customization
  * Works with very large lists
  * **No longer requires jQuery UI!**

##Example Usage##

###JavaScript###

        $(function()
        {
                $("#foobar").pickList();
        });

###HTML###

        <select id="foobar" name="foobar" multiple="multiple">
                <option value="1">Option 1</option>
                <option value="2" selected="selected">Option 2</option>
                <option value="3">Option 3</option>
                <option value="4" selected="selected">Option 4</option>
                <option value="5">Option 5</option>
        </select>
1	#jQuery PickList#
2
3	jQuery PickList, or `jquery-picklist`, is a jQuery-based widget that turns a regular multiple option select box into a side-by-side pick list.
4
5	For detailed usage demos, visit: http://code.google.com/p/jquery-ui-picklist/wiki/Demos
6
7	##Features##
8
9	* Fully customizable button & list labels and CSS class names
10	* Support for items with rich HTML content
11	* CTRL + click selects multiple items
12	* SHIFT + click selects a range of items
13	* Double-clicking moves items
14	* Compatible with ordinary form submission
15	* Works in all major browsers (IE, FF, Chrome, Opera, and Safari)
16	* Many options for customization
17	* Works with very large lists
18	* No longer requires jQuery UI!
19
20	##Example Usage##
21
22	###JavaScript###
23
24	$(function()
25	{
26	$("#foobar").pickList();
27	});
28
29	###HTML###
30
31	<select id="foobar" name="foobar" multiple="multiple">
32	<option value="1">Option 1</option>
33	<option value="2" selected="selected">Option 2</option>
34	<option value="3">Option 3</option>
35	<option value="4" selected="selected">Option 4</option>
36	<option value="5">Option 5</option>
37	</select>