Vue 使用 Cropper.js 实现图片裁剪功能

最新推荐文章于 2025-06-17 14:54:29 发布
最新推荐文章于 2025-06-17 14:54:29 发布
阅读量2.3k 收藏 17
点赞数 23
CC 4.0 BY-SA版权
分类专栏： Vue 进阶笔记手册 文章标签： javascript vue.js 前端 cropper.js
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/m0_37890289/article/details/143896870

前言

图片裁剪功能无论是用户头像的裁剪，还是图片内容的精确调整，都成为了提升用户体验的关键一环。Vue.js 结合 Cropper.js 这一功能丰富的图片裁剪库，可以轻松实现高效、直观的图片裁剪功能。本文将详细介绍如何在 Vue.js 项目中集成并使用 Cropper.js，实现一个强大的图片裁剪组件。

前置工作

首先，我们需要确保已经安装了 Vue.js 和 Cropper.js。如果你还没有安装它们，可以通过以下命令进行安装：

# 安装 Vue CLI
npm install -g @vue/cli

# 创建一个新的 Vue 项目
vue create vue-cropper

# 进入项目目录
cd vue-cropper

# 安装 Cropper.js
npm install cropperjs

项目结构

我们将在 src 目录下创建一个 components 文件夹，用于存放我们的组件。我们的主要文件包括：

  • App.vue: 主应用组件
  • components/CropperComponent.vue: 图片裁剪组件

实现步骤

1. App.vue

首先，我们在 App.vue 中引入并使用 CropperComponent 组件：

<template>
  <div id="app">
    <h1>Vue.js 与 Cropper.js 图片裁剪示例</h1>
    <CropperComponent />
  </div>
</template>

<script>
import CropperComponent from './components/CropperComponent.vue';

export default {
  name: 'App',
  components: {
    CropperComponent
  }
};
</script>

<style>
#app {
  text-align: center;
  margin-top: 50px;
}
</style>

2. CropperComponent.vue

接下来，我们在 components 文件夹中创建 CropperComponent.vue 文件，这是我们实现图片裁剪逻辑的地方。

<template>
  <div class="cropper-container">
    <input type="file" @change="onFileChange" />
    <div v-if="imageUrl">
      <img ref="image" :src="imageUrl" alt="Source Image" />
      <button @click="cropImage">裁剪图片</button>
      <div v-if="croppedImageUrl">
        <h3>裁剪后的图片:</h3>
        <img :src="croppedImageUrl" alt="Cropped Image" />
      </div>
    </div>
  </div>
</template>

<script>
import Cropper from 'cropperjs';
import 'cropperjs/dist/cropper.css';

export default {
  name: 'CropperComponent',
  data() {
    return {
      imageUrl: null,
      cropper: null,
      croppedImageUrl: null
    };
  },
  methods: {
    onFileChange(event) {
      const file = event.target.files[0];
      if (file && file.type.startsWith('image/')) {
        this.imageUrl = URL.createObjectURL(file);
        this.$nextTick(() => {
          if (this.cropper) {
            this.cropper.destroy();
          }
          this.cropper = new Cropper(this.$refs.image, {
            aspectRatio: 1,
            viewMode: 1
          });
        });
      }
    },
    cropImage() {
      if (this.cropper) {
        const canvas = this.cropper.getCroppedCanvas();
        this.croppedImageUrl = canvas.toDataURL('image/png');
      }
    }
  }
};
</script>

<style>
.cropper-container {
  text-align: center;
}
.cropper-container img {
  max-width: 100%;
}
</style>

解释

  1. 文件选择器：通过一个 元素，用户可以选择要裁剪的图片文件。
  2. 图片预览与 Cropper 实例化：当用户选择图片后，我们使用 URL.createObjectURL 方法生成图片的 URL，并将其赋值给 imageUrl。然后，我们在 nextTick 中创建 Cropper 实例。
  3. 图片裁剪：点击 “裁剪图片” 按钮后，我们调用 cropper.getCroppedCanvas 方法获取裁剪后的图片，并将其转为 base64 格式的 URL。

进阶用法

我们的基础功能已经实现，但在实际应用中，你可能需要更多的功能和更好的用户体验。接下来，我们将探讨一些常见的优化和扩展方法。

