更新记录

1.0.2（2026-03-15）

删除不需要的文件

1.0.1（2026-03-15）

更换架构

1.0.0（2026-03-14）

初始化安卓版

平台兼容性

uni-app(5.03)

rd-ImageCropper

图片裁剪插件，基于 UCrop 实现。

功能特性

• UI 交互式裁剪界面
• 支持旋转、缩放、自由裁剪
• 自定义输出质量和尺寸
• 支持本地路径、file://、content:// 格式的图片
• 丰富的 UI 自定义选项

安装

将 uni_modules/rd-ImageCropper 目录复制到项目的 uni_modules 目录下。

使用方法

import { cropImage } from '@/uni_modules/rd-ImageCropper'

// 基础用法
cropImage(
  '/path/to/image.jpg',
  { quality: 90 },
  (path) => console.log('裁剪成功:', path),
  () => console.log('取消裁剪'),
  (msg) => console.log('裁剪错误:', msg)
)

// 完整配置
cropImage(
  imagePath,
  {
    quality: 90,
    aspectRatioX: 1,
    aspectRatioY: 1,
    maxResultWidth: 2000,
    maxResultHeight: 2000,
    toolbarColor: '#000000',
    activeControlsWidgetColor: '#07C160',
    toolbarTitle: '裁剪头像'
  },
  onSuccess,
  onCancel,
  onError
)

API

cropImage(imagePath, options?, onSuccess?, onCancel?, onError?)

options 配置

颜色格式支持

颜色参数支持以下格式：

// rgba 格式
dimmedLayerColor: "rgba(0, 0, 0, 0.6)"

// rgb 格式
toolbarColor: "rgb(33, 33, 33)"

// hex 格式
activeControlsWidgetColor: "#07C160"
cropFrameColor: "#FFFFFF"

// 颜色名称
cropGridColor: "white"

返回值

• 裁剪成功后返回裁剪后图片的绝对路径
• 图片保存在应用缓存目录

示例

头像裁剪 (1:1)

cropImage(
  imagePath,
  {
    aspectRatioX: 1,
    aspectRatioY: 1,
    circleDimmedLayer: true,
    toolbarTitle: '裁剪头像'
  },
  onSuccess,
  onCancel,
  onError
)

身份证裁剪 (4:3)

cropImage(
  imagePath,
  {
    aspectRatioX: 4,
    aspectRatioY: 3,
    freeStyleCropEnabled: false,
    toolbarTitle: '裁剪身份证'
  },
  onSuccess,
  onCancel,
  onError
)

平台支持

• Android

许可证

MIT