:disabled JQ Home  <<  Selectors  <<  :disabled

UI element states pseudo-class match selector.

Shorthand version $(':disabled')

Description

The :disabled selector, selects all disabled elements.

  • Should only be used for selecting HTML elements that support the disabled attribute, these being (<button>, <input>, <optgroup>, <option>, <select>, <textarea>, and <fieldset>).
  • The :disabled selector is subtly different from using the Has Attribute Selector via $('[disabled]'):
  • 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(':disabled')UI element states pseudo-class match

    Parameters

    None.

    Return

    N/A.

    :disabled Example Selectors  <<  Top

    Selects all disabled elements.

    The following rather contrived example will check for disabled input elements and set a message in them with a yellow background when the button below is clicked.

    
    
    $(function(){
      $('#btn1').on('click', function() {
        $("input:disabled").css('backgroundColor', 'yellow')
                           .val("this field disabled"); 
      });
    }); 
    
    
    

    Please fill in the form:


    Your Information

     Enter your name:


     Enter your telephone number:


     Enter your location:



    Press the button below to action the above code:


    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