1 Star 0 Fork 0

mdoo / ajax-image-upload

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
README.md 6.01 KB
一键复制 编辑 原始数据 按行查看 历史
mdoo 提交于 2023-08-07 07:19 . update README.md.

ajaxImageUpload

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

如果您觉得对您有用的话,别忘了给点个赞哦^_^ !

上传前

演示截图

上传后

演示截图

使用方法

  • 1、先引入jquery和插件的css和js,注意先引入jquery
<link href="./css/jquery.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/jquery.upload.min.js"></script>
  • 2、HTML结构
<div class="upload-box1"></div>

<div class="upload-box2"></div>
  • 3、插件配置
$(".upload-box1").ajaxImageUpload({
    fileInput: 'file1', //上传按钮名,即input[type=file]的name值
    postUrl: './upload1.php', //上传的服务器地址
});

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

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

以./upload1.php为例,auto为true

$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/" . date('Ymd/');
$file_path   = "./uploads/" . date('Ymd/');

if(!is_dir($upload_path) && !mkdir($upload_path, 0777, true)){
    echo json_encode(array('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;
}

如果auto等于false

$file = $_FILES["file1__tmp"]; // 要和配置里的fileInput后加_tmp
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/" . date('Ymd/');
$file_path   = "./uploads/" . date('Ymd/');

if(!is_dir($upload_path) && !mkdir($upload_path, 0777, true)){
    echo json_encode(array('code' => 403, 'msg' => '上传目录创建失败,请确认是否有权限'));
    return false;
};

if(move_uploaded_file($file["tmp_name"][0], $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值
postUrl post请求地址
auto 是否有文件选择即开始上传 true
uploadButton 图片达到最多允许的上传个数后,是否显示上传按钮 true
width 图片宽度 150
height 图片高度 150
imageUrl 已上传的图片连接 []
postData 额外携带的json数据 {}
allowZoom 是否允许放大 true
allowType 允许上传图片的类型 ["gif", "jpeg", "jpg", "bmp", "png"]
maxNum 允许上传图片数量 3
maxSize 允许上传图片的最大尺寸,单位M 2
appendMethod 图片追加方式,before/after before
before 上传前回调函数
success 单次上传成功回调函数
complete 全部上传成功回调函数
delete 删除图片回调函数
error 上传失败回调函数

更新日志

2023-07-06
  • 新增auto参数,用于控制是否选择图片即开始上传
  • 新增uploadButton参数,图片达到最多允许的上传个数后,是否显示上传按钮
2021-07-05
  • 新增delete()回调函数
2020-04-30
  • ajaxUrl参数改名为postUrl
  • ajaxData参数改名为postData
  • 新增width参数,用于控制上传后显示图片的宽度
  • 新增height参数,用于控制上传后显示图片的高度
2020-03-30
  • 解决图片名里含有多个.时图片格式验证失败的BUG
  • 鼠标放在上传图标上时新增pointer鼠标样式
  • 优化CSS样式,删除无用的样式
  • 优化complete()函数判断逻辑
2020-03-28
  • 解决allowZoom设置为false时无法删除图片的BUG
  • 新增已上传图片配置参数imageUrl,该参数主要用于编辑时展示之前已经上传的图片
  • 新增追加方式配置参数appendMethod,可以指定上传图片在已有图片前面追加还是后面追加
2020-03-25
  • 重写CSS样式,CSS类名前加ggy_前缀,以防止CSS污染
  • 解决同一个页面只能使用一次的BUG
  • 解决同一个文件二次上传无效的BUG
  • 解决上传图片验证失败后必须刷新页面才能重新上传的BUG
  • 新增批量上传功能
  • 新增批量上传成功回调函数complete,在所有图片上传成功后会触发

Todo List

  • 批量上传
  • 图片放大
  • 去掉jquery依赖
  • 裁剪压缩
  • 拖拽排序
JavaScript
1
https://gitee.com/mdoo/ajax-image-upload.git
git@gitee.com:mdoo/ajax-image-upload.git
mdoo
ajax-image-upload
ajax-image-upload
master

搜索帮助