Merge pull request #171 from fieg/ajax

Ajax improvements and more

Author: fieg

README.md

@@ -1,4 +1,4 @@
-Infinite Ajax Scroll
+Infinite AJAX Scroll
 ====================
 
 A jQuery plugin to turn your paginated pages into infinite scrolling pages with ease.

doc/methods.md

@@ -11,7 +11,7 @@ jQuery.ias().bind();
 
 ### destroy
 
-Alias of [unbind](methods.html#unbind) method.
+Unbinds and destroys instance.
 
 ### extension
 
@@ -29,6 +29,14 @@ Initializes Infinite AJAX Scroll. Normally this happens when the DOM is ready (`
 jQuery.ias().initialize();
 ```
 
+### reinitialize
+
+Reinitializes Infinite AJAX Scroll after a DOM update. DOM updates could be made by page updates via AJAX, like changing the sorting of a list, or filtering a result.
+
+```javascript
+jQuery.ias().reinitialize();
+```
+
 ### next
 
 Loads the next page.

src/callbacks.js

@@ -23,13 +23,16 @@ var IASCallbacks = function () {
     var context = args[0],
         deferred = args[1],
         callbackArguments = args[2];
+
     this.isFiring = true;
 
     for (var i = 0, l = this.list.length; i < l; i++) {
-      if (false === this.list[i].fn.apply(context, callbackArguments)) {
-        deferred.reject();
+      if (this.list[i] != undefined) {
+        if (false === this.list[i].fn.apply(context, callbackArguments)) {
+          deferred.reject();
 
-        break;
+          break;
+        }
       }
     }
 

src/extension/history.js

@@ -25,13 +25,11 @@ var IASHistoryExtension = function (options) {
    * @param url
    */
   this.onPageChange = function (pageNum, scrollOffset, url) {
-    var state = {};
-
     if (!window.history || !window.history.replaceState) {
       return;
     }
 
-    state = history.state;
+    var state = history.state;
 
     history.replaceState(state, document.title, url);
   };
@@ -55,6 +53,17 @@ var IASHistoryExtension = function (options) {
     }
   };
 
+  this.onReady = function () {
+    var currentScrollOffset = this.ias.getCurrentScrollOffset(this.ias.$scrollContainer),
+        firstItemScrollThreshold = this.getScrollThresholdFirstItem();
+
+    currentScrollOffset -= this.ias.$scrollContainer.height();
+
+    if (currentScrollOffset <= firstItemScrollThreshold) {
+      this.prev();
+    }
+  };
+
   /**
    * Returns the url for the next page
    *
@@ -83,7 +92,7 @@ var IASHistoryExtension = function (options) {
 
     // if the don't have a first element, the DOM might not have been loaded,
     // or the selector is invalid
-    if (0 === $firstElement.size()) {
+    if (0 === $firstElement.length) {
       return -1;
     }
 
@@ -150,20 +159,19 @@ IASHistoryExtension.prototype.initialize = function (ias) {
  * @param ias
  */
 IASHistoryExtension.prototype.bind = function (ias) {
-  var self = this;
-
   ias.on('pageChange', jQuery.proxy(this.onPageChange, this));
   ias.on('scroll', jQuery.proxy(this.onScroll, this));
-  ias.on('ready', function () {
-    var currentScrollOffset = ias.getCurrentScrollOffset(ias.$scrollContainer),
-        firstItemScrollThreshold = self.getScrollThresholdFirstItem();
-
-    currentScrollOffset -= ias.$scrollContainer.height();
+  ias.on('ready', jQuery.proxy(this.onReady, this));
+};
 
-    if (currentScrollOffset <= firstItemScrollThreshold) {
-      self.prev();
-    }
-  });
+/**
+ * @public
+ * @param {object} ias
+ */
+IASHistoryExtension.prototype.unbind = function(ias) {
+  ias.off('pageChange', this.onPageChange);
+  ias.off('scroll', this.onScroll);
+  ias.off('ready', this.onReady);
 };
 
 /**
@@ -180,7 +188,7 @@ IASHistoryExtension.prototype.prev = function () {
     return false;
   }
 
-  ias.unbind();
+  ias.pause();
 
   var promise = ias.fire('prev', [url]);
 
@@ -189,7 +197,7 @@ IASHistoryExtension.prototype.prev = function () {
       self.renderBefore(items, function () {
         self.prevUrl = self.getPrevUrl(data);
 
-        ias.bind();
+        ias.resume();
 
         if (self.prevUrl) {
           self.prev();
@@ -199,7 +207,7 @@ IASHistoryExtension.prototype.prev = function () {
   });
 
   promise.fail(function () {
-    ias.bind();
+    ias.resume();
   });
 
   return true;

src/extension/noneleft.js

@@ -38,6 +38,14 @@ IASNoneLeftExtension.prototype.bind = function(ias) {
   ias.on('noneLeft', jQuery.proxy(this.showNoneLeft, this));
 };
 
+/**
+ * @public
+ * @param {object} ias
+ */
+IASNoneLeftExtension.prototype.unbind = function(ias) {
+  ias.off('noneLeft', this.showNoneLeft);
+};
+
 /**
  * @public
  */

src/extension/paging.js

@@ -118,6 +118,19 @@ IASPagingExtension.prototype.bind = function(ias) {
   ias.on('scroll', jQuery.proxy(this.onScroll, this), this.priority);
 };
 
+/**
+ * @public
+ * @param {object} ias
+ */
+IASPagingExtension.prototype.unbind = function(ias) {
+  try {
+    ias.off('prev', this.onPrev);
+  } catch (exception) {}
+
+  ias.off('next', this.onNext);
+  ias.off('scroll', this.onScroll);
+};
+
 /**
  * Returns current page number based on scroll offset
  *

src/extension/spinner.js

@@ -53,7 +53,7 @@ var IASSpinnerExtension = function(options) {
   this.getSpinner = function() {
     var $spinner = jQuery('#ias_spinner_' + this.uid);
 
-    if ($spinner.size() > 0) {
+    if ($spinner.length > 0) {
       return $spinner;
     }
 
@@ -66,7 +66,7 @@ var IASSpinnerExtension = function(options) {
   this.hasSpinner = function() {
     var $spinner = jQuery('#ias_spinner_' + this.uid);
 
-    return ($spinner.size() > 0);
+    return ($spinner.length > 0);
   };
 
   /**
@@ -90,12 +90,24 @@ IASSpinnerExtension.prototype.bind = function(ias) {
   this.ias = ias;
 
   ias.on('next', jQuery.proxy(this.showSpinner, this));
+  ias.on('render', jQuery.proxy(this.removeSpinner, this));
 
   try {
     ias.on('prev', jQuery.proxy(this.showSpinnerBefore, this));
   } catch (exception) {}
+};
 
-  ias.on('render', jQuery.proxy(this.removeSpinner, this));
+/**
+ * @public
+ * @param {object} ias
+ */
+IASSpinnerExtension.prototype.unbind = function(ias) {
+  ias.off('next', this.showSpinner);
+  ias.off('render', this.removeSpinner);
+
+  try {
+    ias.off('prev', this.showSpinnerBefore);
+  } catch (exception) {}
 };
 
 /**

src/extension/trigger.js

@@ -58,6 +58,10 @@ var IASTriggerExtension = function(options) {
     return false;
   };
 
+  this.onRendered = function() {
+    this.enabled = true;
+  };
+
   /**
    * @param clickCallback
    * @returns {*|jQuery}
@@ -88,20 +92,33 @@ IASTriggerExtension.prototype.bind = function(ias) {
 
   this.ias = ias;
 
+  ias.on('next', jQuery.proxy(this.showTriggerNext, this), this.priority);
+  ias.on('rendered', jQuery.proxy(this.onRendered, this), this.priority);
+
   try {
     ias.on('prev', jQuery.proxy(this.showTriggerPrev, this), this.priority);
   } catch (exception) {}
+};
 
-  ias.on('next', jQuery.proxy(this.showTriggerNext, this), this.priority);
-  ias.on('rendered', function () { self.enabled = true; }, this.priority);
+/**
+ * @public
+ * @param {object} ias
+ */
+IASTriggerExtension.prototype.unbind = function(ias) {
+  ias.off('next', this.showTriggerNext);
+  ias.off('rendered', this.onRendered);
+
+  try {
+    ias.off('prev', this.showTriggerPrev);
+  } catch (exception) {}
 };
 
 /**
  * @public
  */
 IASTriggerExtension.prototype.next = function() {
   this.enabled = false;
-  this.ias.unbind();
+  this.ias.pause();
 
   if (this.$triggerNext) {
     this.$triggerNext.remove();
@@ -116,7 +133,7 @@ IASTriggerExtension.prototype.next = function() {
  */
 IASTriggerExtension.prototype.prev = function() {
   this.enabled = false;
-  this.ias.unbind();
+  this.ias.pause();
 
   if (this.$triggerPrev) {
     this.$triggerPrev.remove();