<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 id="uploadWrapper">
<input type="file" id="fileUpload" name="fileUpload" accept="image/*" />
</span>
<button type="button" id="btnClear">清空選擇</button>
// 頁面載入時快取原始 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);
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 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>
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);
$.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>
A: 手動觸發 $input.trigger("change") 或 input.dispatchEvent(new Event("change"))。
A: 改用**事件委派**綁定在父層,或清空後重新綁定。cloneNode(true) 不複製 addEventListener 綁定的事件。
multiple 屬性如何清空?A: 同樣適用,input.value = "" 或替換元素皆可清空所有選擇檔案。
A: IE11 不支援 input.value = "",必須用 outerHTML 替換或 form.reset()。建議使用包裹 span 方案。
清空 <input type="file"> 的最佳實踐:
input.value = "" (Chrome 81+/Firefox 75+/Safari 14+/Edge 81+)<span> + innerHTML 重置 (最通用)form.reset() 最簡單