1. 添加裁剪比例选择

有时候我们需要用户在多种裁剪比例之间进行选择，比如 1:1、16:9、4:3 等。我们可以在 CropperComponent.vue 中添加一个下拉菜单供用户选择裁剪比例。

<template>
  <div class="cropper-container">
    <input type="file" @change="onFileChange" />
    <div v-if="imageUrl">
      <select v-model="aspectRatio" @change="updateAspectRatio">
        <option value="1">1:1</option>
        <option value="16/9">16:9</option>
        <option value="4/3">4:3</option>
        <option value="NaN">自由比例</option>
      </select>
      <img ref="image" :src="imageUrl" alt="Source Image" />
      <button @click="cropImage">裁剪图片</button>
      <div v-if="croppedImageUrl">
        <h3>裁剪后的图片:</h3>
        <img :src="croppedImageUrl" alt="Cropped Image" />
      </div>
    </div>
  </div>
</template>

<script>
import Cropper from 'cropperjs';
import 'cropperjs/dist/cropper.css';

export default {
  name: 'CropperComponent',
  data() {
    return {
      imageUrl: null,
      cropper: null,
      croppedImageUrl: null,
      aspectRatio: 1
    };
  },
  methods: {
    onFileChange(event) {
      const file = event.target.files[0];
      if (file && file.type.startsWith('image/')) {
        this.imageUrl = URL.createObjectURL(file);
        this.$nextTick(() => {
          if (this.cropper) {
            this.cropper.destroy();
          }
          this.initCropper();
        });
      }
    },
    initCropper() {
      this.cropper = new Cropper(this.$refs.image, {
        aspectRatio: this.aspectRatio,
        viewMode: 1
      });
    },
    updateAspectRatio() {
      if (this.cropper) {
        this.cropper.setAspectRatio(this.aspectRatio === 'NaN' ? NaN : Number(this.aspectRatio));
      }
    },
    cropImage() {
      if (this.cropper) {
        const canvas = this.cropper.getCroppedCanvas();
        this.croppedImageUrl = canvas.toDataURL('image/png');
      }
    }
  }
};
</script>

<style>
.cropper-container {
  text-align: center;
}
.cropper-container img {
  max-width: 100%;
}
</style>

2. 处理裁剪后的图片

对于裁剪后的图片，我们可能需要进一步处理，比如上传到服务器或者下载到本地。下面是一个简单的示例，展示如何下载裁剪后的图片：

<template>
  <div class="cropper-container">
    <input type="file" @change="onFileChange" />
    <div v-if="imageUrl">
      <select v-model="aspectRatio" @change="updateAspectRatio">
        <option value="1">1:1</option>
        <option value="16/9">16:9</option>
        <option value="4/3">4:3</option>
        <option value="NaN">自由比例</option>
      </select>
      <img ref="image" :src="imageUrl" alt="Source Image" />
      <button @click="cropImage">裁剪图片</button>
      <div v-if="croppedImageUrl">
        <h3>裁剪后的图片:</h3>
        <img :src="croppedImageUrl" alt="Cropped Image" />
        <a :href="croppedImageUrl" download="cropped-image.png">下载裁剪后的图片</a>
      </div>
    </div>
  </div>
</template>

<script>
import Cropper from 'cropperjs';
import 'cropperjs/dist/cropper.css';

export default {
  name: 'CropperComponent',
  data() {
    return {
      imageUrl: null,
      cropper: null,
      croppedImageUrl: null,
      aspectRatio: 1
    };
  },
  methods: {
    onFileChange(event) {
      const file = event.target.files[0];
      if (file && file.type.startsWith('image/')) {
        this.imageUrl = URL.createObjectURL(file);
        this.$nextTick(() => {
          if (this.cropper) {
            this.cropper.destroy();
          }
          this.initCropper();
        });
      }
    },
    initCropper() {
      this.cropper = new Cropper(this.$refs.image, {
        aspectRatio: this.aspectRatio,
        viewMode: 1
      });
    },
    updateAspectRatio() {
      if (this.cropper) {
        this.cropper.setAspectRatio(this.aspectRatio === 'NaN' ? NaN : Number(this.aspectRatio));
      }
    },
    cropImage() {
      if (this.cropper) {
        const canvas = this.cropper.getCroppedCanvas();
        this.croppedImageUrl = canvas.toDataURL('image/png');
      }
    }
  }
};
</script>

