萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

jQuery 動態添加/刪除文件上傳欄位:事件委託與 DOM 操作完整實現

表單中動態增減文件輸入框是常見需求。本文提供基於 jQuery 的完整實現:點擊「增加」追加 ``、點擊「刪除」移除對應行、事件委託處理動態元素、FormData 異步提交,代碼簡潔可直接落地。

HTML 骨架


<form id="uploadForm" enctype="multipart/form-data">
    <div id="fileContainer">
        <div class="file-row">
            <input type="file" name="files[]" class="file-input" />
            <a href="javascript:;" class="remove-btn">×</a>
        </div>
    </div>
    <button type="button" id="addFile">+ 增加文件</button>
    <button type="submit">提交上傳</button>
</form>

jQuery 核心邏輯


$(function() {
    var $container = $('#fileContainer');
    var maxFiles = 10; // 限制最大數量

    // 1. 增加文件輸入框
    $('#addFile').on('click', function() {
        if ($container.children('.file-row').length >= maxFiles) {
            alert('最多上傳 ' + maxFiles + ' 個文件');
            return;
        }
        var $row = $('<div class="file-row">' +
            '<input type="file" name="files[]" class="file-input" />' +
            '<a href="javascript:;" class="remove-btn">×</a>' +
            '</div>');
        $container.append($row);
    });

    // 2. 事件委託:刪除按鈕(動態元素必須用委託)
    $container.on('click', '.remove-btn', function() {
        $(this).closest('.file-row').remove();
    });

    // 3. 表單提交:FormData 異步上傳
    $('#uploadForm').on('submit', function(e) {
        e.preventDefault();
        var formData = new FormData(this);
        $.ajax({
            url: '/api/upload',
            type: 'POST',
            data: formData,
            processData: false, // 告訴 jQuery 不要處理數據
            contentType: false, // 告訴 jQuery 不要設置 Content-Type
            success: function(res) { alert('上傳成功'); },
            error: function() { alert('上傳失敗'); }
        });
    });
});

關鍵技術點

  1. 事件委託:`$container.on('click', '.remove-btn', ...)` 綁定在**靜態父容器**上,利用事件冒泡捕獲動態添加的子元素點擊,無需每次新增時重新綁定。
  2. FormData 自動收集:`new FormData(form)` 自動序列化所有 `name` 屬性的表單字段,包括多文件 `files[]`。
  3. 關鍵 AJAX 選項:`processData: false` 防止 jQuery 將 FormData 轉字符串;`contentType: false` 讓瀏覽器自動設置 `multipart/form-data; boundary=...`。
  4. 數量限制:防止用戶無限添加導致內存/請求體過大。

進階增強

文件預覽(圖片)


$container.on('change', '.file-input', function() {
    var file = this.files[0];
    if (file && file.type.startsWith('image/')) {
        var reader = new FileReader();
        reader.onload = function(e) {
            $(this).siblings('.preview').remove(); // 移除舊預覽
            $(this).after('<img class="preview" src="' + e.target.result + '" style="max-width:100px">');
        }.bind(this);
        reader.readAsDataURL(file);
    }
});

拖拽排序


$container.sortable({
    handle: '.drag-handle',
    items: '.file-row',
    placeholder: 'file-row-placeholder'
});

上傳進度


$.ajax({
    xhr: function() {
        var xhr = new window.XMLHttpRequest();
        xhr.upload.addEventListener('progress', function(e) {
            if (e.lengthComputable) {
                var percent = Math.round(e.loaded / e.total * 100);
                $('#progressBar').css('width', percent + '%').text(percent + '%');
            }
        });
        return xhr;
    },
    // ... 其他選項
});

服務端接收提示

  • PHP:`$_FILES['files']` 為多文件數組,遍歷 `['tmp_name'][$i]` 移動
  • Java Spring:`@RequestParam("files") MultipartFile[] files`
  • Node.js Express:`multer.array('files')` 中間件
  • Python Flask:`request.files.getlist('files[]')`
  • Go:`r.MultipartForm.File["files[]"]`

避坑清單

  1. 忘記 `enctype="multipart/form-data"` → 文件不上傳
  2. 未設置 `processData: false, contentType: false` → 發送 `[object FormData]` 字符串
  3. 動態元素直接綁定事件 → 新增元素無響應
  4. 未限制文件類型/大小 → 安全風險
  5. 文件名 `name="files[]"` 中括號確保服務端接收為數組

總結

動態文件上傳欄位 = 容器 + 模板行 + 事件委託 + FormData 提交。掌握這四個核心,即可構建靈活、健壯的上傳界面。生產環境建議接入成熟組件,支持分片上傳、斷點續傳、秒傳、圖片壓縮等高級功能。

copyright © 萬盛學電腦網 all rights reserved