更新记录

1.0.5(2023-11-16)

优化裁剪框圆角/裁剪图片圆角,更新了文档

1.0.4(2023-11-14)

支持图片最大缩放功能,优化App端图标问题,

1.0.3(2023-11-11)

新增图片旋转图标rotate.svg

查看更多

平台兼容性

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
isRotateBtn Boolean true 是否显示旋转按钮

mode有效值

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

事件说明

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

示例

<template>
  <view>
    <t-cropper
      mode="ratio"
      :imageUrl="model.imageUrl"
      :width="500"
      :height="500"
      :radius="90"
      @cancel="onCancel"
      @confirm="onConfirm"
    ></t-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="select">选择图片</button>
  </view>
</template>

<script setup>
import { reactive, toRefs } from "vue";
var model = reactive({
  imageUrl: "",
  resultUrl: [],
});

let { resultUrl } = toRefs(model);

const select = () => {
  uni.chooseImage({
    count: 1,
    success: (res) => {
      model.imageUrl = res.tempFilePaths[0];
    },
  });
};

const onCancel = () => {
  model.imageUrl = "";
};

const onConfirm = (res) => {
  // 设置url的值,显示控件
  const params = {
    id: new Date().getTime(),
    url: res.tempFilePath,
  };
  model.resultUrl.push(params);
  model.imageUrl = "";
};

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

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问