jQuery API

:button Selector

button selector

version added: 1.0jQuery(':button')

Description: Selects all button elements and elements of type button.

An equivalent selector to $(":button") using valid CSS is $("button, input[type='button']").

Additional Notes:

  • Because :button is a jQuery extension and not part of the CSS specification, queries using :button cannot take advantage of the performance boost provided by the native DOM querySelectorAll() method. To achieve the best performance when using :button to select elements, first select the elements using a pure CSS selector, then use .filter(":button").

Example:

Find all button inputs and mark them.

<!DOCTYPE html>
<html>
<head>
  <style>
  textarea { height:35px; }
  div { color: red; }
  fieldset { margin: 0; padding: 0; border-width: 0; }
  .marked { background-color: yellow; border: 3px red solid; }
</style>
  <script src="http://code.jquery.com/jquery-latest.js"></script>
</head>
<body>
  <form>
  <fieldset>
    <input type="button" value="Input Button"/>
    <input type="checkbox" />

    <input type="file" />
    <input type="hidden" />
    <input type="image" />

    <input type="password" />
    <input type="radio" />
    <input type="reset" />

    <input type="submit" />
    <input type="text" />
    <select><option>Option<option/></select>

    <textarea></textarea>
    <button>Button</button>
  </fieldset>
</form>

<div>
</div>
<script>
  var input = $(":button").addClass("marked");
  $("div").text( "For this type jQuery found " + input.length + "." );
  $("form").submit(function () { return false; }); // so it won't submit
</script>

</body>
</html>

Demo:

Support and Contributions

Need help with :button Selector or have a question about it? Visit the jQuery Forum or the #jquery channel on irc.freenode.net.

Think you've discovered a jQuery bug related to :button Selector? Report it to the jQuery core team.

Found a problem with this documentation? Report it on the GitHub issue tracker

  • http://profiles.yahoo.com/u/32AIDQQX2VPITAFAWV6BJ7BREI Sofia

    $(':button') is equivalent with $('input[type=button], button')

  • http://dpawson.myopenid.com/ DaveP

    Newbie alert.
    No simple example of registering my action of clicking a button?
    Then responding to it in some way?

    • http://www.learningjquery.com/ Karl Swedberg

      For information on binding a click handler to a button, see
      http://api.jquery.com/click

    • Myndian

      $('#mybutton').click(function(){
      //function to perform on selected button click
      })

  • Myndian

    $('#mybutton').click(function(){
    //function to perform on selected button click
    })

  • San6123

    $('#mybutton').click(function(){
    //function to perform on selected button click
    })