+ saveAs & load

Author: RubaXa

README.md

@@ -207,15 +207,66 @@ FileAPI.event.on(el, 'change', function (evt/**Event*/){
 <a name="FileAPI.upload-short"></a>
 ### upload(url`:String`, files`:Mixed`[, opts`:Object`])`:XmlHttpRequestPromise`
 
-* url — a string containing the URL to which the request is sent.
+* url — a string containing the URL to which the request is sent
 * files — Array, Object or HTMLInput
 
 
 ```js
-FileAPI.upload('./ctpl.php', files).done(function (xhr){
-var result = FileAPI.parseJSON(xhr.responseText);
-// ...
-});
+FileAPI.upload('./ctpl.php', files)
+.progress(function (evt){
+var p = (evt.loaded / evt.total)
+})
+.done(function (xhr){
+var result = FileAPI.parseJSON(xhr.responseText);
+// ...
+})
+;
+```
+
+---
+
+<a name="FileAPI.load"></a>
+### load(url`:String`[, opts`:Object`])`:XmlHttpRequestPromise`
+Load a remote file, by default as `Blob`.
+
+* url — a string containing the URL to which the request is sent
+* opts — request options: { headers, data, withCredentials, responseType: "blob" }
+
+```js
+var xhr = FileAPI.load("/files/dino.png")
+.progress(function (evt/**Event*/, xhr/**XmlHttpRequest*/){
+var p = (evt.loaded / evt.total);
+})
+.done(function (blob/**Blob*/, xhr/**XmlHttpRequest*/){
+// Success
+})
+.fail(function (statusText, xhr/**XmlHttpRequest*/){
+alert('Error: '+statusText);
+})
+;
+```
+
+---
+
+<a name="FileAPI.saveAs"></a>
+### saveAs(file`:String|File|Blob`[, name`:String`])`:XmlHttpRequestPromise`
+Save file on disk.
+
+* file — a string containing the URL or File/Blob object
+* name — a file name
+
+```js
+FileAPI.saveAs("/files/dino.png")
+.progress(function (evt){
+var p = (evt.loaded / evt.total);
+})
+.done(function (){
+// Success
+})
+.fail(function (err){
+alert('Error: '+err);
+})
+;
 ```
 
 ---
@@ -1206,6 +1257,22 @@ Support dataURI as src for image.
 ### FileAPI.support.chunked`:Boolean`
 Support chuncked upload.
 
+<a name="FileAPI.support.saveAs"></a>
+### FileAPI.support.saveAs`:Boolean`
+Support `navigator.msSaveBlob`.
+
+<a name="FileAPI.support.download"></a>
+### FileAPI.support.download`:Boolean`
+Support for attribute `download` in `a[href]`.
+
+<a name="FileAPI.support.accept"></a>
+### FileAPI.support.accept`:Boolean`
+Support for attribute `accept` in `input[type="file"]`.
+
+<a name="FileAPI.support.multiple"></a>
+### FileAPI.support.multiple`:Boolean`
+Support for attribute `multiple` in `input[type="file"]`.
+
 ---
 
 <a name="flash"></a>

README.ru.md

@@ -210,10 +210,61 @@ FileAPI.event.on(el, 'change', function (evt/**Event*/){
 
 
 ```js
-FileAPI.upload('./ctpl.php', files).done(function (xhr){
-var result = FileAPI.parseJSON(xhr.responseText);
-// ...
-});
+FileAPI.upload('./ctpl.php', files)
+.progress(function (evt){
+var p = (evt.loaded / evt.total)
+})
+.done(function (xhr){
+var result = FileAPI.parseJSON(xhr.responseText);
+// ...
+})
+;
+```
+
+---
+
+<a name="FileAPI.load"></a>
+### load(url`:String`[, opts`:Object`])`:XmlHttpRequestPromise`
+Загрузить файл, по умолчанию как `Blob`.
+
+* url — строка содержащая путь к файлу
+* opts — опции запроса: { headers, data, withCredentials, responseType: "blob" }
+
+```js
+var xhr = FileAPI.load('./files/dino.png')
+.progress(function (evt/**Event*/, xhr/**XmlHttpRequest*/){
+var p = (evt.loaded / evt.total);
+})
+.done(function (blob/**Blob*/, xhr/**XmlHttpRequest*/){
+// Success
+})
+.fail(function (statusText, xhr/**XmlHttpRequest*/){
+alert('Error: '+statusText);
+})
+;
+```
+
+---
+
+<a name="FileAPI.saveAs"></a>
+### saveAs(file`:String|File|Blob`[, name`:String`])`:Promise`
+Сохранить файл на диск.
+
+* file — путь к файлу или File/Blob объект
+* name — имя файла
+
+```js
+FileAPI.saveAs("./files/dino.png")
+.progress(function (evt){
+var p = (evt.loaded / evt.total);
+})
+.done(function (){
+// Success
+})
+.fail(function (err){
+alert('Error: '+err);
+})
+;
 ```
 
 ---
@@ -1206,6 +1257,23 @@ FileAPI.Camera.publish(el, function (err, cam/**FileAPI.Camera*/){
 ### FileAPI.support.chunked`:Boolean`
 Возможность загрузки по частям.
 
+<a name="FileAPI.support.saveAs"></a>
+### FileAPI.support.saveAs`:Boolean`
+Поддержка `navigator.msSaveBlob`.
+
+<a name="FileAPI.support.download"></a>
+### FileAPI.support.download`:Boolean`
+Поддержка аттрибута `download` у `a[href]`.
+
+<a name="FileAPI.support.accept"></a>
+### FileAPI.support.accept`:Boolean`
+Поддержка аттрибута `accept` у `input[type="file"]`.
+
+<a name="FileAPI.support.multiple"></a>
+### FileAPI.support.multiple`:Boolean`
+Поддержка аттрибута `multiple` у `input[type="file"]`.
+
+
 ---
 
 <a name="flash"></a>