jquery-create-checkall

jQuery plugin that creates an intelligent "All" option for a group of checkboxes.
By "intelligent" I mean that it will:

• Check all of its related checkboxes when checked
• Uncheck all of its related checkboxes when unchecked
• Become checked when all of its related checkboxes are manually checked
• Become unchecked if at least one of its related checkboxes is unchecked

Installation:

Just add the jquery-checkall.js to your project and include it anywhere in your HTML (after jQuery).

<script src="path/to/jquery-create-checkall.js"></script>

Usage:

Use the plugin as follows:

$('.list-of-checkboxes').createCheckAll();

This will create a new checkbox input and its label using the default options. They are:

• breakAfter: adds a <br> after the new element. Boolean, defaults to false.
• classes: list of classes to be added to the new element. String, defaults to null.
• id: id of the new element. String, defaults to null.
• label: text for the new element's label. String, defaults to "All".
• position: position of the new element relative to the list passed to the plugin. String, accepts "before" or "after" and defaults to "before".

There is a special option:

• allSelector: this one permits you to pass the selector of an already existent checkbox element that'll be used as the "select all". If you pass the selector of an element that isn't a checkbox it will create a new one as in the previous example. This option ignores all of the others. String, defaults to null.

$('.list-of-checkboxes').createCheckAll({
	allSelector: '#id-of-the-one-i-want-to-use'
});