merging in setDomLibrary

christopherwright · Feb 2, 2012 · 0ffd7ea · 0ffd7ea
2 parents 8a427f3 + e97c58f
commit 0ffd7ea
Show file tree

Hide file tree

Showing 3 changed files with 50 additions and 0 deletions.
diff --git a/backbone.js b/backbone.js
@@ -41,6 +41,25 @@
   // For Backbone's purposes, jQuery, Zepto, or Ender owns the `$` variable.
   var $ = root.jQuery || root.Zepto || root.ender || root.$;
 
+
+  // Set the javascript library that will be used for the selector work
+  // (a.k.a. the `$` variable).
+  //
+  // By default Backbone will use: jQuery, Zepto, or Ender; but the `setDomLibrary()`
+  // method let's you inject an alternate javascript library (or a mock
+  // library for testing your views outside of a browser). This is also useful
+  // if you are using a packaging library -- to add support for `require()`
+  // calls in the browser (e.g. ender or browserify). The scoping used to
+  // support `require()`, prevents Backbone from automatically loading the
+  // default javascript library.
+  //
+  //     Backbone.setDomLibrary(jQuery)
+  //
+  Backbone.setDomLibrary = function(lib) {
+    $ = lib;
+  };
+
+
   // Runs Backbone.js in *noConflict* mode, returning the `Backbone` variable
   // to its previous owner. Returns a reference to this Backbone object.
   Backbone.noConflict = function() {

diff --git a/test/setdomlibrary.js b/test/setdomlibrary.js
@@ -0,0 +1,30 @@
+$(document).ready(function() {
+
+  // a mock object that looks sufficiently jQuery-ish
+  var myLib = function() {
+    return {
+      attr: function() { return "spam" },
+      html: function() { return "spam" },
+      hasClass: function() { return "spam" }
+    };
+  };
+
+  var viewAttrs = { id: 'test-setdomlibrary', className: 'test-setdomlibrary' }
+
+  module("Backbone.setDomLibrary");
+
+  test('Changing jQuery library to custom library', function() {
+    Backbone.setDomLibrary(myLib);
+    var view = new Backbone.View(viewAttrs);
+
+    ok(view.$el.hasClass('test-setdomlibrary') === 'spam');
+  });
+
+  test('Changing jQuery library back to global jQuery', function() {
+    Backbone.setDomLibrary(jQuery);
+    var view = new Backbone.View(viewAttrs);
+
+    ok(view.$el.hasClass('test-setdomlibrary'));
+  });
+
+});
diff --git a/test/test.html b/test/test.html
@@ -21,6 +21,7 @@
   <script type="text/javascript" src="view.js"></script>
   <script type="text/javascript" src="sync.js"></script>
   <script type="text/javascript" src="speed.js"></script>
+  <script type="text/javascript" src="setdomlibrary.js"></script>
 </head>
 <body>
   <h1 id="qunit-header">Backbone Test Suite</h1>