1. 程式人生 > >前端圖片上傳那些事兒

前端圖片上傳那些事兒

本文講的圖片上傳,主要是針對上傳頭像的。大家都知道,上傳頭像一般都會分成以下 4 個步驟:

選擇圖片 -> 預覽圖片 -> 裁剪圖片 -> 上傳圖片

接下來,就詳細的介紹每個步驟具體實現。

選擇圖片

選擇圖片有什麼好講的呢?不就一個 input[type=file] ,然後點選就可以了嗎?確實是這樣的,但是,我們想要做得更加的友好一些,比如需要過濾掉非圖片檔案, 或只允許從攝像頭拍照獲取圖片等,還是需要進行一些簡單配置的。

下面就先來看看最簡單的選擇圖片:

<input type="file" />

這時候,點選這個 input , 在 iOS 手機的顯示如下:

其中的 “瀏覽” 選項,可以檢視到非圖片型別的檔案,這並不是我們想要的結果,畢竟我們只想要圖片型別。可以通過 accept 屬性來實現,如下:

  <input type="file" accept="image/*">

這樣就可以過濾掉非圖片型別了。但是圖片的型別可能也太多了, 有些可能伺服器不支援,所以,如果想保守一些,只允許 jpgpng 型別,可以寫成這樣:

<input type="file" accept="image/jpg, image/jpeg, image/png">

或:

<input type="file" accept=".jpg, .jpeg, .png">

OK, 過濾非圖片的需求搞定了。但是有時候 ,產品還要求只能從攝像頭採集圖片,比如需要上傳證件照,防止從網上隨便找別人的證件上傳,那capture 屬性就可以派上用場了:

  <input type="file" accept="image/*" capture>

這時候,就不能從檔案系統中選擇照片了,只能從攝像頭採集。到了這一步,可能覺得很完美了,但是還有個問題,可能有些變態產品要求預設開啟前置攝像頭採集圖片,比如就是想要你的自拍照片。 capture

預設呼叫的是後置攝像頭。預設啟用前置攝像頭可以設定 capture="user" ,如下:

<input type="file" accept="image/*" capture="user">

好啦,關於選擇圖片的就講麼這麼多了,有個注意的地方是,可能有些配置在相容性上會有一些問題,所以需要在不同的機型上測試一下看看效果。

下面再來談談預覽圖片的實現。

預覽圖片

在遠古時代,前端並沒有預覽圖片的方法。當時的做法時,使用者選擇圖片之後,立刻把圖片上傳到伺服器,然後伺服器返回遠端圖片的 url 給前端顯示。這種方法略顯麻煩,而且會浪費使用者的流量,因為使用者可能還沒有確定要上傳,你卻已經上傳了。幸好,遠古時代已經離我們遠去了,現代瀏覽器已經實現了前端預覽圖片的功能。常用的方法有兩個,分別是 URL.createObjectURL()FileReader 。雖然他們目前均處在 w3c 規範中的 Working Draft 階段, 但是大多數的現代瀏覽器都已經良好的支援了。 下面就介紹一下如何使用這兩個方法。

1. 使用 URL.createObjectURL 預覽

URL.createObjectURL() 靜態方法會建立一個 DOMString,其中包含一個表示引數中給出的物件的 URL。這個 URL 的生命週期和建立它的視窗中的 document 繫結。這個新的URL 物件表示指定的 File 物件或 Blob 物件。用法用下:

objectURL = URL.createObjectURL(object);

其中,object 引數指 用於建立 URL 的 File 物件、Blob 物件或者 MediaSource 物件。

對於我們的 input[type=file] 而言, input.files[0] 可以獲取到當前選中檔案的 File 物件。示例程式碼如下:

  <input id="inputFile" type="file" accept="image/*">
  <img src="" id="previewImage" alt="圖片預覽">
  <script>
    const $ = document.getElementById.bind(document);
    const $inputFile = $('inputFile');
    const $previewImage = $('previewImage');
    $inputFile.addEventListener('change', function() {
      const file = this.files[0];
      $previewImage.src = file ? URL.createObjectURL(file) : '';
    }, this);
  </script>

具體用法可以參考 MDN上的 URL.createObjectURL(),

2. 使用 FileReader 預覽

FileReader 物件允許Web應用程式非同步讀取儲存在使用者計算機上的檔案(或原始資料緩衝區)的內容,使用 File 或 Blob 物件指定要讀取的檔案或資料。同理的,我們也可以通過 input.files[0] 獲取到當前選中的圖片的 File 物件。

特別注意,FileReader 和 是非同步讀取檔案或資料的!

下面是使用 FileReader 預覽圖片的示例:

