ng-file-upload教程

一、ng-file-upload简介
  是一款轻量级、跨浏览器的angular上传文件指令
二、特点
  (1)支持文件上传进度条、取消、暂停
  (2)支持文件拖放和黏贴图像
  (3)支持暂停和取消文件上传
  (4)支持验证文件的类型 / 大小、图像宽度 / 高度、视频 / 音频持续时间(ng-required)
  (5)支持预览显示选择的图像、视频、音频
  (6)支持CORS和直接上传文件的二进制数据( Upload.$http() )
  .....
三、用法
  示例:
html:

  <script src="angular.min.js"></script>
  <!-- shim is needed to support non-HTML5 FormData browsers (IE8-9)--> 
  <script src="ng-file-upload-shim.min.js"></script> 
  <script src="ng-file-upload.min.js"></script> 

  <div ng-app="fileUpload" ng-controller="MyCtrl"> watching model: 
     <div class="button" ngf-select ng-model="file">Upload using model $watch</div>
     <div class="button" ngf-select ng-model="files" ngf-multiple="true" ngf-accept="'image/*" accept="image/*">Upload multiple images using model $watch</div> 
     <div class="button" ngf-select ngf-change="upload($file)">Upload on file change</div> 
     <div class="button" ngf-select ngf-change="upload($files)" ngf-multiple="true" ngf-validate="{size: {min:'10KB', max:'20MB'}}">Upload multiple with size limitation</div> 
     Drop File: 
     <div ngf-drop ng-model="files" class="drop-box" ngf-drag-over-class="dragover" ngf-multiple="true" ngf-allow-dir="true" ngf-accept="'image/*,application/pdf'">Drop Images or PDFs files here</div>
     <div ngf-no-file-drop>File Drag/Drop is not supported for this browser</div>
     Image thumbnail: ![](file || '/thumb.jpg')
     Audio preview: <audio controls ngf-src="file"></audio> 
     Video preview: <video controls ngf-src="file"></video>
  </div>

JS:

//inject directives and services. 
var app = angular.module('fileUpload', ['ngFileUpload']); 
app.controller('MyCtrl', ['$scope', 'Upload', function ($scope, Upload) { 
    $scope.$watch('file', function (file) { 
        $scope.upload($scope.file); 
    }); 
/* optional: set default directive values */ 
//Upload.setDefaults( {ngf-keep:false ngf-accept:'image/*', ...} );
$scope.upload = function (file) { 
    Upload.upload(
        { 
            url: 'upload/url', 
            fields: {'username': $scope.username}, file: file 
        })
        .progress(function (evt) { 
            var progressPercentage = parseInt(100.0 * evt.loaded / evt.total); 
            console.log('progress: ' + progressPercentage + '% ' + evt.config.file.name); 
        })
        .success(function (data, status, headers, config) { 
            console.log('file ' + config.file.name + 'uploaded. Response: ' + data); 
        })
        .error(function (data, status, headers, config) { 
            console.log('error status: ' + status); 
        })
     }; 
}]);

涉及参数:
  (1)文件选择:----适用于:<button>、<div>、<input type=file>
    ngf-select=“true”:默认为true,使得在这个元素上可以选择文件
    ng-model="myfiles":将选择的一个或多个文件与scope模型绑定(通过ngf-multiple和ngf-keep的值可以使得ng-model的值为一个数组或单个文件)
    ng-model-rejected="rejfiles":与不匹配接受通配符的丢弃文件绑定
    ng-disabled="selectDisabled":与一个boolean值绑定,来决定是否禁用文件选择功能
    ngf-change="fileSelected($files, $file, $event, $rejectedFiles)":当文件被选择或移除时调用
    ngf-multiple="true":默认为false,为true时表示可以选择多个文件
    ngf-capture="'camera'" or "'other'":允许移动设备使用相机捕获
    accept="image/*":标准的HTML文件接受的输入属性(依赖于浏览器)
    ngf-accept=" 'image/*' ":用逗号分隔允许的MIME类型来过滤文件