<style>
.cropper-container {
  text-align: center;
}
.cropper-container img {
  max-width: 100%;
}
</style>

3. 图片上传至服务器

如果想将裁剪后的图片上传到服务器，可以使用 axios 或者原生的 fetch 等方法。以下是一个简单的示例：

# 安装 axios
npm install axios
<template>
  <div class="cropper-container">
    <input type="file" @change="onFileChange" />
    <div v-if="imageUrl">
      <select v-model="aspectRatio" @change="updateAspectRatio">
        <option value="1">1:1</option>
        <option value="16/9">16:9</option>
        <option value="4/3">4:3</option>
        <option value="NaN">自由比例</option>
      </select>
      <img ref="image" :src="imageUrl" alt="Source Image" />
      <button @click="cropImage">裁剪图片</button>
      <div v-if="croppedImageUrl">
        <h3>裁剪后的图片:</h3>
        <img :src="croppedImageUrl" alt="Cropped Image" />
        <button @click="uploadImage">上传裁剪后的图片</button>
      </div>
    </div>
  </div>
</template>

<script>
import Cropper from 'cropperjs';
import 'cropperjs/dist/cropper.css';
import axios from 'axios';

export default {
  name: 'CropperComponent',
  data() {
    return {
      imageUrl: null,
      cropper: null,
      croppedImageUrl: null,
      aspectRatio: 1
    };
  },
  methods: {
    onFileChange(event) {
      const file = event.target.files[0];
      if (file && file.type.startsWith('image/')) {
        this.imageUrl = URL.createObjectURL(file);
        this.$nextTick(() => {
          if (this.cropper) {
            this.cropper.destroy();
          }
          this.initCropper();
        });
      }
    },
    initper() {
      this.cropper = new Cropper(this.$refs.image, {
        aspectRatio: this.aspectRatio,
        viewMode: 1
      });
    },
    updateAspectRatio() {
      if (this.cropper) {
        this.cropper.setAspectRatio(this.aspectRatio === 'NaN' ? NaN : Number(this.aspectRatio));
      }
    },
    cropImage() {
      if (this.cropper) {
        const canvas = this.cropper.getCroppedCanvas();
        this.croppedImageUrl = canvas.toDataURL('image/png');
      }
    },
    async uploadImage() {
      if (this.croppedImageUrl) {
        const formData = new FormData();
        const blob = await fetch(this.croppedImageUrl).then(res => res.blob());
        formData.append('croppedImage', blob, 'cropped-image.png');

        try {
          const response = await axios.post('YOUR_UPLOAD_URL', formData, {
            headers: {
              'Content-Type': 'multipart/form-data'
            }
          });
          console.log('上传成功:', response.data);
        } catch (error) {
          console.error('上传失败:', error);
        }
      }
    }
  }
};
</script>

<style>
.cropper-container {
  text-align: center;
}
.cropper-container img {
  max-width: 100%;
}
</style>

在上述示例中，我们使用 axios 将裁剪后的图片上传到服务器。请确保替换 YOUR_UPLOAD_URL 为实际的上传 URL。

4. 图片旋转和缩放

除了裁剪图片，用户有时还需要旋转和缩放图片。Cropper.js 提供了相应的方法来处理这些操作。你可以在组件中添加按钮，调用这些方法。

<template>
  <div class="cropper-container">
    <input type="file" @change="onFileChange" />
    <div v-if="imageUrl">
      <select v-model="aspectRatio" @change="updateAspectRatio">
        <option value="1">1:1</option>
        <option value="16/9">16:9</option>
        <option value="4/3">4:3</option>
        <option value="NaN">自由比例</option>
      </select>
      <img ref="image" :src="imageUrl" alt="Source Image" />
      <div>
        <button @click="rotateImage(-90)">左旋转</button>
        <button @click="rotateImage(90)">右旋转</button>
        <button @click="zoomImage(0.1)">放大</button>
        <button @click="zoomImage(-0.1)">缩小</button>
      </div>
      <button @click="cropImage">裁剪图片</button>
      <div v-if="croppedImageUrl">
        <h3>裁剪后的图片:</h3>
        <img :src="croppedImageUrl" alt="Cropped Image" />
        <button @click="uploadImage">上传裁剪后的图片</button>
      </div>
    </div>
  </div>
