$.select() and $.first()

timmywil · Jan 2, 2012 · 61092e9 · 61092e9
1 parent cf0eed4
commit 61092e9
Show file tree

Hide file tree

Showing 2 changed files with 36 additions and 4 deletions.
diff --git a/lib/ender/bridge.js b/lib/ender/bridge.js
@@ -62,8 +62,11 @@
   }
 
   $.ender({
+      // boolean, does at least one element in the collection match the given selector
       is: is
     , match: is
+      // find all elements that are children of the elements in this collection matching
+      // the given selector
     , find: function (s) {
         var r = [], i, l, j, k, els
         for (i = 0, l = this.length; i < l; i++) {
@@ -72,13 +75,26 @@
         }
         return $(uniq(r))
       }
-    , and: function (s) {
-        var plus = $(s)
+      // add additional elements to this collection matching the given selector
+    , and: function (s, r) {
+        var plus = $(s, r)
         for (var i = this.length, j = 0, l = this.length + plus.length; i < l; i++, j++) {
           this[i] = plus[j]
         }
         return this
       }
   }, true)
 
+  $.ender({
+      // allow for NW.Dom.select(selector, root, callback), for speedy code such as
+      // $.select("div", null, function ( e ) { e.style.backgroundColor = "#ffe"; });
+      select: function () {
+        return $(nw.select.apply(null, arguments))
+      }
+      // like querySelector(), return only the first match, document-order
+    , first: function (selector, root) {
+        return $(nw.select(selector, root, function() { return false }))
+      }
+  })
+
 }(document, ender)
diff --git a/test/ender/ender.js b/test/ender/ender.js
@@ -1778,8 +1778,11 @@
     }
 
     $.ender({
+        // boolean, does at least one element in the collection match the given selector
         is: is
       , match: is
+        // find all elements that are children of the elements in this collection matching
+        // the given selector
       , find: function (s) {
           var r = [], i, l, j, k, els
           for (i = 0, l = this.length; i < l; i++) {
@@ -1788,15 +1791,28 @@
           }
           return $(uniq(r))
         }
-      , and: function (s) {
-          var plus = $(s)
+        // add additional elements to this collection matching the given selector
+      , and: function (s, r) {
+          var plus = $(s, r)
           for (var i = this.length, j = 0, l = this.length + plus.length; i < l; i++, j++) {
             this[i] = plus[j]
           }
           return this
         }
     }, true)
 
+    $.ender({
+        // allow for NW.Dom.select(selector, root, callback), for speedy code such as
+        // $.select("div", null, function ( e ) { e.style.backgroundColor = "#ffe"; });
+        select: function () {
+          return $(nw.select.apply(null, arguments))
+        }
+        // like querySelector(), return only the first match, document-order
+      , first: function (selector, root) {
+          return $(nw.select(selector, root, function() { return false }))
+        }
+    })
+
   }(document, ender)