萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> HTML5 教學

HTML5 download 屬性詳解:讓下載文件名更友好、更可控

傳統 <a> 下載鏈接,用戶看到的永遠是服務端生成的亂碼文件名(如 abc1234564545.pdf)。HTML5 引入的 download 屬性,徹底改變了這一體驗。

基本語法

<a href="/files/abc1234564545.pdf" download="年度報告">下載報告</a>

點擊後,瀏覽器彈出的「另存為」對話框將預設文件名為「年度報告.pdf」(自動保留原副檔名)。

核心優勢

  • 用戶友好:以業務語義命名(如「合同_2024_Q3.docx」),而非技術性唯一 ID。
  • 強制下載:即使瀏覽器能預覽(如 PDF、圖片),也會直接觸發下載而非在新標籤打開。
  • 無需後端配合:前端獨立控制文件名,減少服務端 Content-Disposition 配置成本。

進階用法與注意點

1. 動態生成文件名

<a href="/api/report?user=123" download="report_" + Date.now() + ".xlsx">導出數據</a>

配合 JS 動態設置 download 值,實現「每次下載文件名唯一」。

2. 同源策略限制

download 僅對同源 URL 生效。跨域資源(如 CDN 直連)若無 Access-Control-Allow-Origin 或 Content-Disposition: attachment,屬性會被忽略,瀏覽器改為導航預覽。

3. 副檔名處理

若 download 值未帶副檔名,瀏覽器會嘗試從 href 的 MIME 類型或 URL 後綴推斷並補全。建議顯式包含副檔名,避免歧義。

4. 兼容性

現代瀏覽器全支持(IE/Edge 13+、Chrome 14+、Firefox 20+、Safari 10+)。舊版 IE 需後端配合 Content-Disposition 降級。

最佳實踐清單

  1. 所有「導出/下載」類鏈接**必加** download。
  2. 文件名格式:業務名_關鍵標識_時間.副檔名(如 訂單明細_ORD_20240520_12345.xlsx)。
  3. 跨域資源走後端代理或配置響應頭,確保屬性生效。
  4. 結合 blob:URL 或 data:URL 實現純前端生成文件下載(如 Canvas 導出圖片、JS 生成 CSV)。
copyright © 萬盛學電腦網 all rights reserved