Skip to content

photo-crop-tool

photo-crop-tool 是一个图片裁剪工具组件,支持自由裁剪和固定比例裁剪,可以通过拖拽和缩放来调整裁剪区域。

基础用法

Promise 方式调用

属性

属性说明类型默认值
imgFile需要裁剪的图片文件Filenull
aspectRatio裁剪框宽高比,格式为 "width / height"string'16 / 9'
defaultWidth裁剪框默认宽度(像素)number320
defaultHeight裁剪框默认高度(像素)number180
zoomType缩放类型,fixed: 固定比例,free: 自由缩放'fixed' | 'free''fixed'

方法

方法说明参数返回值
crop获取裁剪后的图片-Promise<File | null>
resize重置裁剪框到默认大小和位置-void

事件

事件名说明回调参数
---

注意事项

  1. imgFile 必须是合法的图片文件,否则会显示错误提示
  2. aspectRatio 的格式必须是 "width / height" 的形式,例如 "16 / 9"、"4 / 3" 等
  3. 当 zoomType 为 'fixed' 时,裁剪框会保持设定的宽高比
  4. 裁剪后的图片格式为 PNG

Released under the MIT License.