萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

HTML5 表單提交完整指南:原生提交、AJAX/Fetch、FormData、驗證與檔案上傳實戰

HTML5 表單提交三大模式

現代 Web 開發中,表單提交主要有三種模式,各有優缺點與適用場景。

1. 原生同步提交 (標準 HTML 表單)

<form action="/api/login" method="POST">
  <input type="email" name="email" required>
  <input type="password" name="password" required>
  <button type="submit">登入</button>
</form>
  • 優點:零 JS 依賴、瀏覽器原生支援、自動處理編碼 (`application/x-www-form-urlencoded` 或 `multipart/form-data`)、支援瀏覽器密碼管理器、無障礙最佳。
  • 缺點:頁面整頁重載、無法精細控制提交流程 (載入狀態、錯誤處理、動畫)、難以實現 SPA 體驗。
  • 適用:傳統多頁應用 (MPA)、簡單登入/註冊/搜尋、SEO 關鍵頁面、漸進式增強基礎層。

2. AJAX 提交 (XMLHttpRequest / jQuery.ajax)

// 原生 XMLHttpRequest (支援進度、中止、超時)
function submitForm(formEl, onSuccess, onError) {
    const formData = new FormData(formEl); // 自動收集所有欄位 (含檔案)
    const xhr = new XMLHttpRequest();
    xhr.open('POST', formEl.action);
    xhr.onload = () => {
        if (xhr.status >= 200 && xhr.status < 300) onSuccess(xhr.response);
        else onError(xhr.status, xhr.response);
    };
    xhr.onerror = () => onError(0, 'Network error');
    xhr.send(formData);
}

// jQuery 簡寫
$('#my-form').on('submit', function(e) {
    e.preventDefault();
    $.ajax({
        url: this.action,
        type: this.method,
        data: new FormData(this),
        processData: false, // 必須 false,否則 jQuery 會嘗試序列化 FormData
        contentType: false, // 必須 false,讓瀏覽器自動設定 multipart boundary
        success: res => console.log('成功', res),
        error: (xhr, status, err) => console.error('失敗', status, err)
    });
});

3. Fetch API 提交 (現代標準,Promise 基礎)

async function submitFormFetch(formEl) {
    const formData = new FormData(formEl);
    try {
        const response = await fetch(formEl.action, {
            method: formEl.method,
            body: formData,
            credentials: 'same-origin', // 攜帶 Cookie
            // headers: {'X-CSRF-Token': getCsrfToken()} // 若需 CSRF Token 手動加入
        });
        if (!response.ok) throw new Error(`HTTP ${response.status}`);
        const result = await response.json(); // 或 .text(), .blob()
        return result;
    } catch (err) {
        console.error('提交失敗', err);
        throw err;
    }
}

// 使用
document.getElementById('my-form').addEventListener('submit', async e => {
    e.preventDefault();
    const btn = e.target.querySelector('button[type="submit"]');
    btn.disabled = true; btn.textContent = '處理中...';
    try {
        await submitFormFetch(e.target);
        alert('成功!');
        // 跳轉或更新 UI
    } catch (err) {
        alert('失敗: ' + err.message);
    } finally {
        btn.disabled = false; btn.textContent = '送出';
    }
});

FormData 物件:表單資料收集的瑞士刀

const form = document.getElementById('my-form');
const fd = new FormData(form); // 自動收集所有 name 屬性的欄位

// 手動操作
fd.append('extra_field', 'value');           // 新增
fd.append('files[]', fileInput.files[0]);    // 新增檔案 (多檔同名加 [])
fd.set('email', 'new@example.com');          // 覆蓋 (單值)
fd.delete('unwanted');                       // 移除
fd.has('email'); fd.get('email'); fd.getAll('files[]'); // 查詢

// 迭代
for (const [key, value] of fd.entries()) {
    console.log(key, value instanceof File ? `File: ${value.name}` : value);
}

// 轉 JSON (僅非檔案欄位)
const json = {};
for (const [k, v] of fd) if (!(v instanceof File)) json[k] = v;

HTML5 表單驗證整合提交流程

const form = document.getElementById('my-form');
form.addEventListener('submit', async e => {
    e.preventDefault(); // 先阻止原生提交
    
    // 1. 觸發瀏覽器原生驗證 UI
    if (!form.checkValidity()) {
        form.reportValidity(); // 顯示氣泡、聚焦第一個無效欄位
        return;
    }
    
    // 2. 自訂業務驗證 (如密碼強度、確認密碼)
    const pwd = form.password.value;
    const confirm = form.confirm_password.value;
    if (pwd !== confirm) {
        form.confirm_password.setCustomValidity('兩次密碼不一致');
        form.reportValidity();
        return;
    }
    form.confirm_password.setCustomValidity(''); // 清除
    
    // 3. 實際提交 (Fetch)
    try {
        await submitFormFetch(form);
        // 成功處理...
    } catch (err) {
        // 失敗處理...
    }
});

// 即時驗證回饋 (可選)
form.querySelectorAll('input, select, textarea').forEach(el => {
    el.addEventListener('blur', () => {
        if (!el.validity.valid) el.reportValidity();
        else el.setCustomValidity('');
    });
    el.addEventListener('input', () => el.setCustomValidity('')); // 輸入時清除自訂錯誤
});

