天天看點

5分鐘搞定圖檔裁剪,上傳

先給大家看一下最終效果。

大多數功能都是由 Cropper.js封裝好的,調整并制作了:

  • 上傳圖檔
  • 對圖檔的裁剪以及調整(旋轉、縮放)、
  • 實時預覽
  • 将裁剪後的資料儲存為blob發送至後端。
5分鐘搞定圖檔裁剪,上傳
5分鐘搞定圖檔裁剪,上傳

Q1:為什麼選擇Cropper.js和如何安裝Cropper.js?

一開始制作這個需求思路有兩個,使用canvas原生或者尋找現成的庫,對比了一番覺得canvas實作時間耗費較長,且秉承着不重複造輪子的原則(其實是菜),決定使用Cropper.js。官方封裝了很多參數、方法、事件,上手容易,文檔閱讀體驗較好、而且便于擴充。

Cropper.js官方倉庫+文檔:github.com/fengyuanche…

Installation

npm install cropperjs           

複制

Q2:如何上傳圖檔?

我們實作上述功能需要的核心HTMl部分隻有:

<!-- 1.一個用于擷取上傳檔案的input,type="file",并且監聽onchange事件  -->
    <input 
        type="file"     
        accept="image/*" 
        id="imgReader" 
        onchange="loadingImg"
        > 

    <!-- 2.一個用于給Cropper.js覆寫使用的img  -->
    <img id="cropImg">
    
    <!-- 3.兩個用于預覽的div  -->
    <div class="previewText">裁剪預覽</div>
    <div class="previewBox"></div>           

複制

首先先将用于上傳的input隐藏起來,我們并不需要它的樣式

.inpuFile{
    display: none;
}           

複制

然後給你項目中的某個按鈕添加一個點選事件,并且調用

function uploadImg(){
            document.querySelector('#imgReader').click()
    },           

複制

即可打開上傳檔案的視窗,然後選擇你需要的圖檔

5分鐘搞定圖檔裁剪,上傳

Q3:如何将圖檔讀取顯示和使用Cropper.js添加裁剪控件?

上傳檔案成功後,會觸發onchange事件,調用loadingImg()

//引入Cropper.js

import 'cropperjs/dist/cropper.css';
import Cropper from 'cropperjs';

const CROPPER = null    //建立一個cropper的全局對象 

function loadingImg(eve){
 //讀取上傳檔案
    let reader = new FileReader();
    if(event.target.files[0]){
    
    //readAsDataURL方法可以将File對象轉化為data:URL格式的字元串(base64編碼)
        reader.readAsDataURL(eve.target.files[0]);
        reader.onload = (e)=>{
            let dataURL = reader.result;
            //将img的src改為剛上傳的檔案的轉換格式
            document.querySelector('#cropImg').src = dataURL;  
            
            const image = document.getElementById('cropImg');  
            
            //建立cropper執行個體-----------------------------------------
            CROPPER = new Cropper(image, {
                aspectRatio: 16 / 16,
                viewMode:0,
                minContainerWidth:500,
                minContainerHeight:500,
                dragMode:'move',
                preview:[ document.querySelector('.previewBox'),
                        document.querySelector('.previewBoxRound')]
            })
        }
    }
   }           

複制

new Cropper方法:

new Cropper(element[, options])

第一個參數:element

  • 類型:HTMLImageElement 或 HTMLCanvasElement;
  • 作用:用于顯示裁剪功能;

第二個參數(可選):

  • 類型: Object;
  • 作用:用于添加具體參數設定

我們需要用到的參數有:

{
    aspectRatio: 16 / 16,    //固定裁剪框的比例(橫/豎),此處16/16則固定為正方形
    minContainerWidth:500,   //容器最小的寬度
    minContainerHeight:500,  //容器最小的高度
    dragMode:'move',         //設定裁剪框為可以移動
    preview:[ document.querySelector('.previewBox'),           //設定我們需要添加實時預覽的地方
            document.querySelector('.previewBoxRound')]
            
    //更多參數請參照官方倉庫...我們這裡用不着
}           

複制

先忽略實時預覽,完成到這裡我們就可看到我們上傳的圖檔以及裁剪功能:

5分鐘搞定圖檔裁剪,上傳

Q4:如何進行實時預覽?

上面建立cropper的時候,我們在選項中添加了

preview:[ document.querySelector('.previewBox'),           
              document.querySelector('.previewBoxRound')]           

複制

preview就是用來設定我們需要實時預覽的地方,但是設定完成之後要給上述的兩個div添加一下樣式,才可以正常顯示

.previewBox,.previewBoxRound{
    box-shadow: 0 0 5px #adadad;
    width: 100px;
    height: 100px;
    margin-top: 30px;
    overflow: hidden;       /*這個超出設定為隐藏很重要,否則就會整個顯示出來了*/
}
.previewBoxRound{
    border-radius: 50%;     /*設定為圓形*/     
}           

複制

5分鐘搞定圖檔裁剪,上傳

Q5:如何擷取裁剪資料并發送至後端?

function GetData(){
        //getCroppedCanvas方法可以将裁剪區域的資料轉換成canvas資料
          CROPPER.getCroppedCanvas({
                maxWidth: 4096,
                maxHeight: 4096,
                fillColor: '#fff',
                imageSmoothingEnabled: true,
                imageSmoothingQuality: 'high',
            }).toBlob((blob) => {
               //然後調用浏覽器原生的toBlob方法将canvas資料轉換成blob資料
               //之後就可以愉快的将blob資料發送至後端啦,可根據自己情況進行發送,我這裡用的是axios
                const formData = new FormData();
                // 第三個參數為檔案名,可選填.
                formData.append('croppedImage', blob/*, 'example.png' */);
                let config = {
                    headers:{'Content-Type':'multipart/form-data'}
                }   
                this.$axios.post(flow_mission_UploadFile(),param,config)
                    .then((response)=>{ 
                        console.log(response)    
                    })
                    .catch((err)=>{
                        console.log(err)
                    })
            })
    }                  

複制

其他需要注意的地方:
           

複制

1.裁剪框尺寸問題

裁剪部分預設會根據上傳圖檔的大小進行改變

  • 解決圖檔過小的問題:
//在new Cropper的參數中設定
    
    minContainerWidth:500,   //容器最小的寬度
    minContainerHeight:500,  //容器最小的高度           

複制

複制代碼
           

複制

  • 解決圖檔過大的問題: 給添加強定寬度樣式
#cropImg{
        height: 450px;
        width: 450px;
        box-shadow: 0 0 5px #adadad;
    }           

複制

2.重複上傳的問題

再次上傳不同圖檔的時候,還是出現原來的圖檔,隻需要在上傳檔案的時候,對之前存在的CROPPER進行摧毀就可以了

function uploadImg(){
            document.querySelector('#imgReader').click()
            if(CROPPER){
                CROPPER.destroy()
            }
    },3.其他功能的實作           

複制

這裡列舉幾個我這裡用到的

  • CROPPER.rotate(90) :旋轉圖檔,機關為數字,90為順時針旋轉90度
  • CROPPER.zoom(0.1) :縮放圖檔,機關為數字,0.1為在原縮放基礎上增加0.1倍
  • CROPPER.reset() :重置對圖檔的所有操作

還有很多其他方法和事件可以自行參照倉庫,一個普通的上傳頭像功能就這樣應該夠用了!這裡就不一一列舉了。

謝謝大家。