在项目中，前端开发经常会遇到有图片上传的需求，而别人的组件大多都满足不了当下产品的需求，这是往往我们得去依靠组件自己自定义一个项目通用的裁剪组件

一、vue-cropper安装依赖：

vue2：

npm install vue-cropper  或  yarn add vue-cropper

vue3：

npm install vue-cropper@next  或  yarn add vue-cropper@next

二、引入相关css文件

import 'vue-cropper/dist/index.css' 

vue3才需要引入样式，vue2不需要

注意：这个样式一定记得引啊，我就是忘引入，裁剪框一直弄不出来

三、自定义组件

<!-- 裁剪图片工具-->
<template>
  <view class="upgrade-box">
    <szy-common-popup poptitle="裁剪图片" showPopup position="center" @close_popup="close_popup">
      <view class="prompt-content">
        <view class="inner-box">
          <view class="tip">提示：按微信公众号封面图2:35:1或1:1比例选择保留区域后，裁剪上传。</view>
          <!-- 选择裁剪比例 -->
          <view class="group-btn">
            <view
              class="item"
              :class="option.fixedNumber[0] === 2.35 ? 'item active' : 'item'"
              @click="cropSize(2.35, 1)"
              >2:35:1</view
            >
            <view
              class="item"
              :class="option.fixedNumber[0] === 1 ? 'item active' : 'item'"
              @click="cropSize(1, 1)"
              >1:1</view
            >
          </view>
          <!-- 裁剪区域 -->
          <view
            class="cropper-box"
            :style="{ width: `${imgObj.width}px`, height: `${imgObj.height}px` }"
          >
            <VueCropper
              ref="cropperRef"
              :img="option.img"
              :output-size="option.outputSize"
              :output-type="option.outputType"
              :can-scale="option.canScale"
              :auto-crop="option.autoCrop"
              :full="option.full == '0'"
              :auto-crop-width="option.autoCropWidth"
              :auto-crop-height="option.autoCropHeight"
              :can-move-box="option.canMoveBox"
              :can-move="option.canMove"
              :center-box="option.centerBox"
              :info="option.info"
              :fixed-box="option.fixedBox"
              :fixed="option.fixed"
              :fixed-number="option.fixedNumber"
            />
          </view>
        </view>
        <view class="button-group">
          <view class="dialog-button" @click="close_popup">
            <text class="dialog-button-text">取消</text>
          </view>
          <view class="dialog-button button-confirm" @click="cropperClick">
            <text class="dialog-button-text">保存/上传</text>
          </view>
        </view>
      </view>
    </szy-common-popup>
  </view>
</template>

<script lang="ts" setup>
  import { onMounted, ref } from 'vue';
  import { VueCropper } from 'vue-cropper';
  import 'vue-cropper/dist/index.css'; // vue3才需要引入样式，vue2不要

  const props = defineProps({
    coverFile: {
      type: String,
      require: '',
    },
  });

  // 裁剪组件Ref
  const cropperRef: any = ref({});

  // 裁剪组件需要使用到的参数
  interface Options {
    img: string;
    outputSize: number; // 裁剪生成图片质量
    outputType: string; // 裁剪生成图片格式
    canScale: boolean; // 图片是否允许滚轮播放
    autoCrop: boolean; // 是否默认生成截图框 false
    info: boolean; // 是否展示截图框信息
    autoCropWidth: number; // 生成截图框的宽度
    autoCropHeight: number; // 生成截图框的高度
    canMoveBox: boolean; // 截图框是否可以拖动
    enlarge: number;
    fixedBox: boolean; // 固定截图框的大小
    fixed: boolean; // 是否开启截图框宽高固定比例
    fixedNumber: number[]; // 截图框的宽高比例 默认2.35, 1:1,
    canMove: boolean; // 上传图片是否可拖动
    centerBox: boolean; // 截图框限制在图片里面
    accept: string; // 上传允许的格式
    infoTrue: boolean;
    original: boolean;
    full: boolean | string;
  }

  const option = ref<Options>({
    img: String(props.coverFile), // 裁剪图片地址
    outputSize: 1, // 裁剪生成图片质量
    outputType: 'jpeg', // 裁剪生成图片格式
    canScale: true, // 图片是否允许滚轮播放
    autoCrop: true, // 是否默认生成截图框 false
    info: true, // 是否展示截图框信息
    autoCropWidth: 235, // 生成截图框的宽度
    autoCropHeight: 100, // 生成截图框的高度
    enlarge: 1, // 采集后放大倍数
    full: '0', // 是否开启原尺寸裁剪 0 原尺寸 1当前尺寸
    infoTrue: true,
    original: true,
    canMoveBox: true, // 截图框是否可以拖动
    fixedBox: false, // 固定截图框的大小
    fixed: true, // 是否开启截图框宽高固定比例
    fixedNumber: [2.35, 1], // 截图框的宽高比例 默认2.35, 1:1,
    canMove: true, // 上传图片是否可拖动
    centerBox: true, // 截图框限制在图片里面
    accept: 'image/jpeg,image/jpg,image/png,image/gif,image/x-icon',
  });

  const handleSelectImg = (imgItem: any) => {
    option.value.img = String(imgItem);
  };

  // 外框大小
  const imgObj = ref({
    width: 300,
    height: 200,
  });

  // 修改截图框尺寸，宽，高
  const cropSize = (w: number, h: number) => {
    option.value.fixedNumber = [w, h];
    cropperRef.value.refresh();
  };

  // 裁剪后
  const cropperClick = () => {
    cropperRef.value.getCropData((data: any) => {
      emit('cropperClick', data);
    });
  };

  //
  const emit = defineEmits(['onClose', 'cropperClick']);
  const close_popup = () => {
    emit('onClose');
  };

  onMounted(() => {
    handleSelectImg(String(props.coverFile));
  });
</script>

<style lang="scss" scoped>
  .upgrade-box {
    .inner-box {
      .tip {
        font-size: 30rpx;
        text-align: left;
      }
      .group-btn {
        display: flex;
        align-items: center;
        justify-content: flex-start;
        margin: 20rpx 0rpx;
        .item {
          flex: 1;
          display: inline-flex;
          background: rgba(0, 0, 0, 0.03);
          border-radius: 6rpx 6rpx 0 0;
          text-align: center;
          justify-content: center;
          align-items: center;
          padding: 0 30rpx;
          height: 80rpx;
          white-space: nowrap;
          font-size: 34rpx;
          cursor: pointer;
          color: #353535;
          position: relative;
          &:after {
            content: '';
            position: absolute;
            left: 0;
            top: 0;
            bottom: 0;
            width: 1rpx;
            background: #eee;
            height: 100%;
            display: block;
          }
          &:first-child {
            border-radius: 6rpx 0 0 6rpx;
            &:after {
              display: none;
            }
          }
          &.active {
            background: $uni-main-color;
            color: #fff;
            border-radius: 6rpx;
          }
        }
      }
      .cropper-box {
        background: #eee;
        overflow: hidden;
      }
    }
  }
</style>

四、展示样式