</template>

<script>
import Cropper from 'cropperjs';
import 'cropperjs/dist/cropper.css';
import axios from 'axios';

export default {
  name: 'CropperComponent',
  data() {
    return {
      imageUrl: null,
      cropper: null,
      croppedImageUrl: null,
      aspectRatio: 1
    };
  },
  methods: {
    onFileChange(event) {
      const file = event.target.files[0];
      if (file && file.type.startsWith('image/')) {
        this.imageUrl = URL.createObjectURL(file);
        this.$nextTick(() => {
          if (this.cropper) {
            this.cropper.destroy();
          }
          this.initCropper();
        });
      }
    },
    initCropper() {
      this.cropper = new Cropper(this.$refs.image, {
        aspectRatio: this.aspectRatio,
        viewMode: 1
      });
    },
    updateAspectRatio() {
      if (this.cropper) {
        this.cropper.setAspectRatio(this.aspectRatio === 'NaN' ? NaN : Number(this.aspectRatio));
      }
    },
    rotateImage(degree) {
      if (this.cropper) {
        this.cropper.rotate(degree);
      }
    },
    zoomImage(ratio) {
      if (this.cropper) {
        this.cropper.zoom(ratio);
      }
    },
    cropImage() {
      if (this.cropper) {
        const canvas = this.cropper.getCroppedCanvas();
        this.croppedImageUrl = canvas.toDataURL('image/png');
      }
    },
    async uploadImage() {
      if (this.croppedImageUrl) {
        const formData = new FormData();
        const blob = await fetch(this.croppedImageUrl).then(res => res.blob());
        formData.append('croppedImage', blob, 'cropped-image.png');

        try {
          const response = await axios.post('YOUR_UPLOAD_URL', formData, {
            headers: {
              'Content-Type': 'multipart/form-data'
            }
          });
          console.log('上传成功:', response.data);
        } catch (error) {
          console.error('上传失败:', error);
        }
      }
    }
  }
};
</script>

<style>
.cropper-container {
  text-align: center;
}
.cropper-container img {
  max-width: 100%;
}
.cropper-container button {
  margin: 5px;
}
</style>

总结

通过本文的详细讲解，您应该已经掌握了如何在 Vue.js 项目中集成并使用 Cropper.js 实现功能强大的图片裁剪组件。我们不仅介绍了基础的图片裁剪实现，还展示了如何扩展功能以支持裁剪比例选择、图片旋转与缩放，以及裁剪后图片的上传处理。这个组件可作为您项目中的一个重要模块，提升用户体验。

