萬盛學電腦網

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

JavaScript 操作 input type=file:獲取值、清空、預覽、多文件與現代 File API

核心特性

  • `` 的 `value` **唯讀**,無法直接賦值(安全限制)
  • `files` 屬性返回 `FileList`(類陣列),包含 `File` 對象(繼承自 `Blob`)
  • 選擇同一文件不觸發 `change` 事件(值未變),需手動重置

獲取文件信息

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

const input = document.getElementById('fileInput');
const preview = document.getElementById('preview');

input.addEventListener('change', (e) => {
  const files = Array.from(e.target.files); // FileList → 陣列
  
  files.forEach(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/')) {
      const url = URL.createObjectURL(file); // 創建臨時 Blob URL
      const img = document.createElement('img');
      img.src = url;
      img.style.maxWidth = '200px';
      img.onload = () => URL.revokeObjectURL(url); // 釋放內存
      preview.appendChild(img);
    }
  });
});

清空文件輸入的 3 種方法

方法代碼優點缺點
1. value = ''(現代瀏覽器)`input.value = ''`最簡潔、標準化IE11- 不支援、部分舊移動端無效
2. 替換節點(通用)`input.replaceWith(input.cloneNode(true))`全瀏覽器兼容、重置所有狀態丟失綁定在原節點的事件監聽器
3. Form reset(原文方法 2)見下文不丟失事件綁定(若表單外)代碼較繁瑣

方法 1:現代標準(推薦)

function clearFileInput(input) {
  try {
    input.value = ''; // Chrome 13+, FF 57+, Safari 11+, Edge 79+
  } catch (e) {
    // 降級:替換節點
    const newInput = input.cloneNode(true);
    input.parentNode.replaceChild(newInput, input);
    return newInput; // 返回新引用,需重新綁定事件
  }
  return input;
}

方法 2:Form reset(原文邏輯封裝)

function clearFileInputForm(input) {
  const form = document.createElement('form');
  const parent = input.parentNode;
  const next = input.nextSibling;
  
  form.appendChild(input); // 移動到臨時 form
  form.reset();            // 重置表單 → 清空 file
  parent.insertBefore(input, next); // 移回原位置
  form.remove();
}

方法 3:封裝組件模式(保留事件綁定)

class FileInput {
  constructor(selector) {
    this.el = typeof selector === 'string' ? document.querySelector(selector) : selector;
    this.el.addEventListener('change', this._onChange.bind(this));
  }
  
  _onChange(e) {
    this.files = Array.from(e.target.files);
    this.onChange?.(this.files);
  }
  
  getFiles() { return this.files || []; }
  
  clear() {
    // 方案:value = '' 失效時用 replaceWith 但保留監聽器
    try {
      this.el.value = '';
    } catch {
      const newEl = this.el.cloneNode(true);
      // 重新綁定事件
      newEl.addEventListener('change', this._onChange.bind(this));
      this.el.parentNode.replaceChild(newEl, this.el);
      this.el = newEl;
    }
    this.files = [];
  }
  
  onChange(files) {} // 供外部覆蓋
}

// 使用
const fileInput = new FileInput('#fileInput');
fileInput.onChange = (files) => console.log('選中:', files);
document.getElementById('btnClear').onclick = () => fileInput.clear();

進階:文件拖拽上傳

const dropZone = document.getElementById('dropZone');

['dragenter', 'dragover'].forEach(evt => 
  dropZone.addEventListener(evt, e => { e.preventDefault(); e.stopPropagation(); dropZone.classList.add('drag-over'); })
);
['dragleave', 'drop'].forEach(evt => 
  dropZone.addEventListener(evt, e => { e.preventDefault(); e.stopPropagation(); dropZone.classList.remove('drag-over'); })
);

dropZone.addEventListener('drop', (e) => {
  const files = Array.from(e.dataTransfer.files);
  // 手動構造 FileList-like 對象或直接處理 files 陣列
  handleFiles(files);
});

現代 File System Access API(Chrome 86+,需 HTTPS)

// 用戶主動選擇文件/目錄,獲得持久化訪問權限
async function pickFiles() {
  try {
    const handles = await window.showOpenFilePicker({
      types: [{ description: 'Images', accept: { 'image/*': ['.png', '.jpg', '.jpeg'] } }],
      multiple: true
    });
    const files = await Promise.all(handles.map(h => h.getFile()));
    return files;
  } catch (err) {
    if (err.name !== 'AbortError') throw err; // 用戶取消
  }
}

結語

`` 的 `value` 唯讀特性決定了清空需特殊處理。**現代瀏覽器首選 `input.value = ''`**,失效時降級為 `replaceWith(cloneNode(true))` 並重新綁定事件。配合 `File`/`Blob`/`URL.createObjectURL` 可實現預覽、拖拽、分片上傳等豐富功能。新專案可嘗試 **File System Access API** 獲得更強大的文件操作能力。

copyright © 萬盛學電腦網 all rights reserved