ngf-validate="{
     size: {min: 10, max: '20MB'},
     width: {min: 100, max:10000}, 
     height: {min: 100, max: 300}, 
     duration: {min: '10s', max: '5m'}, 
     accept: '.jpg'
 }" //  或者 "validate($file)"
    ```
    `ngf-keep="true" or "false"`:默认为false,保存着以前ng-model的值和追加的新文件
    `ngf-keep-distinct="true" or "false"`:默认为false,如果ngf-keep设置了的话,则删除重复的选定文件
    `ngf-reset-on-click="true" or "false"`:默认为true,可以重置模型和点击输入
    `ngf-reset-model-on-click="true" or "false"`:默认为true,单击时重置模型
   (2)文件删除:----适用于:<button>、<div>
>注:除了ngf-drop 、ng-model 、 ngf-change之一,其余属性都是可选的

    `ngf-drop="true" or "false" `:默认为true,使得在该元素上可以删除文件
    `ng-model="myFiles"`:把被删除的文件与scope模型绑定(通过ngf-multiple和ngf-keep的值可以使得ng-model的值为一个数组或单个文件)
    `ng-model-rejected="rejFiles"`:与不符合通配合而被删除的文件绑定
    `ng-disabled="dropDisabled"`:与一个boolean值绑定,来决定是否禁用文件删除功能
    `ngf-change="fileDropped($files, $file, $event, $rejectedFiles)" `:当文件被删除时调用
    `ngf-multiple="true" or "false"`:默认为false,为true时表示可以选择多个文件
    `ngf-accept="'.pdf,.jpg'"`:用逗号分隔允许的MIME类型来过滤文件
```javascript
ngf-validate="{
     size: {min: 10, max: '20MB'},
     width: {min: 100, max:10000}, 
     height: {min: 100, max: 300}, 
     duration: {min: '10s', max: '5m'}, 
     accept: '.jpg'
 }" //  或者 "validate($file)"
    ```
    `ngf-allow-dir="true" or "false"`:默认为true,但只在goole浏览器下可以删除
```javascript
  
ngf-drag-over-class="{
    accept:'acceptClass', 
    reject:'rejectClass', 
    delay:100
}" //or "myDragOverClass" or "calcDragOverClass($event)" 
//拖动css类行为:可以是一个字符串,也可以是一个函数(返回一个类名)或者是一个json对象{accept: 'c1', reject: 'c2', delay:10},默认是 "dragover".  accept和reject只可以在chrome浏览器并且要通过ngf-accept的检测才可以工作,

ngf-drop-available="dropSupported":设置scope模型的值为真或假(基于文件的拖拽和释放)
   ngf-stop-propagation="true" or "false":默认为false,是否传播拖拽和释放事件
  ngf-hide-on-drop-not-available="true" or "false":默认为false,当文件的拖拽和释放不被支持时隐藏元素

(3)文件预览-----适用于<img/>、<audio>、<video>
    ngf-src="file":通过设置url,预览被选择的文件
   ngf-background="file":设置背景图片的样式
   ngf-no-object-url="true or false":默认为false,强制生成base64url而不是对象url
更多详情参考:https://www.awesomes.cn/repo/danialfarid/ng-file-upload

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,340评论 5 467
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,762评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,329评论 0 329
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,678评论 1 270
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,583评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 47,995评论 1 275
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,493评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,145评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,293评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,250评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,267评论 1 328
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,973评论 3 316
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,556评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,648评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,873评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,257评论 2 345
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,809评论 2 339

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,559评论 18 139
  • 中文翻译 ng help ng build 构建您的应用程序并将其放入输出路径(dist /默认情况下)。 别名:...
    4ea0af17fd67阅读 1,993评论 0 0
  • ¥开启¥ 【iAPP实现进入界面执行逐一显】 〖2017-08-25 15:22:14〗 《//首先开一个线程,因...
    小菜c阅读 6,335评论 0 17
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,531评论 18 399
  • 没经本人同意,降临这世上,是不是孤独? 父母望子成龙,孩子希望自己非富即贵, 爱的人想得不可得,身边的人却死水微澜...
    青青橙阅读 304评论 0 2