前端實(shí)現(xiàn)圖片裁剪并上傳的完整流程

更新時(shí)間：2025年05月23日 08:41:49 作者：Micro麥可樂(lè)

在前端開(kāi)發(fā)中,圖片上傳是非常常見(jiàn)的功能,尤其是在用戶(hù)頭像設(shè)置、商品圖上傳等場(chǎng)景中,我們往往還需要在上傳前提供裁剪功能,在此博主將詳細(xì)講解如何在前端實(shí)現(xiàn)一個(gè)“圖片裁剪上傳”的完整流程,需要的朋友可以參考下

1. 前言：為什么需要圖片裁剪上傳？

在前端開(kāi)發(fā)中，圖片上傳是非常常見(jiàn)的功能，尤其是在用戶(hù)頭像設(shè)置、商品圖上傳等場(chǎng)景中，我們往往還需要在上傳前提供裁剪功能。通過(guò)本地預(yù)覽和實(shí)時(shí)裁剪，用戶(hù)可以：避免上傳冗余數(shù)據(jù)、精準(zhǔn)控制展示內(nèi)容、減少服務(wù)器處理壓力。

在此博主將詳細(xì)講解如何在前端實(shí)現(xiàn)一個(gè)“圖片裁剪上傳”的完整流程，完整內(nèi)容包括：

本地預(yù)覽圖片
用戶(hù)交互與裁剪
實(shí)時(shí)預(yù)覽裁剪結(jié)果
獲取裁剪結(jié)果的 File 對(duì)象
上傳前的處理邏輯

并附有完整的 HTML + JavaScript 示例，適合實(shí)際項(xiàng)目中小伙伴們直接參考或使用

2. 技術(shù)選型

本文使用以下技術(shù)棧來(lái)實(shí)現(xiàn)功能：

原生 HTML / JavaScript：不依賴(lài)框架，易于集成
Cropper.js：一個(gè)優(yōu)秀的圖片裁剪庫(kù)，功能強(qiáng)大，使用簡(jiǎn)單

Cropper.js 官網(wǎng)： https://fengyuanchen.github.io/cropperjs/ 想了解更多使用技巧的小伙伴們可以進(jìn)行查閱

3. 本地圖片預(yù)覽實(shí)現(xiàn)

3.1 基礎(chǔ)文件讀取

用戶(hù)上傳圖片后，我們需要立即在前端進(jìn)行預(yù)覽，這可以通過(guò) File API 結(jié)合 URL.createObjectURL() 方法實(shí)現(xiàn)：

<input type="file" id="imageInput" accept="image/*">
<img id="previewImage" style="max-width: 100%; display: none;">

<button id="uploadBtn">上傳圖片</button>

使用 URL.createObjectURL() 生成臨時(shí)預(yù)覽圖片地址

<script>
const input = document.getElementById('uploadInput');
const previewImage = document.getElementById('previewImage');

input.addEventListener('change', async (e) => {
  const file = e.target.files[0];
  if (!file) return;

  // 通過(guò)URL實(shí)現(xiàn)預(yù)覽
  previewImage.src = URL.createObjectURL(file);
});
</script>

3.2 加入文件類(lèi)型校驗(yàn)

上述代碼我們已經(jīng)可以實(shí)現(xiàn)圖片的預(yù)覽，很多時(shí)候我們還需要對(duì)文件進(jìn)行一些驗(yàn)證，下述代碼可以供小伙伴參考

// 獲得file對(duì)象后進(jìn)行類(lèi)型、大小驗(yàn)證
const file = e.target.files[0];
// 校驗(yàn)文件類(lèi)型和大?。?MB限制）
const MAX_SIZE = 2 * 1024 * 1024;

if (!file.type.startsWith('image/')) {
  alert('請(qǐng)選擇圖片文件');
  return;
}

if (file.size > MAX_SIZE) {
  alert('圖片大小不能超過(guò)2MB');
  return;
}

4. 集成Cropper.js實(shí)現(xiàn)交互式裁剪

通過(guò) Cropper.js 我們可以讓用戶(hù)對(duì)圖片進(jìn)行自由裁剪，這里博主將完整演示從初始化、到獲取裁剪結(jié)果實(shí)時(shí)預(yù)覽、獲取裁剪結(jié)果 File 對(duì)象

4.1 初始化裁剪功能

首先引入 Cropper.js

<link  rel="external nofollow"  rel="external nofollow"  rel="stylesheet">
<script src="https://unpkg.com/cropperjs"></script>

