萬盛學電腦網

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

jQuery 動態設置 Form enctype 實現文件上傳:雙屬性兼容方案

為什麼需要動態設置 enctype?

表單包含 <input type="file"> 時,必須設置 enctype="multipart/form-data" 才能正確上傳文件。動態場景:

  • 同一表單切換「普通提交」與「文件上傳」模式
  • 根據用戶操作決定是否上傳文件
  • SPA 中根據路由動態構建表單

核心代碼:雙屬性兼容

// 關鍵:同時設置 enctype 和 encoding(IE 兼容)
$('#myForm').attr({
  'enctype': 'multipart/form-data',  // 標準屬性
  'encoding': 'multipart/form-data'  // IE 專用別名
}).attr('method', 'POST')            // 文件上傳必須 POST
 .attr('action', '/upload');         // 上傳端點

// 如果在 iframe 中提交(老式無刷新上傳)
$('#myForm').attr('target', 'uploadIframe'); // 指定目標 iframe name

完整文件上傳表單示例

<form id="uploadForm" method="post" action="/api/upload">
  <div class="form-group">
    <label>文件描述:</label>
    <input type="text" name="description" class="form-control">
  </div>
  
  <div class="form-group">
    <label>選擇文件:</label>
    <input type="file" name="file" id="fileInput" class="form-control">
  </div>
  
  <button type="submit" class="btn btn-primary">上傳</button>
  <button type="button" id="switchMode" class="btn btn-secondary">切換為普通模式</button>
</form>

<!-- 隱藏 iframe 用於老式無刷新上傳 -->
<iframe name="uploadIframe" style="display:none;"></iframe>

<script>
$(function() {
  const $form = $('#uploadForm');
  const $fileInput = $('#fileInput');
  const $switchBtn = $('#switchMode');
  let isFileMode = true;
  
  // 文件選擇時自動切換到 multipart
  $fileInput.on('change', function() {
    if (this.files.length > 0) {
      enableFileUploadMode();
    }
  });
  
  // 手動切換模式
  $switchBtn.on('click', function() {
    isFileMode = !isFileMode;
    if (isFileMode) {
      enableFileUploadMode();
      $(this).text('切換為普通模式');
    } else {
      disableFileUploadMode();
      $(this).text('切換為文件上傳模式');
    }
  });
  
  function enableFileUploadMode() {
    $form.attr({
      'enctype': 'multipart/form-data',
      'encoding': 'multipart/form-data', // 關鍵:IE 兼容
      'method': 'POST',
      'target': 'uploadIframe'           // 可選:iframe 無刷新
    });
    $fileInput.show();
  }
  
  function disableFileUploadMode() {
    $form.removeAttr('enctype encoding target')
         .attr('method', 'POST'); // 恢復默認 application/x-www-form-urlencoded
    $fileInput.hide();
  }
  
  // 現代 Fetch 上傳(推薦,無需 form enctype 折騰)
  $('#modernUpload').on('click', async function() {
    const formData = new FormData();
    formData.append('file', $fileInput[0].files[0]);
    formData.append('description', $form.find('[name="description"]').val());
    
    try {
      const res = await fetch('/api/upload', {
        method: 'POST',
        body: formData
        // fetch 自動設置 multipart/form-data + boundary
      });
      const result = await res.json();
      alert('上傳成功: ' + result.url);
    } catch (err) {
      console.error(err);
      alert('上傳失敗');
    }
  });
});
</script>

enctype 三種值對比

值用途Content-Type 標頭
application/x-www-form-urlencoded默認,普通表單key=value&key2=value2 (URL 編碼)
multipart/form-data**文件上傳**multipart/form-data; boundary=----WebKitFormBoundary...
text/plain極少用(調試)純文本,無編碼

IE 兼容性深度解析

  • IE6-IE8:不識別 enctype,只認 encoding 屬性
  • IE9+:支援標準 enctype
  • jQuery .attr():會同時設置 DOM 屬性和 property,雙寫無副作用

現代項目若無 IE 支援要求,**可省略 encoding**。

現代最佳實踐:FormData + Fetch

// 完全繞過 form enctype 設置,瀏覽器自動構建 multipart 請求
async function uploadFile(file, metadata) {
  const formData = new FormData();
  formData.append('file', file);
  Object.entries(metadata).forEach(([k, v]) => formData.append(k, v));
  
  const response = await fetch('/api/upload', {
    method: 'POST',
    body: formData
    // 不要手動設置 Content-Type!瀏覽器會自動生成含 boundary 的正確值
  });
  
  return response.json();
}

總結

動態設置 enctype 的核心口訣:

「文件上傳必雙寫:enctype 標準、encoding 兼容 IE;
method 必須 POST,action 指向上傳端點;
現代項目拋棄 form 提交,改用 FormData + Fetch。」

理解 multipart/form-data 的 boundary 分隔符機制、FormData 的自動構建能力,才是解決文件上傳問題的根本之道。

copyright © 萬盛學電腦網 all rights reserved