傳統 <a> 下載鏈接,用戶看到的永遠是服務端生成的亂碼文件名(如 abc1234564545.pdf)。HTML5 引入的 download 屬性,徹底改變了這一體驗。
<a href="/files/abc1234564545.pdf" download="年度報告">下載報告</a>
點擊後,瀏覽器彈出的「另存為」對話框將預設文件名為「年度報告.pdf」(自動保留原副檔名)。
Content-Disposition 配置成本。<a href="/api/report?user=123" download="report_" + Date.now() + ".xlsx">導出數據</a>
配合 JS 動態設置 download 值,實現「每次下載文件名唯一」。
download 僅對同源 URL 生效。跨域資源(如 CDN 直連)若無 Access-Control-Allow-Origin 或 Content-Disposition: attachment,屬性會被忽略,瀏覽器改為導航預覽。
若 download 值未帶副檔名,瀏覽器會嘗試從 href 的 MIME 類型或 URL 後綴推斷並補全。建議顯式包含副檔名,避免歧義。
現代瀏覽器全支持(IE/Edge 13+、Chrome 14+、Firefox 20+、Safari 10+)。舊版 IE 需後端配合 Content-Disposition 降級。
download。業務名_關鍵標識_時間.副檔名(如 訂單明細_ORD_20240520_12345.xlsx)。blob:URL 或 data:URL 實現純前端生成文件下載(如 Canvas 導出圖片、JS 生成 CSV)。