forked from marcj/jquery-selectBox
-
Notifications
You must be signed in to change notification settings - Fork 0
A jQuery plugin for replacing <select> elements.
maxcold/jQuery-SelectBox
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
** Overview ** The plugin works by piggy-backing your existing SELECT controls. Since the original controls aren’t destroyed (they’re hidden), you can easily integrate this plugin into just about any existing form. The plugin degrades gracefully, as users without JavaScript will see the default SELECT controls. ** Features ** - Supports OPTGROUPS - Supports standard dropdown controls - Supports multi-select controls (i.e. multiple="multiple") - Supports inline controls (i.e. size="5") - Fully accessible via keyboard - Shift + click (or shift + enter) to select a range of options in multi-select controls - Type to search when the control has focus - Auto-height based on the size attribute (to use, omit the height property in your CSS!) - Tested in IE7-IE9, Firefox 3-4, recent webkit browsers, and Opera ** License ** Licensed under both the MIT license and the GNU GPLv2 (same as jQuery: http://jquery.org/license) ** Usage ** Link to the JS file: <script src="jquery.selectbox.min.js" type="text/javascript"></script> Add the CSS file (or append contents to your own stylesheet): <link href="jquery.selectbox.min.css" rel="stylesheet" type="text/css" /> ** To create ** $("SELECT").selectBox([settings]); ** Settings ** menuTransition: ['default', 'slide', 'fade'] menuSpeed: [integer, 'slow', 'normal', 'fast'] ** Methods ** To call a method use this syntax: $("SELECT").selectBox('methodName', [options]); create - Creates the control (default method) destroy - Destroys the selectBox control and reverts back to the original form control disable - Disables the control (i.e. disabled="disabled") enable - Enables the control value - if passed with a value, sets the control to that value; otherwise returns the current value options - pass in either a string of HTML or a JSON object to replace the existing options control - returns the selectBox control element (an anchor tag) for working with directly ** Events ** Events are fired on the original select element. You can bind events like this: $("SELECT").selectBox().change( function() { alert( $(this).val() ); } ); focus - Fired when the control gains focus blur - Fired when the control loses focus change - Fired when the value of a control changes ** Change Log ** - Refer to jquery.selectBox.js for the full change log. ** Known Issues ** - The blur and focus callbacks are not very reliable in IE7. The change callback works fine.
About
A jQuery plugin for replacing <select> elements.
Resources
Stars
Watchers
Forks
Packages 0
No packages published