vue中实现图片裁剪
浮游的博客
08-26 953
通过以上代码，我们实现了一个基于Vue.js和Cropper.js的图片裁剪组件，用户可以上传图片并进行裁剪操作，最终获取裁剪后的图片数据。这个组件可以方便地集成到Vue.js应用中，为用户提供了良好的图片处理体验。
vue3+vant+cropper.js实现移动端图片裁剪功能
jnfy的博客
09-20 1417
vue3+vant+cropper.js实现移动端图片裁剪功能
记录使用vue3 使用cropperjs
weixin_53322542的博客
03-26 1213
该组件是一个图片裁剪器组件，用于在Vue 3项目中集成。它基于cropperjs库实现，提供了丰富的图片裁剪功能，如缩放、移动、旋转、翻转等。用户可以通过该组件对图片进行裁剪，并将裁剪后的图片传递给父组件进行进一步处理。结合了饿了吗的组件开发提供源码都有注释 方便修改。
Vue 实现图片裁剪功能：基于 vue-cropper 和 Element Plus 的完整解决方案
最新发布
a3212768093的博客
06-17 1075
本文介绍了使用Vue3和ElementPlus实现图片裁剪组件的技术方案。
Vue 图片裁剪插件cropperJs
weixin_53035812的博客
03-07 2196
【代码】Vue 图片裁剪插件cropperJs。
vue-cropper 实现图片裁剪功能
qq_16795789的博客
12-24 843
el-button size="mini" type="danger" plain icon="el-icon-zoom-out" @click="changeScale(-1)">缩小</el-button><el-button size="mini" type="danger" plain icon="el-icon-zoom-in" @click="changeScale(1)">放大</el-button>full: false, //false按原比例裁切图片，不失真。
Vue中使用Cropper.js裁剪图片
04-07
Vue中使用Cropper.js裁剪图片 Cropper.js是一款很好用的图片裁剪工具，可以对图片的尺寸、宽高比进行裁剪，满足诸如裁剪头像上传、商品图片编辑之类的需求。 github： https://github.com/fengyuanchen/cropperjs 网站： https://fengyuanchen.github.io/cropperjs/
vue2中使用vue-cropper实现图剪裁效果
m0_46796399的博客
04-10 2237
vue2通过vue-cropper实现图片剪裁
基于cropper.js封装vue实现在线图片裁剪组件功能
10-18
根据给定的文件信息，这里将详细介绍如何基于cropper.js封装Vue实现在线图片裁剪组件功能的相关知识点。 ### 知识点一：什么是cropper.js？ cropper.js是一个基于jQuery的图像裁剪插件，它允许用户通过鼠标拖拽...
基于 cropper.js 实现 前端图片裁剪、放大、缩小、移动 支持移动端和PC端
07-11
`cropper.js` 是一个强大的 JavaScript 图片裁剪库，它支持在移动端和PC端进行图片的裁剪、放大、缩小和移动操作，极大地提高了用户体验。本教程将详细介绍如何利用 `cropper.js` 来实现这些功能。 首先，我们要...
cropper.js图片裁剪
02-07
总的来说，`cropper.js` 是一个功能完备、易用性强的JavaScript图片裁剪库，能够帮助开发者轻松实现图片裁剪功能，提升应用的交互性和实用性。通过深入理解和实践`cropper.js`，开发者可以更好地应对各种图片处理...
详解vue项目中实现图片裁剪功能
12-12
演示地址 https://my729.github.io/picture-crop-demo/dist/#/ 前言 vue版本：3.6.3 https://cli.vuejs.org/zh/ cropperjs: 1.5.1 https://github.com/fengyuanchen/cropperjs elementUI https://element.eleme.io/#/zh-CN 使用 cropperjs插件 和 原生canvas 两种方式实现图片裁剪功能 使用cropperjs插件 安装cropperjs yarn install cropperjs 初始
cropper.js 实现HTML5 裁剪图片并上传(裁剪上传头像
06-12
使用cropper.js裁剪图片，通过canvas获取裁剪后的图片，获取的是base64图片上传。
vuecropper一个简单的vue的图片裁剪插件
08-12
vue-cropper 一个简单的vue 的图片裁剪插件
vue 上传图片进行裁剪（VueCropper）
04-18
使用 VueCropper 第三方库，对上传的图片进行移动，缩放，裁剪等功能。
前端开发攻略---Vue实现图像裁剪功能，支持用户通过图形界面进行裁剪区域的调整，最终生成裁剪后的图像。
nibabaoo的博客
08-16 2023
Vue实现图像裁剪功能，支持用户通过图形界面进行裁剪区域的调整，最终生成裁剪后的图像。
cropperjs在vue中的使用
热门推荐
一只爱吃糖的小羊
05-14 1万+
用vue的项目里需要对图片进行裁剪，于是使用了cropperjs，在使用的过程中也踩过一些坑，以下是在.vue文件里cropperjs的使用方法和经验教训总结： 在使用之前，先引入： 在项目里，运行： npm install cropperjs -save 在template里： &lt;div id="demo"&gt; &lt;!-- 遮罩层 --&gt; ...
使用vue的图片裁剪vue-cropper
Anything2207294253的博客
03-07 1423
vue-cropper官网https://github.com/xyxiao001/vue-cropperhttps://links.jianshu.com/go?to=https%3A%2F%2Fgithub.com%2Fxyxiao001%2Fvue-cropper 项目需求需要固定的裁剪框的大小 安装 npm install vue-cropper 使用 <cropper-image @imgUpload="imgUpload"></cropper-imag...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

乐闻x

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值