更新记录

1.0.8(2024-09-09) 下载此版本

矩形旋转居中修改,矩形框最大缩放

1.0.7(2024-08-12) 下载此版本

优化了vue2版本在微信场景下,:style 不支持 comImageStyle('image-wrap') 语法问题。

1.0.6(2024-08-08) 下载此版本

优化选择大文件图片后,无法在Image中直接显示图片,提供针对大图片压缩思路

查看更多

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.1.0 app-vue × × × ×
钉钉小程序 快手小程序 飞书小程序 京东小程序 鸿蒙元服务
× × × × ×
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
× × × × ×

t-cropper

t-cropper 一款高性能移动端图片裁剪工具

平台兼容

App H5 微信小程序 支付宝小程序

属性说明

属性 类型 默认 备注
mode String "ratio" 裁剪模式
imageUrl String " " 需要裁剪的图片路径
width Number 200 图片裁剪后的宽度,固定大小时有效
height Number 200 图片裁剪后的高度,固定大小时有效
maxWidth Number 1024 图片裁剪后的最大宽度
maxHeight Number 1024 图片裁剪后的最大高度
scaleRatio Number 0.7 裁剪比列缩放,建议不超过0.95
minRatio Number 1 最小缩放
maxRatio Number 3 最大缩放
radius Number 0 裁剪图片圆角半径,单位px
delay Number 250 确定按钮快速重复点击时间
isRotateBtn Boolean true 是否显示旋转按钮
isCutSize Boolean true 是否导出高清裁剪原图(h5)

mode有效值

模式 说明
固定模式 fixed 裁剪出指定大小的图片,一般用于头像上传
等比缩放 ratio 限定宽高比,裁剪大小不固定
自由模式 free 不限定宽高比,裁剪大小不固定

事件说明

事件名称 说明 返回
confirm 点击确定按钮 object
cancel 点击取消按钮 -

示例

复制代码<template>
  <view>
    <tt-cropper
      mode="ratio"
      :imageUrl="model.imageUrl"
      :width="500"
      :height="500"
      :radius="90"
      :delay="300"
      @cancel="onCancel"
      @confirm="onConfirm"
    ></tt-cropper>
    <view class="preview">
      <image
        v-for="(item, index) in model.resultUrl"
        :key="item.id"
        class="images"
        @click="prviewImgae(index, item.url)"
        :src="item.url"
      />
    </view>
    <button class="button" type="primary" @click="selectFile">选择图片</button>
  </view>
</template>

<script>
export default {
  data() {
    return {
      model: {
        imageUrl: "",
        resultUrl: [],
      },
    };
  },
  methods: {
    // 使用uni.compressImage压缩图片
    compressImage() {
      uni.chooseImage({
        count: 1,
        sizeType: ['original'],
        success: (res) => {
          uni.showLoading({
            title: "处理中...",
            mask: true,
          });
          // 使用uni.compressImage压缩图片
          uni.compressImage({
            src: res.tempFilePaths[0],
            quality: 80, // 压缩质量
            success: (compressRes) => {
              this.model.imageUrl = compressRes.tempFilePath;
            },
            fail: (err) => {
              console.error("图片压缩失败:", err);
            },
            complete: () => {
              uni.hideLoading(); // 关闭loading
            },
          });
        },
      });
    },
    // 使用默认压缩方式
    defaultCompressImage() {
      uni.chooseImage({
        count: 1,
        sizeType: ['compressed'],
        success: (res) => {
          this.model.imageUrl = res.tempFilePaths[0];
        },
      });
    },
    /**
     *** 特别声明:在使用uni.chooseImage选择的大图片文件无法直接在Image组件中显示,通常涉及到以下可能的问题和限制。
     *** 图片大小和尺寸限制:移动设备和浏览器对于能够加载和处理的图片大小有限制,如果选择的图片文件尺寸过大,可能无法正常加载和显示。
     *** 性能问题:大图片文件可能会导致页面加载缓慢或者卡顿,尤其是在移动设备上。
     *** 内存问题:加载大图片可能会消耗大量的内存资源,特别是在移动设备上,可能导致内存不足或者页面崩溃的问题。
     *** 解决参考方案如下:
     *** 防止选择大文件图片后无法在Image中直接临时路径显示图片,导致无法在裁剪插件中显示,
     *** 根据项目需要对大尺寸图片进行压缩、对图片质量要求高的,需要提前上传至oss进行采用网络图片进行裁剪。
     */
    selectFile() {
      // 推荐使用其他压缩方式:这里只是简单对大文件图片压缩-仅供思路参考,切勿使用该方式
      // 示例一:uni.compressImage压缩图片
      // this.compressImage();

      // 示例二:使用自带压缩图
      this.defaultCompressImage();
    },

    // 关闭
    onCancel() {
      this.model.imageUrl = "";
    },

    // 确定裁剪
    onConfirm(res) {
      const params = {
        id: new Date().getTime(),
        url: res.tempFilePath,
      };
      this.model.resultUrl.push(params);
      this.model.imageUrl = "";
    },

    // 预览图片
    prviewImgae(index, url) {
      uni.previewImage({
        current: index, // 当前资源下标
        urls: [url],
      });
    },
  },
};
</script>

