DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5教程
HTML5 在客戶端就攔住超大與錯誤類型的檔案
編輯:HTML5教程     

用戶選好檔案再按上傳,結果傳到一半才發現檔案幾百 MB,或者類型根本不對——這種體驗放在今天已經很難被接受。HTML5 帶來的 File API,讓我們可以在瀏覽器端就完成這類校驗,不必等請求打到伺服器才報錯。

瀏覽器到底給了我們什麼

支援 HTML5 的瀏覽器都實作了 W3C 的文件 API 標準。當用戶透過 file 類型的輸入框選檔之後,input 元素的 files 屬性會是一個 FileList 集合,每個 File 物件都自帶這些資訊:

name 是檔名,size 是檔案大小(單位為位元組),type 是 MIME 類型,lastModifiedDate 是最後修改時間。有了 size 與 type,大小與格式的判斷就變成純粹的條件判斷而已。

把規則寫在標籤上

我喜歡把限制條件直接寫成自訂屬性,這樣規則和輸入框綁在一起,後續維護不用來回翻 JavaScript:

<input type="file" data-file_type="zip|png" data-max_size="1000000">

data-file_type 用竖線分隔允許的副檔名,data-max_size 則是上限位元組數,這裡的 1000000 約等於 1MB。

副檔名轉成 MIME 類型

File 物件給的是 MIME 類型(例如 image/png),但我們在標籤上寫的是副檔名,中間需要一張對照表:

var mime_types = {
  "gif":  "image/gif",
  "jpeg": ["image/jpeg", "image/pjpeg"],
  "jpg":  ["image/jpeg", "image/pjpeg"],
  "png":  ["image/png", "image/x-png"]
};

注意有些類型對應多個 MIME 寫法,所以值設計成陣列。轉換函數就是把傳入的副檔名逐一查表,把結果彙整成一個陣列:

function get_mimes(extensions){
  var mimes = [];
  for (var i in extensions){
    var ext = extensions[i];
    if (ext in mime_types){
      var mime = mime_types[ext];
      $.isArray(mime) ? jQuery.merge(mimes, mime) : mimes.push(mime);
    }
  }
  return mimes;
}

監聽 change 並逐檔檢查

核心邏輯是這樣的:先比對類型,再比對大小,任何一關沒過就清空輸入框並提示,全部通過就把檔案資訊顯示出來作為回饋。

$('input[type=file]').each(function(){
  var $this = $(this);
  var mimes = get_mimes($this.attr('data-file_type').split('|'));
  var max_size = parseInt($this.attr('data-max_size'));

  $this.change(function(evt){
    var files = evt.target.files;
    for (var i = 0, f; f = files[i]; i++){
      if (jQuery.inArray(f.type, mimes) === -1){
        alert('不允許的檔案類型:' + f.type);
        $(this).val('');
        continue;
      } else if (f.size > max_size){
        alert('檔案大小上限為 ' + max_size + ' 位元組。');
        $(this).val('');
      } else {
        console.log(f.name, f.type, f.size, f.lastModifiedDate);
      }
    }
  });
});

這裡有幾個實務上值得留意的點。第一,把 $(this).val('') 清空是必要的,否則用戶改了檔案,change 事件不會再次觸發。第二,MIME 類型可以偽造,客戶端校驗只是為了「早點告知用戶」,絕不能當成安全措施,伺服器端一定要再驗一次。第三,type 在某些系統上會是空字串,遇到這種情況通常得退回用副檔名判斷。

想深入了解 File API 的完整定義,可以參考 W3C 的文件:

https://www.w3.org/TR/file-upload/

總的來說,客戶端校驗的定位應該是「體驗優化」而非「安全防線」。把明顯的錯誤擋在傳輸之前,用戶和伺服器都輕)=(pdf、mp3、mp4 之類的媒體檔案直接丟給瀏覽器內建播放器處理),結果用戶明明只想把檔案存到本機,卻被導航走了。這時候 download 屬性就派上用場。

怎麼用

寫法非常簡單,在 a 標籤上加一個 download 屬性即可,屬性值就是存檔時要用的檔名:

<a href="downloadpdf.php" download="download.pdf">點擊直接下載並存成 download.pdf</a>

這個屬性有兩個作用:一是強制下載而不是開啟,二是重新命名。第二點在實務上特別實用——伺服器自動產生的檔案往往叫 acme-doc-2.0.1.txt 這種名字,透過 download 就能讓用戶存成 Acme Documentation (ver. 2.0.1).txt 這種看得懂的檔名(記得保留副檔名)。屬性值也可以用 JavaScript 動態改寫。

官方範例:https://tutsplus.github.io/download-attribute/index.html

幾個瀏覽器限制

基於安全考量,各瀏覽器對這個屬性的態度並不一致。Firefox 要求被下載的檔案必須來自同一個伺服器或網域,否則會忽略屬性、直接在瀏覽器開啟。Chrome 與 Opera 的規則更嚴格:如果是跨網域資源,屬性會被直接忽略,連檔名也不會改。

也就是說,download 屬性只對同源資源可靠生效。如果你的檔案放在 CDN 上,靠這個屬性改名的想法基本行不通。

為不支援的瀏覽器準備退路

寫這篇文章時,Safari 與 IE 尚未實作 download 屬性。既然不能強迫下載,至少可以引導用戶手動操作。做法是用 Modernizr 檢測支援情況,不支援時在連結後插入一段提示文字:

if (!Modernizr.adownload) {
  var $link = $('a');
  $link.each(function(){
    var $download = $(this).attr('download');
    if (typeof $download !== typeof undefined && $download !== false){
      var $el = $('<div>').addClass('download-instruction')
                .text('請按右鍵選擇「連結檔案另存新檔」');
      $el.insertAfter($(this));
    }
  });
}

腳本邏輯很直白:逐一檢查頁面上帶有 download 屬性的連結,若瀏覽器不支援,就在連結下方補一段操作指引。

這類「新屬性 + 降級提示」的組合,是處理 HTML5 新特性時相當實用的通用套路:先給支援的瀏覽器更好的體驗,再為其餘的預留一條走得通的路。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved