ajaxImageUpload——一个jQuery图片批量上传插件

ajaxImageUpload

原创jQuery图片上传插件，支持批量上传、预览、删除、放大、上传数量、上传大小、追加方式配置以及上传前、上传中和上传后的回调函数。

演示地址：http://www.gouguoyin.cn/ajaxImageUpload/demo

使用方法

一、先引入jquery和插件的css和js，注意先引入jquery

<link href="./css/upload.min.css" type="text/css" rel="stylesheet" />
<script src="https://cdn.staticfile.org/jquery/3.1.0/jquery.min.js"></script>
<script src="./js/upload.min.js"></script>

二、HTML结构

<div class="upload-box1"></div>

<div class="upload-box2"></div>

三、插件配置

$(".upload-box1").ajaxImageUpload({
    fileInput: 'file1', //上传按钮名，即input[type=file]的name值
    ajaxUrl: './upload1.php', //上传的服务器地址
});

$(".upload-box2").ajaxImageUpload({
    fileInput: 'file2', //上传按钮名，即input[type=file]的name值
    ajaxUrl: './upload2.php', //上传的服务器地址
});

四、服务端处理

服务端处理没有特殊的限制，只要服务端接受file表单提交的数据处理后返回json格式数据，上传成功返回的json数据里必须含有code和src，其中code必须为200，src是上传后的图片url，上传失败返回的json数据里必须含有code和msg，其中code为错误码(不能是200)，msg为错误信息。

以./upload1.php为例

$file = $_FILES["file1"]; // 要和配置里的fileInput保持一致
if(!isset($file['tmp_name']) || !$file['tmp_name']) {
    echo json_encode(['code' => 401, 'msg' => '没有文件上传']);
    return false;
}
if($file["error"] > 0) {
    echo json_encode(['code' => 402, 'msg' => $file["error"]]);
    return false;
}

$upload_path = dirname(__FILE__) . "/uploads/";
$file_path   = "./uploads/";

if(!is_dir($upload_path)){
    echo json_encode(['code' => 403, 'msg' => '上传目录不存在']);
    return false;
}

if(move_uploaded_file($file["tmp_name"], $upload_path.$file['name'])){
    echo json_encode(['code' => 200, 'src' => $file_path.$file['name']]);
    return true;
}else{
    echo json_encode(['code' => 404, 'msg' => '上传失败']);
    return false;
}

参数说明

| 配置项 | 配置说明 | 必选 | 默认值 |
| --- | --- | --- | --- |
| fileInput | 上传按钮名，即input[type=file]的name值 | 是 | |
| ajaxUrl | ajax请求地址 | 是 | |
| imageUrl | 已上传的图片链接 | 否 | [] |
| ajaxData | 额外携带的json数据 | 否 | {} |
| allowZoom | 是否容许放大 | 否 |true |
| allowType | 容许上传图片的类型 | 否 | ["gif", "jpeg", "jpg", "bmp", "png"] |
| maxNum | 容许上传图片数量 | 否 | 3 |
| maxSize | 容许上传图片的最大尺寸，单位M | 否 |2 |
| appendMethod | 图片追加方式，before/after | 否 | before |
| before | 上传前回调函数 | 否 | |
| success | 单次上传成功回调函数 | 否 | |
| complete | 所有上传成功回调函数 | 否 | |
| error | 上传失败回调函数 | 否 | |

更新日志

2020-03-25

• 重写CSS样式，CSS类名前加ggy_前缀，以防止CSS污染
• 支持同一个页面屡次使用
• 解决同一个文件二次上传无效的问题
• 解决上传图片验证失败后必须刷新页面才能从新上传的问题
• 新增批量上传功能
• 新增批量上传成功回调函数complete，在全部图片上传成功后会触发
• 新增追加方式配置参数appendMethod，能够指定上传图片在已有图片前面追加仍是后面追加
• 新增已上传图片配置参数imageUrl，该参数主要用于编辑时展现以前已经上传的图片

Todo List

• [x] 批量上传
• [x] 图片缩放
• [ ] 去掉jquery依赖
• [ ] 裁剪压缩
• [ ] 拖拽排序