萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 清空 File 控件值完整方案:跨瀏覽器相容實作

核心難點

<input type="file"> 的 value 屬性**唯讀**,基於安全考量無法直接賦值 fileInput.value = ""。必須透過替換元素或重置表單來清空。

方案對比表

方案原理相容性優點缺點
outerHTML 替換用相同屬性的新元素替換舊元素IE 全版本、Edge (舊)代碼極簡非標準、現代瀏覽器移除、事件綁定丟失
包裹 span + innerHTML 重置外層 span 重新渲染內部 HTML**全瀏覽器** (含現代)標準、相容性最好需額外 DOM 結構、事件需重綁/委派
form.reset()重置整個表單全瀏覽器原生、簡單影響表單所有欄位、需 form 包裹
創建新 input 替換cloneNode + replaceChild 保留屬性全瀏覽器標準、可保留事件 (需手動)代碼較多
Value 清空 (現代瀏覽器)input.value = ""Chrome 81+, Firefox 75+, Safari 14+, Edge 81+最簡單舊瀏覽器無效、Safari 較晚支援

方案一:包裹 Span + innerHTML (最推薦,通用性最強)

HTML 結構

<span id="uploadWrapper">
  <input type="file" id="fileUpload" name="fileUpload" accept="image/*" />
</span>
<button type="button" id="btnClear">清空選擇</button>

JavaScript 實作

// 頁面載入時快取原始 HTML
var originalHtml = document.getElementById("uploadWrapper").innerHTML;

function clearFileInput() {
  var wrapper = document.getElementById("uploadWrapper");
  wrapper.innerHTML = originalHtml; // 重新渲染,產生全新 input 元素
  
  // 重新綁定事件 (若有直接綁定在 input 上)
  // 建議改用事件委派避免此問題
  // document.getElementById("fileUpload").addEventListener("change", handleFileSelect);
}

// 事件委派版 (推薦,無需重綁)
document.getElementById("uploadWrapper").addEventListener("change", function(e) {
  if (e.target.matches("input[type='file']")) {
    handleFileSelect(e.target);
  }
});

document.getElementById("btnClear").addEventListener("click", clearFileInput);

方案二:cloneNode 替換 (保留屬性、標準 DOM API)


function clearFileInputClone(inputId) {
  var input = document.getElementById(inputId);
  if (!input) return;
  
  // 1. 克隆節點 (deep=true 複製屬性與子節點,file input 無子節點)
  var newInput = input.cloneNode(true);
  
  // 2. 關鍵:cloneNode 不會複製事件監聽器 (addEventListener)
  //    若用 onclick 內聯屬性會複製,addEventListener 不會
  //    需手動重新綁定或使用事件委派
  
  // 3. 替換
  input.parentNode.replaceChild(newInput, input);
  
  return newInput; // 返回新元素供後續綁定
}

// 使用
var newInput = clearFileInputClone("fileUpload");
newInput.addEventListener("change", handleFileSelect);

方案三:form.reset() (最簡單,適用表單場景)

<form id="uploadForm">
  <input type="file" id="fileUpload" name="file" />
  <input type="text" name="description" />
  <button type="button" onclick="clearForm()">清空表單</button>
</form>

<script>
function clearForm() {
  document.getElementById("uploadForm").reset();
  // 所有表單欄位恢復初始值 (file 變空、text 變空、checkbox 取消勾選...)
}
</script>

方案四:現代瀏覽器直接清空 (Chrome 81+ / Firefox 75+ / Safari 14+)


function clearFileInputModern(input) {
  try {
    // 現代標準:直接設定 value 為空字串
    input.value = "";
    return true;
  } catch (e) {
    // 降級處理
    return false;
  }
}

// 統一封裝:特性檢測 + 降級
function clearFileInputUniversal(input) {
  if (clearFileInputModern(input)) return;
  
  // 降級:cloneNode 替換
  var newInput = input.cloneNode(true);
  input.parentNode.replaceChild(newInput, input);
  return newInput;
}

// 使用
var fileInput = document.getElementById("fileUpload");
clearFileInputUniversal(fileInput);

jQuery 版本封裝


$.fn.clearFileInput = function() {
  return this.each(function() {
    var $this = $(this);
    
    try {
      // 嘗試現代方式
      this.value = "";
    } catch (e) {
      // 降級:包裹 span 法 (需確保已包裹)
      var $wrapper = $this.parent();
      if ($wrapper.is("span.file-wrapper")) {
        $wrapper.html($wrapper.data("originalHtml"));
      } else {
        // 動態包裹
        $this.wrap('');
        $this.parent().data("originalHtml", $this.parent().html());
        $this.parent().html($this.parent().data("originalHtml"));
      }
    }
    
    // 觸發 change 事件通知其他邏輯
    $this.trigger("change", [{ cleared: true }]);
  });
};

// 使用
$("#fileUpload").clearFileInput();
$("#btnClear").click(function() {
  $("#fileUpload").clearFileInput();
});

完整實戰元件:可複用的檔案上傳區塊