<style lang="scss" scoped>
.preview {
  padding: 32rpx;

  .images {
    margin: 10rpx;
    width: 200rpx;
    height: 200rpx;
  }
}
.button {
  margin: 0 20rpx;
}
</style>

注意

1.uni-app版本不断更新,插件有时无法适应新版本,感谢大家及时提交bug,但希望大家手下留情,不要轻易给差评!

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议
122***@qq.com

2025-02-12

页面加入这个组件后,页面无法往下滚动了。

lacorey

2024-12-31

改写了防抖功能,以前是延时多久执行,如果设置过小还是可以连续执行,过大首次执行被延时,现在首次执行延时多少再能执行 const debounce = (fn, wait = 1000) => { let canRun = true; return function (...args) { if (!canRun) return; canRun = false; fn.apply(this, args); setTimeout(() => { canRun = true; }, wait); }; };

南风抚我意 2025-01-15

  可以这样
  const debounce = (fn, wait = 1000, immediate = false) => {
   let time = null;
   return function (...args) {
    if (immediate) { fn.apply(this, args) immediate = false return }
    if (time) clearTimeout(time);
    time = setTimeout(() => {
     fn.apply(this, args);
    }, wait);
新手小白白

2024-12-13

我在支付宝上面ios真机调试时也是一直处理中,把v-show去掉就可以啦

南风抚我意 2025-01-15

蟹蟹

122***@qq.com

2024-11-14

请问下组件在用在小程序中,安卓手机可以使用,ios点击确定后一直在处理中

104***@qq.com

2024-11-05

大哥,长方形裁剪框旋转的话图片不占满,会留白,怎么处理

南风抚我意 2024-11-12

v-if="isRotateBtn && mode !== 'free'" 你是不是把这句屏蔽了?

consoleLog123

2024-08-25

你好 请问下 有没有单独的支付宝小程序的版本 因为要用支付宝原生

南风抚我意 2024-09-06

您好,没有支付宝原生的哦

uni***@spinextech.cn

2024-08-07

在么 需求定制一个插件 qq 534149976 看到回一个呗 需要沟通

烧仙草

2024-08-09

中间点击旋转图片不居中。 运行微信小程序 报错 “ :style 不支持 comImageStyle('image-wrap') 语法 ”

刘哲学

2024-06-19

图片放大之后再裁剪一直处理中

179***@qq.com

2024-05-31

嵌入到安卓,手机选择文件没有显示尼,

2024-07-22

中间点击旋转图片不居中。

2024-05-21

IOS版本16.3.1会出现卡死现象,出现几率还是比较高的,要怎么解决,急

2024-05-07

为何APP下一直报错。。。急。。。为何APP下一直报错,裁剪框移动不了