docs(jqLite): explain what monkey-patching jQuery.cleanData does

angular · May 11, 2014 · 7f5e0f0 · 7f5e0f0
1 parent d71dbb1
commit 7f5e0f0
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/src/Angular.js b/src/Angular.js
@@ -1449,6 +1449,9 @@ function bindJQuery() {
     // Prevent double-proxying.
     originalCleanData = originalCleanData.$$original || originalCleanData;
 
+    // All nodes removed from the DOM via various jQuery APIs like .remove()
+    // are passed through jQuery.cleanData. Monkey-patch this method to fire
+    // the $destroy event on all removed nodes.
     jQuery.cleanData = function(elems) {
       for (var i = 0, elem; (elem = elems[i]) != null; i++) {
         jQuery(elem).triggerHandler('$destroy');