<div class="file-uploader" id="uploader1">
  <!-- 模板區 (隱藏) -->
  <template>
    <div class="file-input-wrapper">
      <input type="file" class="file-input" accept="image/*,.pdf" />
      <button type="button" class="btn-clear" title="清空">×</button>
    </div>
    <div class="file-preview"></div>
    <div class="file-error"></div>
  </template>
</div>

<script>
function FileUploader(containerSelector, options) {
  var $container = $(containerSelector);
  var opts = $.extend({
    accept: "*/*",
    maxSize: 10 * 1024 * 1024, // 10MB
    onSelect: null,
    onClear: null
  }, options);
  
  var template = $container.find("template").html();
  var $wrapper = $container.find(".file-input-wrapper").first();
  
  // 初始化:若無 wrapper 從模板建立
  if (!$wrapper.length) {
    $container.append(template);
    $wrapper = $container.find(".file-input-wrapper");
  }
  
  var $input = $wrapper.find(".file-input");
  var $clearBtn = $wrapper.find(".btn-clear");
  var $preview = $container.find(".file-preview");
  var $error = $container.find(".file-error");
  
  // 事件委派 (不會因清空失效)
  $wrapper.on("change", ".file-input", function(e) {
    var file = this.files[0];
    $error.empty();
    
    if (!file) return;
    
    // 驗證類型
    if (opts.accept !== "*/*" && !matchAccept(file, opts.accept)) {
      $error.text("檔案類型不允許");
      clearInput();
      return;
    }
    
    // 驗證大小
    if (file.size > opts.maxSize) {
      $error.text("檔案過大,最大 " + formatSize(opts.maxSize));
      clearInput();
      return;
    }
    
    // 預覽圖片
    if (file.type.startsWith("image/")) {
      var reader = new FileReader();
      reader.onload = function(e) {
        $preview.html('');
      };
      reader.readAsDataURL(file);
    } else {
      $preview.text(file.name + " (" + formatSize(file.size) + ")");
    }
    
    $clearBtn.show();
    opts.onSelect && opts.onSelect(file, $container);
  });
  
  $clearBtn.on("click", function(e) {
    e.stopPropagation();
    clearInput();
    opts.onClear && opts.onClear($container);
  });
  
  function clearInput() {
    // 現代瀏覽器直接清空
    try {
      $input[0].value = "";
    } catch (e) {
      // 降級:替換 wrapper 內容
      $wrapper.html($wrapper.clone().html()); // 簡易替換
      $input = $wrapper.find(".file-input"); // 更新引用
    }
    $preview.empty();
    $error.empty();
    $clearBtn.hide();
  }
  
  function matchAccept(file, accept) {
    // 簡易 accept 匹配實作
    var types = accept.split(",").map(function(t) { return t.trim(); });
    return types.some(function(t) {
      if (t.endsWith("/*")) return file.type.startsWith(t.slice(0, -1));
      if (t.startsWith(".")) return file.name.endsWith(t);
      return file.type === t;
    });
  }
  
  function formatSize(bytes) {
    if (bytes < 1024) return bytes + " B";
    if (bytes < 1024*1024) return (bytes/1024).toFixed(1) + " KB";
    return (bytes/1024/1024).toFixed(1) + " MB";
  }
  
  // 公開 API
  this.getFile = function() { return $input[0].files[0]; };
  this.clear = clearInput;
  this.disable = function() { $input.prop("disabled", true); };
  this.enable = function() { $input.prop("disabled", false); };
}

// 使用
var uploader = new FileUploader("#uploader1", {
  accept: "image/*,.pdf",
  onSelect: function(file) { console.log("選擇:", file.name); },
  onClear: function() { console.log("已清空"); }
});

// 取得檔案上傳
$("#btnSubmit").click(function() {
  var file = uploader.getFile();
  if (!file) return alert("請選擇檔案");
  
  var formData = new FormData();
  formData.append("file", file);
  
  $.ajax({
    url: "/api/upload",
    type: "POST",
    data: formData,
    processData: false,
    contentType: false,
    success: function(res) { alert("上傳成功"); }
  });
});
</script>

常見問題 FAQ

Q: 清空後 change 事件不觸發怎麼辦?

A: 手動觸發 $input.trigger("change") 或 input.dispatchEvent(new Event("change"))。

Q: 清空後原本綁定的事件失效?

A: 改用**事件委派**綁定在父層,或清空後重新綁定。cloneNode(true) 不複製 addEventListener 綁定的事件。

Q: 多檔上傳 multiple 屬性如何清空?

A: 同樣適用,input.value = "" 或替換元素皆可清空所有選擇檔案。

Q: IE11 仍無法清空?

A: IE11 不支援 input.value = "",必須用 outerHTML 替換或 form.reset()。建議使用包裹 span 方案。

總結

清空 <input type="file"> 的最佳實踐:

  1. 現代專案:直接 input.value = "" (Chrome 81+/Firefox 75+/Safari 14+/Edge 81+)
  2. 需支援舊瀏覽器:包裹 <span> + innerHTML 重置 (最通用)
  3. 表單場景:form.reset() 最簡單
  4. 通用封裝:特性檢測 + 降級策略,統一 API
  5. 事件綁定:務必使用**事件委派**避免清空後失效
copyright © 萬盛學電腦網 all rights reserved