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

更新时间：2024年11月20日 09:10:19 作者：乐闻x

图片裁剪功能无论是用户头像的裁剪,还是图片内容的精确调整,都成为了提升用户体验的关键一环,本文将详细介绍如何在Vue.js项目中集成并使用Cropper.js实现一个强大的图片裁剪组件,需要的可以参考下

前言

图片裁剪功能无论是用户头像的裁剪，还是图片内容的精确调整，都成为了提升用户体验的关键一环。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>

解释

文件选择器：通过一个元素，用户可以选择要裁剪的图片文件。

图片预览与 Cropper 实例化：当用户选择图片后，我们使用 URL.createObjectURL 方法生成图片的 URL，并将其赋值给 imageUrl。然后，我们在 nextTick 中创建 Cropper 实例。

图片裁剪：点击 “裁剪图片” 按钮后，我们调用 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" rel="external nofollow"  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使用Cropper实现图片裁剪功能的文章就介绍到这了,更多相关Vue Cropper图片裁剪内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

关于Vue.js 2.0的Vuex 2.0 你需要更新的知识库
关于Vue.js 2.0 的 Vuex 2.0你需要更新的知识库，感兴趣的小伙伴们可以参考一下
2016-11-11
vue+elementUI中表格高亮或字体颜色改变操作
这篇文章主要介绍了vue+elementUI中表格高亮或字体颜色改变操作，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-11-11
浅谈在vue-cli3项目中解决动态引入图片img404的问题
这篇文章主要介绍了浅谈在vue-cli3项目中解决动态引入图片img404的问题，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-08-08
VUE引入腾讯地图并实现轨迹动画的详细步骤
这篇文章主要介绍了VUE引入腾讯地图并实现轨迹动画,引入步骤大概是在 html 中通过引入 script 标签加载API服务，结合实例代码给大家介绍的非常详细，需要的朋友可以参考下
2022-09-09
element多个table实现同步滚动的示例代码
本文主要介绍了element多个table实现同步滚动，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-09-09
Vue.js递归组件构建树形菜单
这篇文章主要介绍了用Vue.js递归组件构建一个可折叠的树形菜单的教学内容，有兴趣的朋友跟着学习下。
2017-12-12
使用Vue自定义数字键盘组件(体验度极好)
最近做 Vue 开发，因为有不少页面涉及到金额输入，产品老是觉得用原生的 input 进行金额输入的话体验很不好，于是自己动手写了一个使用Vue自定义数字键盘组件，具体实现代码大家参考下本文
2017-12-12
Vue CLI 2.x搭建vue(目录最全分析)
这篇文章主要介绍了Vue CLI 2.x搭建vue(目录最全分析),小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2019-02-02
vue中使用protobuf的过程记录
由于目前公司采用了ProtoBuf做前后端数据交互，进公司以来一直用的是公司大神写好的基础库，完全不了解底层是如何解析的。下面小编给大家分享vue中使用protobuf的过程记录，需要的朋友参考下吧
2018-10-10
vue2.0基于vue-cli+element-ui制作树形treeTable
这篇文章主要介绍了vue2.0基于vue-cli+element-ui制作树形treeTable，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-04-04