• This repository has been archived on 08/May/2021
  • Stars
    star
    3,231
  • Rank 13,886 (Top 0.3 %)
  • Language
    JavaScript
  • Created over 9 years ago
  • Updated over 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

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

Build Status npm version npm

🚨重要!!

很抱歉,这个项目已不再维护了,可能很长一段时间都不会更新了。

演示

试试

点我直接进入演示页面

简述

在客户端压缩好要上传的图片可以节省带宽更快的发送给后端,特别适合在移动设备上使用。

为什么需要

  1. 已踩过很多坑,经过几个版本迭代,以及很多很多网友的反馈帮助、机型测试

    • 图片扭曲、某些设备不自动旋转图片方向,没有jpeg压缩算法..
    • 不支持new Blob,formData构造的文件size为0..
    • 还有某些机型和浏览器(例如QQX5浏览器)莫名其妙的BUG..
  2. 按需加载(会根据对应设备自动异步载入JS文件,节省不必要带宽)

  3. 原生JS编写,不依赖例如jquery等第三方库,支持AMD or CMD规范。

尽管如此,在某些 Android 下依然有莫名其妙的问题,在您使用前,请一定大致浏览下 issues

如何获取

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

  1. 执行npm i lrz(推荐)
  2. 执行bower install lrz

接着在页面中引入

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

如何使用

方式1:

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

<input id="file" type="file" accept="image/*" />

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

document.querySelector('#file').addEventListener('change', function () {
	lrz(this.files[0])
        .then(function (rst) {
            // 处理成功会执行
            console.log(rst);
        })
        .catch(function (err) {
            // 处理失败会执行
        })
        .always(function () {
            // 不管是成功失败,都会执行
        });
});

方式2:

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

lrz('./xxx/xx/x.png')
        .then(function (rst) {
            // 处理成功会执行
        })
        .catch(function (err){
            // 处理失败会执行
        })
        .always(function () {
            // 不管是成功失败,都会执行
        });

后端处理

后端处理请查看WIKI。

API

具体参数说明请查看WIKI。

兼容性

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

FAQ

有疑问请直接在 issues 中提问

请一定记得附上以下内容:💡
请一定记得附上以下内容:🙈
请一定记得附上以下内容:💡

平台:微信..
设备:iPhone5 IOS7..
问题:问题描述..
  • Q:有时拍摄完照片后,页面自动刷新或闪退了。

  • A:虽然已作了优化处理,但内存似乎还是爆掉了,常见于低配android手机,建议每次只处理一张图片。

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

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

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

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

  • Q: 想要商用可以吗?

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

感谢

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

More Repositories

1

ref-line

拖拽👌 时提供 参考线 和 磁性吸附 功能 🎯
JavaScript
371
star
2

cascading-select-address

angularjs 实现的省市区地址级联选择器
139
star
3

vscode-vue-i18n

🔖 这个插件能够帮到你方便浏览和编写 Vue i18n
HTML
108
star
4

node-webkit-example

通过node-webkit实现桌面应用程序
CSS
71
star
5

node-ocr-demo

实现验证码识别,基于 node.js 配合 tesseract 和 graphicsmagick
JavaScript
62
star
6

mock-angular

Mock(模拟http请求)的angularJS兼容插件
CoffeeScript
59
star
7

webchatHelper

一个微信群发信息的chrome扩展
JavaScript
31
star
8

ng-layer

对layer的angular封装,同时增加异步载入content功能
JavaScript
31
star
9

Guthub

用angular+mongoose+express实现的菜谱应用
JavaScript
26
star
10

ES7-Async-Await-Demo

基于babel6的ES7特性,async await的demo。
JavaScript
24
star
11

lodash-zh

lodash4+文档翻译
HTML
23
star
12

vscode-react-i18n

🔖 这个插件能够帮到你方便浏览和编写 React i18n
TypeScript
22
star
13

angularjs-select2

angularjs封装的select2(支持任意版本的select2)
JavaScript
20
star
14

blog-coffeeScript-express4-bootstrap3

来自 node.js 实战 ,用 coffeeScript & express4 & bootstrap 重构
CSS
16
star
15

html5-comet-EventSource--node.js-example

node.js实现html5原生comet(长连接)例子
JavaScript
9
star
16

z-Dragify

让元素可拖拽,支持移动端
JavaScript
8
star
17

koa-upload

基于koa的文件/图片上传
JavaScript
7
star
18

ipc2promise

将 electron 的 ipcMain 与 ipcRenderer 间的通信转换为 promise 模式
JavaScript
7
star
19

MEAN-BLOG

实践MEAN开发留言博客 (Mongodb+Express+Angularjs+Node.js)
CSS
6
star
20

vue-web-wechat

完全可用的非官方微信,基于VUE技术栈重构
JavaScript
6
star
21

simple-redis-drift-bottle

一个简单的漂流瓶,coffeescript+express+redis实现
CSS
5
star
22

EFI-ASRock-Z390-Phantom-Gaming-ITX-Hackintosh

给 Asrock Z390 Phantom Gamming ITX 主板使用的黑苹果 EFI
ASL
4
star
23

angularJS-countDown-example

angularJS实现的倒计时例子
CSS
3
star
24

lottery-creater

JavaScript
2
star
25

react-practice

JavaScript
2
star
26

angularJS-compile-example

angularJS实现编译被插入dom的带scope的html元素
2
star
27

angular.raty

angular封装的评分插件-raty
CoffeeScript
2
star
28

ng-transfer

基于angular的穿梭选择框
HTML
2
star
29

ng-copy

对ZeroClipboard的angular封装,不同的是使用简单以及支持HTML复制
JavaScript
1
star
30

ng-air-datepicker

wrap for air-datepicker,air-datepick的angular封装
JavaScript
1
star
31

vscode-i18n-core

👽 vscode-vue-i18n、vscode-react-i18n的核心文件
TypeScript
1
star
32

email-html-creator

一个编写邮件HTML的工作环境
JavaScript
1
star
33

css3InActive-practice

css3 实战练习
1
star
34

think2011.github.io

HTML
1
star
35

gulp-icons

用来不方便使用构建工具的情况下,合成 sprite 图的
JavaScript
1
star
36

messager

JavaScript
1
star
37

sui-datepicker

从 sui(https://github.com/sdc-alibaba/sui) 提取的datepicker和timepicker
JavaScript
1
star