更新记录
1.0.5(2023-11-16)
优化裁剪框圆角/裁剪图片圆角,更新了文档
1.0.4(2023-11-14)
支持图片最大缩放功能,优化App端图标问题,
1.0.3(2023-11-11)
新增图片旋转图标rotate.svg
查看更多
平台兼容性
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,但希望大家手下留情,不要轻易给差评!