Options

data: {
  id: '123'
}

data: {
  id: function(){
    return $('#id').val();
  },
  id2: function(index, file){ // 参数支持。2.9.3+ 
    // 注：当 unified:true 和 ie8/9 下，参数无效
    console.log(index); // 得到文件索引
    console.log(file); // 得到文件对象
  }
}

acceptMime: 'image/*'` // 筛选所有图片类型
acceptMime: 'image/jpeg, image/png` // 只筛选 jpg,png 格式图片

text: { // 自定义提示文本
  "data-format-error": "", // 数据格式错误的提示
  "check-error": "", // 文件格式校验失败的提示
  "error": "", // 上传失败的提示
  "limit-number": null, // 限制 number 属性的提示。若设置，需为函数写法
  "limit-size": null, // 限制 size 属性的提示。若设置，需为函数写法
  "cross-domain": "", // IE 下跨域的提示
}

choose: function(obj){
  // 将每次选择的文件追加到文件队列
  var files = obj.pushFile();
  
  // 预读本地文件，如果是多文件，则会遍历。(不支持ie8/9)
  obj.preview(function(index, file, result){
    console.log(index); // 得到文件索引
    console.log(file); // 得到文件对象
    console.log(result); // 得到文件base64编码，比如图片
    
    // obj.resetFile(index, file, '123.jpg'); // 重命名文件名
    
    // 这里还可以做一些 append 文件列表 DOM 的操作
    
    // obj.upload(index, file); // 对上传失败的单个文件重新上传，一般在某个事件中使用
    // delete files[index]; //删除列表中对应的文件，一般在某个事件中使用
  });
}

// 获取本次选取的文件，大文件建议用此方法获取文件信息(2.9.9+)
obj.getChooseFiles();

before: function(obj){ // obj 参数同 choose
  layer.load(); // 上传 loading
  
  // 若返回 false，则表明阻止上传
  /*
  if(true){
    return false;
  }
  */
}

// 返回 jQuery Deferred 对象或 JS 原生 Promise 对象，false 或 Promise.reject 表明阻止上传(2.9.11+)
// Promise
/** @type {(obj: object) => boolean | JQueryDeferred<boolean> | Promise<boolean>} */
before: function(obj){
  return new Promise(function(resolve, reject){
    setTimeout(function(){
      console.log('before_async_task', obj);
      resolve(true);
    }, 1000)
  })
}

// Deferred
before: function(obj){
  return $.Deferred(function(defer){
    setTimeout(function(){
      console.log('before_async_task', obj);
      defer.resolve(true);
    }, 1000)
  }).promise();
}

// Deferred2
before: function(obj){
  var defer = $.Deferred();
  setTimeout(function(){
    console.log('before_async_task', obj);
    defer.resolve(true);
  }, 1000)
  return defer.promise();
}

progress: function(n, elem, res, index){
  var percent = n + '%' // 获取进度百分比
  element.progress('demo', percent); // 可配合 layui 进度条元素使用
  
  // 得到当前触发的元素 DOM 对象
  console.log(elem); // 可通过该元素定义的属性值匹配到对应的进度条。
  console.log(res); // 得到 progress 响应信息
  
  console.log(index); // 得到当前上传文件的索引，多文件上传时的进度条控制
  element.progress('demo-'+ index, n + '%'); // 进度条
}

done: function(res, index, upload){
  // 假设 `code: 0` 代表上传成功
  if(res.code == 0){
    // do something // 比如将 res 返回的图片链接保存到隐藏域
  }
  
  // 获取当前触发上传的元素，一般用于 elem 绑定 class 的情况
  var item = this.item;
  
  // …
}

allDone: function(obj){
  console.log(obj.total); // 上传的文件总数
  console.log(obj.successful); // 上传成功的文件数
  console.log(obj.failed); // 上传失败的文件数
}

error: function(index, upload, res, xhr){
  console.log(index); // 当前文件的索引
  // upload(); 重新上传的方法
  console.log(res);  // 返回值（纯文本）
  console.log(JSON.parse(res));  // 返回值（json）
  console.log(xhr);
}