如果你是使用的是 npm 進(jìn)行包管理，可以使用 npm install cropperjs 直接安裝

初始化代碼

let cropper;

previewImage.addEventListener('load', function () {
  if (cropper) {
    cropper.destroy();
  }
  cropper = new Cropper(previewImage, {
    aspectRatio: 1, // 比例1:1，可根據(jù)需求修改
    viewMode: 1, // 限制裁剪框不超過(guò)圖片范圍
    preview: '.img-preview' // 裁剪結(jié)果預(yù)覽區(qū)域
  });
});

4.2 裁剪結(jié)果實(shí)時(shí)預(yù)覽

Cropper.js 支持設(shè)置一個(gè)區(qū)域來(lái)實(shí)時(shí)顯示裁剪結(jié)果：初始化時(shí)候指定的 .img-preview

創(chuàng)建預(yù)覽容器

<div class="img-preview" style="width:100px;height:100px;overflow:hidden;border:1px solid #ccc;"></div>

Cropper.js 會(huì)自動(dòng)更新這個(gè)預(yù)覽區(qū)的內(nèi)容，無(wú)需額外代碼。

4.3 獲取裁剪后的File對(duì)象

當(dāng)用戶(hù)點(diǎn)擊“確定上傳”按鈕后，我們需要將裁剪后的圖片提取出來(lái)，并轉(zhuǎn)為可以上傳的 File 或 Blob 對(duì)象：

document.getElementById('uploadBtn').addEventListener('click', function () {
  if (!cropper) return;

  cropper.getCroppedCanvas({
    width: 200,
    height: 200
  }).toBlob(function (blob) {
    const file = new File([blob], 'cropped.png', { type: 'image/png' });

    // 上傳邏輯
    uploadImage(file);
  });
});

function uploadImage(file) {
  const formData = new FormData();
  formData.append('image', file);
  // 模擬上傳的位代碼
  fetch('/upload', {
    method: 'POST',
    body: formData
  })
  .then(res => res.json())
  .then(data => {
    console.log('上傳成功', data);
  })
  .catch(err => {
    console.error('上傳失敗', err);
  });
}

5. 完整代碼整合

結(jié)合上述的講解，博主把完整的代碼整理出來(lái)，下面是一個(gè)可以直接運(yùn)行的完整 HTML 文件,小伙伴們可以復(fù)制進(jìn)行運(yùn)行測(cè)試：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <title>圖片裁剪上傳示例</title>
  <link  rel="external nofollow"  rel="external nofollow"  rel="stylesheet">
  <script src="https://unpkg.com/cropperjs"></script>
  <style>
    #previewImage {
      max-width: 100%;
      display: none;
    }
    .img-preview {
      width: 100px;
      height: 100px;
      overflow: hidden;
      margin-top: 10px;
      border: 1px solid #ccc;
    }
  </style>
</head>
<body>
  <h2>選擇圖片進(jìn)行裁剪上傳</h2>
  <input type="file" id="imageInput" accept="image/*">
  <br>
  <img id="previewImage">
  <div class="img-preview"></div>
  <br>
  <button id="uploadBtn">上傳圖片</button>
  
  <script>
    const imageInput = document.getElementById('imageInput');
    const previewImage = document.getElementById('previewImage');
    let cropper;

    imageInput.addEventListener('change', function () {
      const file = this.files[0];
      if (file) {
        previewImage.src = URL.createObjectURL(file);
        previewImage.style.display = 'block';
      }
    });

    previewImage.addEventListener('load', function () {
      if (cropper) {
        cropper.destroy();
      }
      cropper = new Cropper(previewImage, {
        aspectRatio: 1,
        viewMode: 1,
        preview: '.img-preview'
      });
    });

    document.getElementById('uploadBtn').addEventListener('click', function () {
      if (!cropper) return;

      cropper.getCroppedCanvas({
        width: 200,
        height: 200
      }).toBlob(function (blob) {
        const file = new File([blob], 'cropped.png', { type: 'image/png' });

        const formData = new FormData();
        formData.append('image', file);

        // 替換成你自己的后端上傳地址
        fetch('/upload', {
          method: 'POST',
          body: formData
        })
        .then(res => res.json())
        .then(data => {
          alert('上傳成功');
          console.log(data);
        })
        .catch(err => {
          alert('上傳失敗');
          console.error(err);
        });
      });
    });
  </script>
</body>
</html>