脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 网络编程 → JavaScript → javascript类库 → vue.js → Vue Cropper图片裁剪

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图片裁剪内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

相关文章

  • VsCode新建VueJs项目的详细步骤

    VsCode新建VueJs项目的详细步骤

    本篇文章主要介绍了VsCode新建VueJs项目的详细步骤，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
    2017-09-09
  • Vue3.0中如何监听props方法

    Vue3.0中如何监听props方法

    这篇文章主要介绍了Vue3.0中如何监听props方法，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
    2022-04-04
  • 使用@tap.stop阻止事件继续传播

    使用@tap.stop阻止事件继续传播

    这篇文章主要介绍了使用@tap.stop阻止事件继续传播，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
    2022-03-03
  • Vue+Element-U实现分页显示效果

    Vue+Element-U实现分页显示效果

    这篇文章主要为大家详细介绍了Vue+Element-U实现分页显示效果，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
    2020-11-11
  • Vuex中actions优雅处理接口请求的方法

    Vuex中actions优雅处理接口请求的方法

    在项目开发中，如果使用到了 vuex，通常我会将所有的接口请求单独用一个文件管理，这篇文章主要介绍了Vuex中actions如何优雅处理接口请求,业务逻辑写在 actions 中，本文给大家分享完整流程需要的朋友可以参考下
    2022-11-11
  • vue的自定义指令传参方式

    vue的自定义指令传参方式

    这篇文章主要介绍了vue的自定义指令传参方式，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
    2022-05-05
  • VUE2实现事件驱动弹窗示例

    VUE2实现事件驱动弹窗示例

    本篇文章主要介绍了VUE2实现事件驱动弹窗示例，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
    2017-10-10
  • el-form-item中表单项label和表单项内容换行实现方法

    el-form-item中表单项label和表单项内容换行实现方法

    这篇文章主要给大家介绍了el-form-item中表单项label和表单项内容换行实现的相关资料,每个表单el-form由多个表单域el-form-item组成,需要的朋友可以参考下
    2023-09-09
  • Vue项目中使用jsonp抓取跨域数据的方法

    Vue项目中使用jsonp抓取跨域数据的方法

    这篇文章主要介绍了Vue项目中使用jsonp抓取跨域数据的方法，本文通过实例代码讲解的非常详细,需要的朋友可以参考下
    2019-11-11
  • vue3封装Element导航菜单的实例代码

    vue3封装Element导航菜单的实例代码

    这篇文章主要介绍了vue3封装Element导航菜单的实例代码,分为菜单数据格式示例,控制导航收缩的详细代码,本文通过实例代码介绍的非常详细,感兴趣的朋友跟随小编一起看看吧
    2024-03-03

最新评论