檔案上傳完整實戰

前端:多檔拖拽、預覽、進度條

<form id="upload-form" action="/api/upload" method="POST">
  <div id="drop-zone" class="drop-zone">
    拖拽檔案到這裡或 <input type="file" id="file-input" name="files[]" multiple>
  </div>
  <div id="file-list"></div>
  <progress id="overall-progress" value="0" max="100" hidden></progress>
  <button type="submit">開始上傳</button>
</form>

<script>
const dropZone = document.getElementById('drop-zone');
const fileInput = document.getElementById('file-input');
const fileList = document.getElementById('file-list');
const filesMap = new Map(); // fileId -> {file, xhr, progressEl}

['dragenter','dragover','dragleave','drop'].forEach(evt => 
    dropZone.addEventListener(evt, e => { e.preventDefault(); e.stopPropagation(); })
);
dropZone.addEventListener('drop', e => {
    handleFiles(Array.from(e.dataTransfer.files));
});
fileInput.addEventListener('change', e => handleFiles(Array.from(e.target.files)));

function handleFiles(files) {
    files.filter(f => f.type.startsWith('image/') || f.type.startsWith('video/') || f.type === 'application/pdf')
         .forEach(file => {
             const id = 'f_' + Date.now() + '_' + Math.random().toString(36).substr(2, 9);
             const div = document.createElement('div');
             div.className = 'file-item';
             div.innerHTML = `
                 <img src="${URL.createObjectURL(file)}" class="preview">
                 <span class="name">${escapeHtml(file.name)}</span>
                 <progress class="progress" value="0" max="100"></progress>
                 <button type="button" class="remove">移除</button>
             `;
             fileList.appendChild(div);
             filesMap.set(id, {file, div, progressEl: div.querySelector('.progress')});
             div.querySelector('.remove').onclick = () => { filesMap.delete(id); div.remove(); };
         });
}

document.getElementById('upload-form').addEventListener('submit', async e => {
    e.preventDefault();
    if (filesMap.size === 0) return alert('請先選擇檔案');
    
    const overallProgress = document.getElementById('overall-progress');
    overallProgress.hidden = false; overallProgress.value = 0;
    
    let completed = 0;
    for (const [id, {file, progressEl}] of filesMap) {
        const fd = new FormData();
        fd.append('file', file);
        
        await new Promise((resolve, reject) => {
            const xhr = new XMLHttpRequest(); // 僅 XHR 支援 upload 進度事件
            xhr.open('POST', '/api/upload');
            xhr.upload.onprogress = e => {
                if (e.lengthComputable) progressEl.value = (e.loaded / e.total) * 100;
            };
            xhr.onload = () => xhr.status >= 200 && xhr.status < 300 ? resolve() : reject(xhr.statusText);
            xhr.onerror = () => reject('Network error');
            xhr.send(fd);
        });
        
        completed++;
        overallProgress.value = (completed / filesMap.size) * 100;
    }
    
    alert('全部上傳完成!');
    filesMap.clear(); fileList.innerHTML = ''; overallProgress.hidden = true;
});
</script>

後端接收要點 (以 Node.js/Express + multer 為例)

const multer = require('multer');
const upload = multer({ 
    storage: multer.diskStorage({
        destination: (req, file, cb) => cb(null, 'uploads/'),
        filename: (req, file, cb) => cb(null, Date.now() + '_' + file.originalname)
    }),
    limits: { fileSize: 50 * 1024 * 1024 }, // 50MB
    fileFilter: (req, file, cb) => {
        const allowed = ['image/jpeg', 'image/png', 'video/mp4', 'application/pdf'];
        cb(null, allowed.includes(file.mimetype));
    }
});

app.post('/api/upload', upload.array('files'), (req, res) => {
    // req.files 陣列包含上傳檔案資訊
    res.json({success: true, files: req.files.map(f => ({name: f.originalname, path: f.path}))});
});

CSRF 防護與安全注意事項

  • 同源策略:Fetch/XHR 預設同源,跨域需 CORS 標頭 (`Access-Control-Allow-Origin`)。
  • CSRF Token:狀態改變操作 (POST/PUT/DELETE) 必須驗證 CSRF Token。雙重提交 Cookie 模式:`` → 讀取並加入 Header `X-CSRF-Token`。
  • 檔案型別驗證:前端 `accept` 屬性只能誠實用戶,**後端必須驗證 MIME Type、Magic Bytes、副檔名**。
  • 上傳目錄權限:上傳目錄**不可執行腳本** (Nginx/Apache 設定 `location /uploads { php_flag engine off; }`),防止 webshell。
  • 檔案大小限制:前端 `File.size` 檢查 + 後端 `limits.fileSize` 雙重保障。

總結

HTML5 表單提交已從單純的同步重載演進為靈活的 **Fetch + FormData** 非同步模式,配合 **原生驗證 API**、**進度事件**、**拖拽 API**,能構建極佳使用者體驗的上傳/提交介面。核心原則:**漸進式增強** (基礎功能無 JS 可用)、**前後端雙重驗證**、**安全防護 (CSRF、檔案型別、權限)**、**錯誤處理與使用者回饋**。

copyright © 萬盛學電腦網 all rights reserved