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> checks the boolean (true/false) value of the element's disabled property while <code>[disabled]</code> 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>, and <code>&lt;textarea&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>