jQuery plugin for quick, gracefully degradable, cascading (dependent) HTML <select></select> lists
Switch branches/tags
Nothing to show
Latest commit 8cfc1ba Oct 28, 2011 @jadb Added project status to README
Failed to load latest commit information.
LICENSE first release Jan 16, 2010
README.md Added project status to README Oct 28, 2011
cascade.js FIX: removed forgotten debug alert() Jan 16, 2010
examples.html added basic examples Jan 17, 2010


Cascade (jQuery plugin) Project status

Enabling, gracefully degradable cascading <select> lists


  • jQuery 1.3.2 (or above)


Copy/paste the following in the <head> part of your HTML:

<script src="/path/to/cascade/cascade.js" type="text/javascript"></script>
<script type="text/javascript" charset="utf-8"> $(document).ready(function() { $('#parent_id').cascade(); }); </script>


Options can be passed to cascade():

	child: '', // id of child <select> (default: parent_id_child)
	classes: {
		// class name to use for <option>s that take an extra text
		// field for example (default: other)
		other: '',
		// class name to use for child <option>s to be "selected" by
		// default when their parent is "selected" (default: selected)
		selected: '',
	callbacks {
		// triggered 'before' and 'after' a child <select> <option>
		// is changed (default: none)
		child: function(on){},
		// triggered 'before' and 'after' a parent <select> <option>
		// is changed (default: none)
		parent: function(on){},
		// triggered when an `other` child <option> is selected
		// (default: show() div#other, focus() input#other)
		other: function(){},

Patches & Features

  • Fork
  • Mod, fix
  • Test - this is important, so it's not unintentionally broken
  • Commit - do not mess with license, todo, version, etc. (if you do change any, bump them into commits of their own that I can ignore when I pull)
  • Pull request - bonus point for topic branches

Bugs & Feedback