<input id="inputFile" type="file" accept="image/*">
  <img src="" id="previewImage" alt="圖片預覽">
  <script>
    const $ = document.getElementById.bind(document);
    const $inputFile = $('inputFile');
    const $previewImage = $('previewImage');
    $inputFile.addEventListener('change', function() {
      const file = this.files[0];
      const reader = new FileReader();
      reader.addEventListener('load', function() {
        $previewImage.src = reader.result;
      }, false);
      
      if(file) {
        reader.readAsDataURL(file);
      }
    }, false)
  </script>

會發現, FileReader 會相對複雜一些.

更多關於 FileReader 的用法 ,可以參考 MDN 文件 FileReader

兩種方法的對比

我個人更加傾向於使用 URL.createObjectURL() 。主要原先它的 API 簡潔,同步讀取,並且他返回的是一個 URL ,比 FileReaer 返回的base64 更加精簡。相容性上,兩者都差不多,都是在 WD 的階段。效能上的對比, 在 chrome 上, 選擇了一張 2M 的圖片, URL.createObjectURL() 用時是 0 , 而 FileReader 用時 20ms 左右。 0 感覺不太合理,雖然這個方法立刻就會返回一個 URL ,但是我猜測實際上這個 URL 指定的內容還沒有生成好,應該是非同步生成的,然後才渲染出來的。所以並沒有很好的辦法來對比他們的效能。

如果想要學習更多關於圖片預覽,可以閱讀以下兩篇文章:

  • 使用FileReader實現前端圖片預覽
  • js圖片/視訊預覽 - URL.createObjectURL()

裁剪圖片

關於圖片的裁剪,很自然的會想到使用 canvas ,確實是要通過 canvas, 但是如果全部我們自己來實現,可能需要做比較多的工作,所以為了省力,我們可以站在巨人的肩膀上。比較優秀的圖片裁剪庫是 cropperjs , 該庫可以對圖片進行縮放、移動和旋轉。

cropperjs 的詳細配置這裡就不展開了 ,需要的可以自己去看文件就好。下面我們就以這個庫為基礎,實現一個裁剪人臉的例子:

<input id="inputFile" type="file" accept="image/*">
  <img class="preview-image" id="previewImage" src="" alt="">
  <!-- cropper裁剪框 -->
  <div class="cropper" id="cropper">
    <div class="inner">
      <div class="face-container">
        <img class="cropper-image" id="cropperImage">
      </div>
      <div class="tips">請將面部區域置於人臉框架內</div>
      <div class="toolbar">
        <div class="btn" id="confirm">確認</div>
      </div>
    </div>
  </div>
  <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/cropperjs/1.5.6/cropper.min.css">
  <script src="https://cdnjs.cloudflare.com/ajax/libs/cropperjs/1.5.6/cropper.min.js"></script>
 
 <style>
  .preview-image,
  .cropper-image {
    max-width: 100%;
  }

  .cropper {
    display: none;
    position: absolute;
    top: 0;
    right: 0;
    bottom: 0;
    left: 0;
    background: #ccc;
    font-size: 0.27rem;
    text-align: center;
  }

  .inner {
      height: 100%;
      display: flex;
      flex-direction: column;
      justify-content: center;
      align-items: center;
    }

    .face-container {
      position: relative;
      width: 320px;
      height: 320px;
      margin: 50px  auto;
    }

    .cropper-modal {
      background: url('https://ok.166.net/gameyw-misc/opd/squash/20191028/152551-m37snfsyu1.png') center no-repeat;
      background-size: 100% 100%;
      opacity: 1;
    }

    .cropper-bg {
      background: none;
    }

    .cropper-view-box {
      opacity: 0;
    }

    .tips {
      font-size: 16px;
    }

    .toolbar {
      display: flex;
      justify-content: center;
      margin: 50px 0;
    }

    .btn {
      width: 150px;
      line-height: 40px;
      font-size: 20px;
      text-align: center;
      color: #fff;
      background: #007fff;
    }
  </style>

  <script>
  const $ = document.getElementById.bind(document);
  const $cropper = $('cropper');
  const $inputFile = $('inputFile');
  const $previewImage = $('previewImage');
  const $cropperImage = $('cropperImage');
  const $confirmBtn = $('confirm')
  let cropperInstance = null;

  // 選擇圖片後,顯示圖片裁剪框
  $inputFile.addEventListener('change', function() {
    const file = this.files[0];
    if(!file) return;
    $cropperImage.src = URL.createObjectURL(file);
    showCropper();
  }, false);

  // 點選確認按鈕,將裁剪好的圖片放到 img 標籤顯示。
  $confirmBtn.addEventListener('click', function() {
    const url = cropperInstance.getCroppedCanvas().toDataURL("image/jpeg", 1.0);
    $cropper.style.display = 'none';
    $previewImage.src = url;
  }, false);


  function showCropper() {
    $cropper.style.display = 'block';
    cropperInstance && cropperInstance.destroy();
    cropperInstance = new Cropper($cropperImage, {
      viewMode: 1,
      aspectRatio: 1,
      autoCropArea: 1,
      dragMode: 'move',
      guides: false,
      highlight: false,
      cropBoxMovable: false,
      cropBoxResizable: false
    });
  }
  </script>

