:checked JQ Home  <<  Selectors  <<  :checked

UI element states pseudo-class match selector.

Shorthand version $(':checked')

Description

The :checked selector, selects all checked elements.

  • Selections apply to checkboxes, radio buttons and options of <select> elements.
  • If this selector is not preceded by another selector, the universal selector ("*") is implied and so the whole DOM will be searched. Use another selector as in the examples below to narrow the search and improve performance.

Syntax

Signature Description
jQuery(':checked')UI element states pseudo-class match

Parameters

None.

Return

N/A.

:checked Example Selectors  <<  Top

Selects all checked elements.

The following example will check to see which checkboxes have been ticked and put out an appropriate message. Click on the boxes to see the output message change.



function pieCount() {
  var counter = $("form input:checked").length-1;

  $("#showcount").text("You like: " + (counter < 1 ? " none" : counter) 
                                    + " of our pies");
}

pieCount();

$(":checkbox").click(pieCount); 



Please fill in our Pie Survey:


Pie Survey

 Click all pies that you like:




Related Tutorials

jQuery Basic Tutorials - Lesson 3 - CSS Selectors

jQuery Basics

jQuery Basics

jQuery Intermediate

jQuery Intermediate

jQuery Advanced

jQuery Advanced

jQuery Reference

API by Function Types

API Alphabetically

jQuery Glossary

Function Type

Ajax

Attributes & Properties

Core & Internals

DOM Element Methods

Effects

Events

Filtering

Manipulation

Objects

Selectors

Attribute

Attribute Contains Prefix Selector

Attribute Contains Selector

Attribute Contains Word Selector

Attribute Ends With Selector

Attribute Equals Selector

Attribute Not Equal Selector

Attribute Starts With Selector

Has Attribute Selector

Multiple Attribute Selector

Basic

All Selector ('*')

Class Selector ('.class')

Element Selector

ID Selector ('#id')

Multiple Selector

Basic Filter

:animated Selector

:eq() Selector

:even Selector

:first Selector

:gt() Selector

:header Selector

:lang Selector

:last Selector

:lt() Selector

:not() Selector

:odd Selector

:root Selector

:target Selector

Child Filter

:first-child Selector

:first-of-type Selector

:last-child Selector

:last-of-type Selector

:nth-child() Selector

:nth-last-child() Selector

:nth-last-of-type() Selector

:nth-of-type() Selector

:only-child Selector

:only-of-type Selector

Content Filter

:contains() Selector

:empty Selector

:has Selector

:parent Selector

Form

:button Selector

:checkbox Selector

:checked Selector

:disabled Selector

:enabled Selector

:file Selector

:focus Selector

:image Selector

:input Selector

:password Selector

:radio Selector

:reset Selector

:selected Selector

:submit Selector

:text Selector

Hierarchy

Child Selector

Descendant Selector

Next Adjacent Selector

Next Siblings Selector

Visibility Filter

:hidden Selector

:visible Selector

Traversal

Utilities