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

前言

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