Index of /external/sumoselect

[ICO]NameLast modifiedSizeDescription
[PARENTDIR]Parent Directory  -  
[TXT]README.html2025-05-07 12:29 11K 
[TXT]README.md2025-05-07 12:29 8.6K 
[ ]bower.json2025-05-07 12:29 475  
[ ]jquery.sumoselect.jquery.json2025-05-07 12:29 1.4K 
[TXT]jquery.sumoselect.js2025-05-07 12:29 36K 
[TXT]jquery.sumoselect.min.js2025-05-07 12:29 12K 
[ ]package.json2025-05-07 12:29 770  
[TXT]select_responsive.html2025-05-07 12:29 24K 
[TXT]sumoselect.css2025-05-07 12:29 9.6K 
[TXT]sumoselect.css.map2025-05-07 12:29 5.7K 
[TXT]sumoselect.min.css2025-05-07 12:29 7.2K 
[ ]sumoselect.scss2025-05-07 12:29 9.1K 

jquery.sumoselect

jquery.sumoselect.js - A beautiful cross device Single/Multi Select jQuery Select plugin.

A jQuery plugin that progressively enhances an HTML Select Box into a Single/Multiple option dropdown list. The dropdown list can be fully customizable using simple css. It can adapt itself according to any device, keeping in mind that the User Experience is not broken.

View Live Demo Here

Documentaion Documentation Here

Latest stable : Download from here

CDNJS

The folks at CDNJS host a copy of the library. The CDN is updated after the release is made public, which means there is a delay between the publishing of a release and its availability on the CDN, so keep that in mind. Just use these links:

<!-- Latest compiled and minified CSS -->
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/jquery.sumoselect/3.0.2/sumoselect.min.css">

<!-- Latest compiled and minified JavaScript -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery.sumoselect/3.0.2/jquery.sumoselect.min.js"></script>

Notable Features

Update v1.1.0

Update v1.2.0

Update v2.0.0

Update v3.0.0

Requirements

jQuery 1.8.3+ (It is always recommended to use the latest version of jQuery)

Desktop Browser Support

IE8+, Firefox 4+, Chrome, Safari 4+, Opera 11+ (Other browsers may work, but I did not test on them)

Mobile/Tablet Browser Support

iOs 3+, Android 2.1+ , Windows Mobile (Other browsers may work, but I did not test on them)

Forking

If you find that you need a feature that SumoSelect does not currently support, either let me know via the SumoSelect issue tracker, or fork SumoSelect on Github and easily extend SumoSelect to create your own widget!

Usage

To just go with the default options simply do

 $(document).ready(function () {
            $('.SlectBox').SumoSelect();
     });

To provide optional settings, simply pass settings object to SumoSelect()

 $(document).ready(function () {
            $('.SlectBox').SumoSelect({placeholder: 'This is a placeholder', csvDispCount: 3 });
        });

If you want a instance to the SumoSelect object to call handler methods

 var MySelect;
 $(document).ready(function () {
         MySelect = $('.SlectBox').SumoSelect();
     });

NOTE: SumoSelect returns an array of select elements if there are more than one in the matching selector.

You can also find the instance to SumoSelect object by directly selecting your select element like

    $('select.SlectBox')[0].sumo. .....

You can perform all the operations on underlying original select and then reload the UI by 

    $('select.SlectBox')[0].sumo.reload();
You can bind your handlers to some sumoselect specific events eg.
$('select.SlectBox').on('sumo:opened', function(sumo) {
   // Do stuff here
   console.log("Drop down opened", sumo)
});

Available events

Settings

The following settings are available now:

The default settings are :

{
    placeholder: 'Select Here',
    csvDispCount: 3,
    captionFormat:'{0} Selected', 
    captionFormatAllSelected:'{0} all selected!',
    floatWidth: 400,
    forceCustomRendering: false,
    nativeOnDevice: ['Android', 'BlackBerry', 'iPhone', 'iPad', 'iPod', 'Opera Mini', 'IEMobile', 'Silk'],
    outputAsCSV: false,
    csvSepChar: ',',
    okCancelInMulti: false,
    isClickAwayOk: false,
    triggerChangeCombined: true,
    selectAll: false,
    search: false,
    searchText: 'Search...',
    noMatch: 'No matches for "{0}"',
    prefix: '',
    locale: ['OK', 'Cancel', 'Select All'],
    up: false,
    showTitle: true
}

Furthur Documentation

License

Copyright (c) 2016 Hemant Negi Licensed under the MIT license.