# tui-cropper 图片裁剪(圆形裁剪框)

介绍

图片裁剪,组件提供了默认裁剪样式。裁剪框可设置为圆形和方形。

注意

  • 找到组件中 rotateImg 属性默认使用的图片地址,将文件复制到自己项目中,也可自定义图片。
  • 可拷贝static文件夹下整个components文件夹到自己项目中。
  • 使用裁剪组件页面需要禁止回弹效果,可查看示例程序页面json文件的配置。

# 引入

# uni-app引入

第一种,手动引入(可全局引入)

import tuiCropper from "@/components/thorui/tui-cropper/tui-cropper.vue"
export default {
	components:{
		tuiCropper
	}
}

第二种,开启easycom组件模式,如果不了解如何配置,可先查看 官网文档 (opens new window)

# uni-app版本平台差异说明

App-Nvue App-vue H5 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
升级中 使用tui-image-cropper组件 使用tui-image-cropper组件 使用tui-image-cropper组件 使用tui-image-cropper组件

# 微信小程序引入(可在app.json中全局引入)

{
  "usingComponents": {
    "tui-cropper": "/components/thorui/tui-cropper/tui-cropper"
  }
}

# 代码演示

部分功能演示,具体可参考示例程序以及文档API。

基础使用

通过 isRound 属性设置是否显示为圆形裁剪框, imageUrl 属性设置选取需要裁剪的图片地址,支持网络图片。

<!--uni-app-->
<tui-cropper :isRound="isRound" :imageUrl="imageUrl" @ready="ready" @cropper="cropper"></tui-cropper>

<!--微信小程序-->
<tui-cropper isRound="{{isRound}}" imageUrl="{{imageUrl}}" bindready="ready" bindcropper="cropper"></tui-cropper>

# Slots

none

# Props

参数 类型 说明 默认值
imageUrl String 图片路径 -
height Number 裁剪框高度 单位px 280
width Number 裁剪框宽度 280
isRound Boolean 是否显示为圆形裁剪框 true
border String 裁剪框边框样式 1px solid #fff
scaleRatio Number 生成的图片尺寸相对剪裁框的比例 2
quality Number 图片的质量,取值范围为 (0, 1],不在范围内时当作1.0处理 0.8
rotateAngle Number 图片旋转角度 0
minScale Number 图片最小缩放比 0.5
maxScale Number 图片最大缩放比 2
custom Boolean 自定义操作栏(为true时隐藏底部操作栏) false
startCutting [Number,Boolean] 值发生改变开始裁剪(custom为true时生效) [Number,Boolean]
isBase64 Boolean 是否返回base64(H5端默认base64) false
loadding Boolean 裁剪时是否显示loadding true
rotateImg String 旋转icon地址 /static/components/
cropper/img_rotate.png

# Events

事件名 说明 回调参数
ready 裁剪组件初始化完成 { }
imageLoad 需要裁剪的图片加载完成 { }
cropper 确认裁剪,回传裁剪后的图片url或base64 {
  url:图片地址,
  base64:图片base64,
  width:宽度,
  height:高度
}

# 预览

请以移动端效果为准,touch事件目前尚未在PC端做兼容。

# 线上程序扫码预览

ThorUI组件库 H5二维码 ThorUI示例
ThorUI组件库小程序码 H5二维码 ThorUI示例小程序码