Added: more comments

Author: nerv

angular-file-upload.js

@@ -1,5 +1,5 @@
 /*
- Angular File Upload v0.3.2
+ Angular File Upload v0.3.3.1
  https://github.com/nervgh/angular-file-upload
 */
 (function(angular, factory) {
@@ -82,6 +82,11 @@ app.directive('ngFileSelect', [ '$fileUploader', function ($fileUploader) {
 app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', function ($compile, $rootScope, $http, $window) {
  'use strict';
 
+ /**
+ * Creates a uploader
+ * @param {Object} params
+ * @constructor
+ */
  function Uploader(params) {
  angular.extend(this, {
  scope: $rootScope,
@@ -119,11 +124,16 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
  }
 
  Uploader.prototype = {
+ /**
+ * Link to the constructor
+ */
+ constructor: Uploader,
 
  /**
  * The base filter. If returns "true" an item will be added to the queue
  * @param {File|Input} item
  * @returns {boolean}
+ * @private
  */
  _filter: function (item) {
  return angular.isElement(item) ? true : !!item.size;
@@ -152,6 +162,7 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
  /**
  * Checks a support the html5 uploader
  * @returns {Boolean}
+ * @readonly
  */
  isHTML5: !!($window.File && $window.FormData),
 
@@ -273,7 +284,6 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
  this[ transport ](item);
  },
 
-
  /**
  * Cancels uploading of item from the queue
  * @param {Item|Number} value
@@ -285,7 +295,6 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
  item[prop] && item[prop].abort();
  },
 
-
  /**
  * Uploads all not uploaded items of queue
  */
@@ -300,7 +309,6 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
  items.length && this.uploadItem(items[ 0 ]);
  },
 
-
  /**
  * Cancels all uploads
  */
@@ -310,7 +318,6 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
  }, this);
  },
 
-
  /**
  * Updates angular scope
  * @private
@@ -319,11 +326,11 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
  this.scope.$$phase || this.scope.$digest();
  },
 
-
  /**
  * Returns the total progress
  * @param {Number} [value]
  * @returns {Number}
+ * @private
  */
  _getTotalProgress: function (value) {
  if (this.removeAfterUpload) {
@@ -340,6 +347,7 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
 
  /**
  * The 'in:progress' handler
+ * @private
  */
  _progress: function (event, item, progress) {
  var result = this._getTotalProgress(progress);
@@ -350,6 +358,7 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
 
  /**
  * The 'in:complete' handler
+ * @private
  */
  _complete: function () {
  var item = this.getReadyItems()[ 0 ];
@@ -367,6 +376,7 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
 
  /**
  * The XMLHttpRequest transport
+ * @private
  */
  _xhrTransport: function (item) {
  var xhr = item._xhr = new XMLHttpRequest();
@@ -416,6 +426,7 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
 
  /**
  * The IFrame transport
+ * @private
  */
  _iframeTransport: function (item) {
  var form = angular.element('<form style="display: none;" />');
@@ -446,7 +457,7 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
 
  iframe.bind('load', function () {
  // fixed angular.contents() for iframes
- var html = (iframe[0].contentDocument || iframe[0].contentWindow.document).body.innerHTML;
+ var html = iframe[0].contentDocument.body.innerHTML;
  var xhr = { response: html, status: 200, dummy: true };
  var response = that._transformResponse(xhr.response);
  that.trigger('in:success', xhr, item, response);
@@ -467,21 +478,21 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
  form[ 0 ].submit();
  },
 
-
  /**
  * Checks whether upload successful
  * @param {Number} status
  * @returns {Boolean}
+ * @private
  */
  _isSuccessCode: function(status) {
  return (status >= 200 && status < 300) || status === 304;
  },
 
-
  /**
  * Transforms the server response
  * @param {*} response
  * @returns {*}
+ * @private
  */
  _transformResponse: function (response) {
  $http.defaults.transformResponse.forEach(function (transformFn) {
@@ -492,7 +503,11 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
  };
 
 
- // item of queue
+ /**
+ * Create a item
+ * @param {Object} params
+ * @constructor
+ */
  function Item(params) {
  // fix for old browsers
  if (!Uploader.prototype.isHTML5) {
@@ -524,22 +539,46 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
  }, params);
  }
 
+
  Item.prototype = {
+ /**
+ * Link to the constructor
+ */
+ constructor: Item,
+ /**
+ * Removes a item
+ */
  remove: function () {
  this.uploader.removeFromQueue(this);
  },
+ /**
+ * Uploads a item
+ */
  upload: function () {
  this.uploader.uploadItem(this);
  },
+ /**
+ * Cancels uploading
+ */
  cancel: function() {
  this.uploader.cancelItem(this);
  },
+ /**
+ * Destroys form and input
+ * @private
+ */
  _destroy: function() {
  this._form && this._form.remove();
  this._input && this._input.remove();
  delete this._form;
  delete this._input;
  },
+ /**
+ * The 'beforeupload' handler
+ * @param {Object} event
+ * @param {Item} item
+ * @private
+ */
  _beforeupload: function (event, item) {
  item.isReady = true;
  item.isUploading = true;
@@ -549,10 +588,25 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
  item.isError = false;
  item.progress = 0;
  },
+ /**
+ * The 'in:progress' handler
+ * @param {Object} event
+ * @param {Item} item
+ * @param {Number} progress
+ * @private
+ */
  _progress: function (event, item, progress) {
  item.progress = progress;
  item.uploader.trigger('progress', item, progress);
  },
+ /**
+ * The 'in:success' handler
+ * @param {Object} event
+ * @param {XMLHttpRequest} xhr
+ * @param {Item} item
+ * @param {*} response
+ * @private
+ */
  _success: function (event, xhr, item, response) {
  item.isReady = false;
  item.isUploading = false;
@@ -564,6 +618,13 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
  item.index = null;
  item.uploader.trigger('success', xhr, item, response);
  },
+ /**
+ * The 'in:cancel' handler
+ * @param {Object} event
+ * @param {XMLHttpRequest} xhr
+ * @param {Item} item
+ * @private
+ */
  _cancel: function(event, xhr, item) {
  item.isReady = false;
  item.isUploading = false;
@@ -575,6 +636,14 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
  item.index = null;
  item.uploader.trigger('cancel', xhr, item);
  },
+ /**
+ * The 'in:error' handler
+ * @param {Object} event
+ * @param {XMLHttpRequest} xhr
+ * @param {Item} item
+ * @param {*} response
+ * @private
+ */
  _error: function (event, xhr, item, response) {
  item.isReady = false;
  item.isUploading = false;
@@ -586,6 +655,14 @@ app.factory('$fileUploader', [ '$compile', '$rootScope', '$http', '$window', fun
  item.index = null;
  item.uploader.trigger('error', xhr, item, response);
  },
+ /**
+ * The 'in:complete' handler
+ * @param {Object} event
+ * @param {XMLHttpRequest} xhr
+ * @param {Item} item
+ * @param {*} response
+ * @private
+ */
  _complete: function (event, xhr, item, response) {
  item.uploader.trigger('complete', xhr, item, response);
  item.removeAfterUpload && item.remove();

angular-file-upload.min.js

@@ -1,6 +1,6 @@
 {
  "name": "angular-file-upload",
- "version": "0.3.2",
+ "version": "0.3.3.1",
  "main": "angular-file-upload.js",
  "homepage": "https://github.com/nervgh/angular-file-upload",
  "ignore": [],

angular-file-upload.min.map

@@ -1,6 +1,6 @@
 {
  "name": "Angular File Upload",
- "version": "0.3.2",
+ "version": "0.3.3.1",
  "homepage": "https://github.com/nervgh/angular-file-upload",
  "description": "Angular File Upload is a module for the AngularJS framework",
  "author": {

bower.json

@@ -1,6 +1,6 @@
 /**
  * The angular file upload module
  * @author: nerv
- * @version: 0.3.3, 2014-02-18
+ * @version: 0.3.3.1, 2014-02-28
  */
 var app = angular.module('angularFileUpload', []);

package.json

@@ -1,7 +1,7 @@
 /**
  * The angular file upload module
  * @author: nerv
- * @version: 0.3.3, 2014-02-18
+ * @version: 0.3.3.1, 2014-02-28
  */
 
 // It is attached to an element that catches the event drop file

src/scripts/app.js

@@ -1,7 +1,7 @@
 /**
  * The angular file upload module
  * @author: nerv
- * @version: 0.3.3, 2014-02-18
+ * @version: 0.3.3.1, 2014-02-28
  */
 
 // It is attached to an element which will be assigned to a class "ng-file-over" or ng-file-over="className"

src/scripts/directives/ngFileDrop.js

@@ -1,7 +1,7 @@
 /**
  * The angular file upload module
  * @author: nerv
- * @version: 0.3.3, 2014-02-18
+ * @version: 0.3.3.1, 2014-02-28
  */
 
 // It is attached to <input type="file"> element like <ng-file-select="options">