萬盛學電腦網

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

file 輸入框選擇檔案後觸發的事件:onchange 完整解析

<input type="file"> 是前端檔案上傳的核心元素。許多開發者疑惑:使用者選擇檔案點擊「確定」後,到底觸發什麼事件?答案是 onchange。本文深入解析其觸發機制、跨瀏覽器行為與實戰應用。

核心結論

當使用者在檔案選擇對話框中選擇檔案並點擊「確定」/「打開」時,<input type="file"> 觸發 change 事件。這是 HTML 標準規定,所有現代瀏覽器一致支援。

基本用法

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

<script>
document.getElementById('fileInput').addEventListener('change', function(e) {
  var file = this.files[0]; // File 物件
  if (file) {
    console.log("檔案名稱:" + file.name);
    console.log("檔案大小:" + file.size + " bytes");
    console.log("檔案類型:" + file.type);
    console.log("最後修改時間:" + new Date(file.lastModified));
    
    // 預覽圖片
    if (file.type.startsWith('image/')) {
      var reader = new FileReader();
      reader.onload = function(e) {
        document.getElementById('preview').src = e.target.result;
      };
      reader.readAsDataURL(file);
    }
  }
});
</script>

關鍵屬性:files 集合

  • input.files:FileList 物件,類陣列,包含使用者選擇的檔案
  • input.files[0]:單檔上傳時的第一個檔案
  • multiple 屬性:<input type="file" multiple> 允許多選,files 包含多個

常見誤區:onpropertychange 與 oninput

網路上流傳 onpropertychange (IE 專有) 或 oninput 也能監聽檔案選擇,這是不準確的:

  • onpropertychange:IE 專有,監聽屬性變化,現代瀏覽器不支援
  • oninput:針對 `` 等即時輸入,檔案選擇不觸發
  • Chrome 測試確認:只有 change 可靠觸發

進階場景:重置檔案輸入框

由於安全限制,JS 無法直接設定 input.value = ''。重置需替換元素:

function resetFileInput(inputId) {
  var input = document.getElementById(inputId);
  var clone = input.cloneNode(true);
  input.parentNode.replaceChild(clone, input);
  return clone; // 返回新元素,需重新綁定事件
}

現代最佳實踐:配合 FileReader / FormData

// 非同步上傳範例
document.getElementById('fileInput').addEventListener('change', async function(e) {
  const file = e.target.files[0];
  if (!file) return;
  
  const formData = new FormData();
  formData.append('avatar', file);
  formData.append('userId', '12345');
  
  try {
    const response = await fetch('/api/upload', {
      method: 'POST',
      body: formData
    });
    const result = await response.json();
    console.log('上傳成功:', result);
  } catch (err) {
    console.error('上傳失敗:', err);
  }
});

總結

  • ✅ 使用 change 事件監聽檔案選擇
  • ✅ 透過 e.target.files 獲取 FileList
  • ✅ 結合 FileReader 預覽、FormData 上傳
  • ❌ 不要依賴 onpropertychange、oninput 等非標準事件

掌握 change 事件與 File API 的組合,是前端檔案處理的基石。

copyright © 萬盛學電腦網 all rights reserved