HTML5 為 <a> 標籤新增了一個 download 屬性,讓下載連結不必再靠後端設定 Content-Disposition 標頭,就能在客戶端指定另存的檔名。
把 href 指向檔案路徑,再加上 download 即可:
<a href="Swiper-2.7.6.zip" download="下載我.zip">下載</a>
點擊後瀏覽器下載的檔名就會是「下載我.zip」,而不是連結上的原始檔名。若只寫 download 而不指定值,則沿用原檔名:
<a href="Swiper-2.7.6.zip" download>下載</a>
download 的值可以任意指定,包括副檔名——把 .zip 寫成 .txt 語法上完全合法,瀏覽器不會阻止。但檔案內容仍是 zip 格式,使用者存到電腦後會發現打不開。所以實務上請保持副檔名與實際格式一致。
這個屬性在幾種情境下很方便:
report?id=123 這種沒有副檔名的路由,用 download="月度報表.xlsx" 就能給使用者一個好認的檔名。a1b2c3.pdf,可以另存為「產品型錄.pdf」。URL.createObjectURL() 就能讓 canvas 截圖、JSON 匯出直接在瀏覽器端下載。1. 跨來源網域時會失效。若 href 指向不同 origin 的資源,多數瀏覽器會忽略 download 屬性,變成直接開啟連結。解法是由後端加上 Content-Disposition: attachment; filename="xxx" 標頭。
2. 不支援所有型別。部分瀏覽器對 PDF、圖片等可預覽的格式仍可能直接開啟而非下載,這同樣需要後端標頭配合才能強制。
一行屬性解決檔名問題,這就是 HTML5 這類「小但實用」的改進的價值。只要注意同來源與副檔名一致性,它在大多數場景都能取代後端設定。