效果圖如下:

上傳

前面的操作已經完成了圖片上傳前的準備,包括選擇圖片、預覽圖片、編輯圖片等,那接下來就可以上傳圖片了。上面的例子中,使用了 cropperInstance.getCroppedCanvas() 方法來獲取到對應的 canvas 物件 。有了 canvas 物件就好辦了,因為 canvas.toBlob() 方法可以取得相應的 Blob 物件,然後,我們就可以把這個 Blob 物件新增到 FromData 進行無重新整理的提交了。大概的程式碼如下:

function uploadFile() {
    cropperInstance.getCroppedCanvas().toBlob(function(blob) {
      const formData = new FormData();
      formData.append('avatar', blob);
      fetch('xxxx', {
        method: 'POST',
        body: formData
      });
    });
  }

這段程式碼並不能真正執行,因為我們還沒有對應的後端伺服器。如果想要嘗試上傳圖片的朋友,可以參考一下這篇文章 寫給新手前端的各種檔案上傳攻略,從小圖片到大檔案斷點續傳,由於篇幅原因,這裡就不展開啦。

後記

關於圖片上傳的介紹,差不多不到些結束了。但是之前在 iPhone 和 小米 手機上,遇到一個奇怪的問題: 就是我使用前置攝像頭自拍出來的照片,選擇之後 ,會自逆時針旋轉 90 度,比如像下圖:

拍照的時候明明就是正著拍的,為什麼預覽就會變成橫著了呢?當時第一次遇到這個問題的時候,也覺得好奇怪。後來查了一下,得知這是因為拍照時,相機都會記錄拍照的角度資訊,可能 iPhone 前置攝像頭記錄的角度資訊和其他的有點一樣,而 iPhone 自己的相簿在瀏覽照片時,自動糾正了角度 ,而瀏覽器卻沒有糾正,所以才會出現這個旋轉。

為了解決這個問題,需要使用 EXIF 這個庫來處理。

我剛剛試了一下,發現我的 iPhone 現在竟然不會有這個問題了,大概是半年前,當時在做一個需求時,自拍的圖片會發生這種旋轉,有可能是 iOS 系統升級後, 已經修復了這個問題。而現在身邊又沒有小米手機, 所以也不好復現。還好,當時我儲存了一張會自動旋轉的圖片。大家可以到這裡下載:

https://ok.166.net/gameyw-misc/opd/squash/20191028/170829-f5t38i0d9k.png

這圖片下載後,用電腦的圖片檢視器開啟是正常的,但是,在瀏覽器中,選擇這個圖片後,使用 URL.createObjectURL()FileReader 來預覽就會發生旋轉。甚至直接 img 標籤引入也會逆時針旋轉了 90 度,比如:

<img src="https://ok.166.net/gameyw-misc/opd/squash/20191028/170829-f5t38i0d9k.png">

效果如下:

下面就以這張圖片為例,介紹一下如何使用 EXIF 來檢測圖片角度。關於 EXIF 的詳細用法大家可以到 github 的主頁上檢視 https://github.com/exif-js/exif-js

  <img id="exifImage" src="https://ok.166.net/gameyw-misc/opd/squash/20191028/170829-f5t38i0d9k.png" alt="">

  <script src="https://cdnjs.cloudflare.com/ajax/libs/exif-js/2.3.0/exif.js"></script>
  <script>
      const $exifImage = document.getElementById('exifImage');
      $exifImage.onload = function() {
        EXIF.getData($exifImage, function() {
          let allMetaData = EXIF.getAllTags(this);
          console.log(allMetaData.Orientation); // 6
        });
      };
  </script>

上面程式碼的輸出 allMetaData.Orientation 的結果為 6 , 那 6 到底是什麼意思呢? 可以參考這個篇文章 http://sylvana.net/jpegcrop/exif_orientation.html 裡面有個表格:

可以看出,攝像頭資訊是逆時針旋轉了 90 度。那要怎麼糾正呢?就順時針旋轉 90 度抵消掉這個角度就好。

事實上, CropperJS 也會檢測圖片的 EXIF 資訊,並且會自動糾正角度的,詳情參考 https://github.com/fengyuanchen/cropperjs#checkorientation
這裡也提到了,但只支援讀取 jpg 圖片的 EXIF 資訊,而我們這張圖片是 PNG 所以並不支援。

有個 CSS 屬性叫做 image-orientation , 它有個值叫做 from-image , 就是使用圖片的 EXIF 資料來旋轉的。可惜,目前 chrome 不支援該屬性。有興趣的可以瞭解一下。

好啦,就先寫到這裡啦,有問題的歡迎在評論區交流哈~

PS: 已經有大半年沒有更新過文章了,先定個小目標,以後每兩個星期更新一篇。