Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Add note re noConflict(true) with 2 jQuery versions. Closes #188

  • Loading branch information...
commit fcea21936e753c9a480136f2fe547365b6d4a92f 1 parent 327fa42
@kswedberg kswedberg authored
Showing with 27 additions and 0 deletions.
  1. +27 −0 entries/jQuery.noConflict.xml
View
27 entries/jQuery.noConflict.xml
@@ -10,6 +10,7 @@
<desc>Relinquish jQuery's control of the <code>$</code> variable.</desc>
<longdesc>
<p>Many JavaScript libraries use <code>$</code> as a function or variable name, just as jQuery does. In jQuery's case, <code>$</code> is just an alias for <code>jQuery</code>, so all functionality is available without using <code>$</code>. If you need to use another JavaScript library alongside jQuery, return control of <code>$</code> back to the other library with a call to <code>$.noConflict()</code>. Old references of <code>$</code> are saved during jQuery initialization; <code>noConflict()</code> simply restores them.</p>
+ <p>If for some reason two versions of jQuery are loaded (which is not recommended), calling <code>$.noConflict(true)</code> from the second version will return the globally scoped jQuery variables to those of the first version.</p>
<pre><code>
&lt;script type="text/javascript" src="other_lib.js"&gt;&lt;/script&gt;
&lt;script type="text/javascript" src="jquery.js"&gt;&lt;/script&gt;
@@ -70,6 +71,32 @@ $("content").style.display = 'none';
// Do something with another version of jQuery
jQuery("div > p").hide();]]></results>
</example>
+ <example>
+ <desc>Load two versions of jQuery (not recommended). Then, restore jQuery's globally scoped variables to the first loaded jQuery.</desc>
+ <html><![CDATA[
+<div id="log">
+ <h3>Before $.noConflict(true)</h3>
+</div>
+<script src="http://code.jquery.com/jquery-1.6.2.js"></script>
+]]></html>
+ <code><![CDATA[
+var $log = $( "#log" );
+
+$log.append( "2nd loaded jQuery version ($): " + $.fn.jquery + "<br>" );
+
+/*
+Restore globally scoped jQuery variables to the first version loaded
+(the newer version)
+*/
+jq162 = jQuery.noConflict(true);
+
+$log.append( "<h3>After $.noConflict(true)</h3>" );
+$log.append( "1st loaded jQuery version ($): " + $.fn.jquery + "<br>" );
+$log.append( "2nd loaded jQuery version (jq162): " + jq162.fn.jquery + "<br>" );
+]]></code>
+
+ </example>
+
<category slug="core"/>
<category slug="miscellaneous/setup-methods"/>
<category slug="version/1.0"/>
Please sign in to comment.
Something went wrong with that request. Please try again.