DIV CSS 佈局教程網

自己寫一支 jQuery 檔案上傳外掛:限制格式與大小
編輯:JQuery特效代碼     

表單上傳前先在客戶端擋掉格式不對、檔案過大的選擇,是基本禮儀。市面上成熟的外掛介面漂亮、功能齊全,但偶爾會遇到瀏覽器相容性問題。其實這個需求自己寫並不難,一支幾十行的小外掛就夠用。

外掛主體

命名為 checkFileTypeAndSize.js。運作方式是:比對副檔名是否在允許清單中來限制格式;再分別處理 IE 與其他瀏覽器取得檔案大小,超過上限就攔下;並對外提供三個回呼——成功、格式錯誤、超出大小。

(function ($) {
  $.fn.checkFileTypeAndSize = function (options) {
    // 預設設定
    var defaults = {
      allowedExtensions: [],
      maxSize: 1024, // 單位 KB,預設 1MB = 1024KB
      success: function () { },
      extensionerror: function () { },
      sizeerror: function () { }
    };

    options = $.extend(defaults, options);

    return this.each(function () {
      $(this).on('change', function () {
        var filePath = $(this).val();
        var fileLowerPath = filePath.toLowerCase();
        var extension = fileLowerPath.substring(fileLowerPath.lastIndexOf('.') + 1);

        // 副檔名不在允許清單中
        if ($.inArray(extension, options.allowedExtensions) == -1) {
          options.extensionerror();
          $(this).focus();
        } else {
          try {
            var size = 0;
            if ($.browser.msie) { // 舊版 IE
              var fileMgr = new ActiveXObject("Scripting.FileSystemObject");
              var fileObj = fileMgr.getFile(filePath);
              size = fileObj.size / 1024; // byte → kb
            } else {
              size = $(this)[0].files[0].size / 1024; // byte → kb
            }

            if (size > options.maxSize) {
              options.sizeerror();
            } else {
              options.success();
            }
          } catch (e) {
            alert("錯誤:" + e);
          }
        }
      });
    });
  };
})(jQuery);

呼叫端

<input type="file" name="f" id="f"/>

@section scripts
{
  <script src="~/Scripts/checkFileTypeAndSize.js"></script>
  <script type="text/javascript">
    $(function () {
      $('#f').checkFileTypeAndSize({
        allowedExtensions: ['jpg'],
        maxSize: 10,
        success: function () {
          alert('ok');
        },
        extensionerror: function () {
          alert('允許的格式為:jpg');
          return;
        },
        sizeerror: function () {
          alert('最大尺寸 10kb');
          return;
        }
      });
    });
  </script>
}

幾個實務提醒

這只是第一道關卡。客戶端檢查的目的是改善使用者體驗,任何值都可以被竄改,伺服器端務必再驗一次格式與大小。

副檔名不等於真實型別。把 .exe 改名為 .jpg 就能繞過這類檢查。若要求更嚴謹,可搭配 file.type(MIME)甚至讀取檔頭的 magic number 交叉比對。

$.browser 已被移除。jQuery 1.9 之後不再提供 $.browser,那段 IE 分支需要自行改用 navigator.userAgent 或 document.documentMode 判斷;而 ActiveXObject 方案也只在舊版 IE 有效,現代瀏覽器一律走 File API。

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