更新记录

1.0.0（2025-06-12）

app图片裁剪拍照后裁剪工具，可自由改变裁剪框大小，app拖动支持，随意改变裁剪区域，支持拖拽调整裁剪框大小、旋转图片、网格线辅助等功能

平台兼容性

uni-app(4.01)

uni-app x(4.01)

cp-image-cropper

介绍

cp-image-cropper 是一个功能强大的图片裁剪组件，支持拖拽调整裁剪框大小、旋转图片、网格线辅助等功能。

平台兼容性

• 安卓：支持
• iOS：支持
• app 内嵌套小程序 ：支持
• App-vue：支持
• H5：支持
• 微信小程序：支持
• 支付宝小程序：支持
• 百度小程序：支持
• 字节跳动小程序：支持
• QQ 小程序：支持

安装方式

从 HBuilderX 3.1.0+ 起，您可以通过 uni_modules 插件市场导入插件。

基本用法

<template>
  <cp-image-cropper
    :src="imageUrl"
    @cancel="handleCancel"
    @confirm="handleConfirm"
  />
</template>

<script>
export default {
  data() {
    return {
      imageUrl: "",
    };
  },
  methods: {
    handleCancel() {
      // 取消裁剪
    },
    handleConfirm(result) {
      // 获取裁剪后的图片临时路径
      console.log(result.tempFilePath);
    },
  },
};
</script>

API

Props

Events

示例项目

参考示例项目查看详细用法。

更新日志

1.0.0（2025-06-12）

• 首次发布