entries/disabled-selector.xml

<?xml version="1.0"?>
<entry type="selector" name="disabled" return="">
  <title>:disabled Selector</title>
  <sample>:disabled</sample>
  <signature>
    <added>1.0</added>
  </signature>
  <desc>Selects all elements that are disabled.</desc>
  <longdesc>
    <p>As with other pseudo-class selectors (those that begin with a ":"), it is recommended to precede it with a tag name or some other selector; otherwise, the universal selector ("*") is implied. In other words, the bare <code>$(':disabled')</code> is equivalent to <code>$('*:disabled')</code>, so <code>$('input:disabled')</code> or similar should be used instead. </p>

    <p>Although their resulting selections are usually the same, the <code>:disabled</code> selector is subtly different from the <code>[disabled]</code> attribute selector;<code>:disabled</code> matches elements that are <a href="https://html.spec.whatwg.org/multipage/scripting.html#disabled-elements">actually disabled</a> while <code>[disabled]</code> only checks for the existence of the disabled attribute.</p>

    <p>The <code>:disabled</code> selector should only be used for selecting HTML elements that support the <code>disabled</code> attribute (<code>&lt;button&gt;</code>, <code>&lt;input&gt;</code>, <code>&lt;optgroup&gt;</code>, <code>&lt;option&gt;</code>, <code>&lt;select&gt;</code>, <code>&lt;textarea&gt;</code>, <code>&lt;menuitem&gt;</code>, and <code>&lt;fieldset&gt;</code>).</p>

  </longdesc>
  <example>
    <desc>Finds all input elements that are disabled.</desc>
    <code><![CDATA[
$( "input:disabled" ).val( "this is it" );
]]></code>
    <html><![CDATA[
<form>
  <input name="email" disabled="disabled">
  <input name="id">
</form>
]]></html>
  </example>
  <category slug="selectors/form-selectors"/>
  <category slug="version/1.0"/>
</entry>