entries/detach.xml

<?xml version="1.0"?>
<entry type="method" name="detach" return="jQuery">
  <title>.detach()</title>
  <signature>
    <added>1.4</added>
    <argument name="selector" optional="true" type="Selector">
      <desc>A selector expression that filters the set of matched elements to be removed.</desc>
    </argument>
  </signature>
  <desc>Remove the set of matched elements from the DOM.</desc>
  <longdesc>
    <p>The <code>.detach()</code> method is the same as <code><a href="/remove">.remove()</a></code>, except that <code>.detach()</code> keeps all jQuery data associated with the removed elements. This method is useful when removed elements are to be reinserted into the DOM at a later time.</p>
  </longdesc>
  <example>
    <desc>Detach all paragraphs from the DOM</desc>
    <code><![CDATA[
    $("p").click(function(){
      $(this).toggleClass("off");
    });
    var p;
    $("button").click(function(){
      if ( p ) {
        p.appendTo("body");
        p = null;
      } else {
        p = $("p").detach();
      }
    });]]></code>
    <css><![CDATA[p { background:yellow; margin:6px 0; } p.off { background: black; }]]></css>
    <html><![CDATA[<p>Hello</p>
  how are
  <p>you?</p>
  <button>Attach/detach paragraphs</button>]]></html>
  </example>
  <category slug="manipulation/dom-removal"/>
  <category slug="version/1.4"/>
</entry>