entries/descendant-selector.xml

<?xml version="1.0"?>
<entry type="selector" name="descendant" return="">
  <title>Descendant Selector ("ancestor descendant")</title>
  <sample>ancestor descendant</sample>
  <signature>
    <added>1.0</added>
    <argument name="ancestor" type="Selector">
      <desc>Any valid selector.</desc>
    </argument>
    <argument name="descendant" type="Selector">
      <desc>A selector to filter the descendant elements.</desc>
    </argument>
  </signature>
  <desc>Selects all elements that are descendants of a given ancestor.</desc>
  <longdesc>
    <p>A descendant of an element could be a child, grandchild, great-grandchild, and so on, of that element.</p>
  </longdesc>
  <example>
    <desc>Mark all inputs that are descendants of a form with a dotted blue border. Give a yellow background to inputs that are descendants of a fieldset that is a descendant of a form.</desc>
    <code><![CDATA[
$( "form input" ).css( "border", "2px dotted blue" );
$( "form fieldset input" ).css( "backgroundColor", "yellow" );
]]></code>
    <css><![CDATA[
  form {
    border: 2px green solid;
    padding: 2px;
    margin: 0;
    background: #efe;
  }
  div {
    color: red;
  }
  fieldset {
    margin: 1px;
    padding: 3px;
  }
]]></css>
    <html><![CDATA[
<form>
  <div>Form is surrounded by the green border.</div>

  <label for="name">Child of form:</label>
  <input name="name" id="name">

  <fieldset>
    <label for="newsletter">Grandchild of form, child of fieldset:</label>
    <input name="newsletter" id="newsletter">
  </fieldset>
</form>
Sibling to form: <input name="none">
]]></html>
  </example>
  <category slug="selectors/hierarchy-selectors"/>
  <category slug="version/1.0"/>
</entry>