Description

Dropdown Check List is a javascript plugin based on the jQuery library that transforms a regular select html element into a dropdown checkbox list.

Usage

    $("#select_id").dropdownchecklist();

The existing select element with id 'select_id' is replaced by a dropdown checkbox list widget.

See the DEMO page for a detailed description, documentation, and live examples. This page is based on the functionality in the current, downloadable release.

See the TESTCASE page for a series of test cases that exercise DDCL in various ways. This page is based directly on the most current version checked into SVN, not on the stable release version.

Download

From download location.

Limitations

1) Keyboard / Tab processing is iffy at best. I have found no reliable way of detecting loss of focus to another component in order to force an auto-close of the dropdown.

2) <LABEL> tags associated with the underlying <SELECT> just do not work, since the <LABEL> is wired to the original <SELECT>, not the DDCL component. In particular, do not include the original <SELECT> within the span of the <LABEL> tag itself.

3) IFrame support is questionable

4) DDCL calculates size and position on widget initialization. This only operates properly if the wrapper elements containing the <SELECT> are not hidden. Therefore, the use of DDCL within dynamic components that hide/show the wrapper element is problematic.

5) DDCL V1.4 was the last tested with IE6. No future version of DDCL will test with IE6.

History

See change history.

Version 1.4 - requires jQuery 1.6.1, ui 1.8.13

Version 1.3 - copy of <OPTION> styling into the dynamic components

Version 1.2 (which never made it out of QA) - the various pop-up positioning problems reported in the issue log have been addressed

Version 1.1 - DDCL now based on jQuery 1.4.2, ui 1.8.4

Version 1.0 - the most significant difference between version 1.0 and 0.9 is the switch-over to jQuery ThemeRoller based styling. While many of the 0.9 class tags are still in place, some have been retired in favor of ThemeRoller settings. If you have customized your CSS based on 0.9, you will likely have to change some of your class name pattern matches.

License

Licensed like jQuery, see http://docs.jquery.com/Licensing

Acknowledgments

Due to time constraints, Adrian has had to step back from the active support of DDCL. But as of 09Sept2010, he has graciously allowed me to step in and re-activate the project.

Adrian, many thanks from all your users. Warren C. Omohundro - Ittrium, LLC