更新记录

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

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

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

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

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

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

查看更多

平台兼容性

uni-app

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
√ √ √ √ √ - - - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
√ √ - - - - - - - - - -

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协议