localResizeIMG-前端本地客户端压缩图片,兼容IOS,Android,PC、自动按需加载文件

演示一下

自己试试

点我直接进入演示页面

介绍说明

在前端压缩好要上传的图片可以更快的发送给后端,因此也特别适合在移动设备上使用。

  • 兼容IOS&Android,修复了IOS和Android某些版本已知的BUG(这也是插件最有意义的存在价值)。

  • 按需加载文件,仅需引入lrz.bundle.js文件,例如当检测是IOS7的用户,那么会自动异步再载入修复BUG的文件,而无需担心浪费宝贵的带宽开销。

  • 原生JS编写,不依赖例如jquery等第三方库。

如何获取

通过以下方式都可以下载:

  1. 执行npm i lrz(推荐)
  2. 或者 git clone本库
  3. 要么 在页面右侧点击download zip

接着在页面中引入

1
<script src="./dist/lrz.bundle.js"></script>

请绝对不要删除【dist】目录下的任何文件,那些是某些情况自动按需载入的文件。

# 如何使用

### 方式1:

如果您的图片来自用户拍摄或者上传的,您需要一个input file来获取图片。

1
<input onchange="upload()" type="file" capture="camera" />

接着通过change事件可以得到用户选择的图片

1
2
3
4
5
6
7
8
9
10
11
12
function upload () {
    lrz(this.files[0])
        .then(function (rst) {
            // 处理成功会执行
        })
        .catch(function (err) {
            // 处理失败会执行
        })
        .always(function () {
            // 不管是成功失败,都会执行
        });
});

方式2:

如果您的图片不是来自用户上传的,那么也可以直接传入图片路径。

1
2
3
4
5
6
7
8
9
10
lrz('./xxx/xx/x.png')
        .then(function (rst) {
            // 处理成功会执行
        })
        .catch(function (err){
            // 处理失败会执行
        })
        .always(function () {
            // 不管是成功失败,都会执行
        });

后端处理

  • 后端最终会收到前端发送的base64字符串,接着处理字符串为图片即可。

  • 具体请使用关键字base64 转 image 开发语言进行谷歌|百度。

  • 前端生成的结果中有一个base64Len,这是字符串的长度,后端应该核对以确认是否提交完整。

API

具体参数说明请查看WIKI。

兼容性

IE9以上及大部分非IE浏览器(chrome、微信什么的)

FAQ

有疑问请直接在 issues 中提问 🙈

  • Q:有时拍摄完照片后,页面自动刷新或闪退了。
  • A:虽然已作了优化处理,但内存似乎还是爆掉了,常见于低配android手机。

  • Q: 怎么批量上传图片?

  • A: 您可以自己写个循环来传入用户多选的图片,但在移动端上请勿这样做,原因同上。

  • Q: 直接传入图片路径的无法生成图片

  • A: 可能是跨域的问题,具体请看CORS_enabled_image

  • Q: 想要商用可以吗?

  • A: 没问题,但请留意issue里已知的问题。

开发

想要参与|定制|了解源码请点击这里

感谢

  • @dwandw
  • @yourlin
  • @wxt2005

以上在之前的版本帮忙参与维护的朋友,以及提出问题的朋友们,真的真的很感谢你们。:D