Appearance
photo-crop-tool
photo-crop-tool 是一个图片裁剪工具组件,支持自由裁剪和固定比例裁剪,可以通过拖拽和缩放来调整裁剪区域。
基础用法
Promise 方式调用
属性
属性 | 说明 | 类型 | 默认值 |
---|---|---|---|
imgFile | 需要裁剪的图片文件 | File | null |
aspectRatio | 裁剪框宽高比,格式为 "width / height" | string | '16 / 9' |
defaultWidth | 裁剪框默认宽度(像素) | number | 320 |
defaultHeight | 裁剪框默认高度(像素) | number | 180 |
zoomType | 缩放类型,fixed: 固定比例,free: 自由缩放 | 'fixed' | 'free' | 'fixed' |
方法
方法 | 说明 | 参数 | 返回值 |
---|---|---|---|
crop | 获取裁剪后的图片 | - | Promise<File | null> |
resize | 重置裁剪框到默认大小和位置 | - | void |
事件
事件名 | 说明 | 回调参数 |
---|---|---|
- | - | - |
注意事项
- imgFile 必须是合法的图片文件,否则会显示错误提示
- aspectRatio 的格式必须是 "width / height" 的形式,例如 "16 / 9"、"4 / 3" 等
- 当 zoomType 为 'fixed' 时,裁剪框会保持设定的宽高比
- 裁剪后的图片格式为 PNG