HTML <a> download 属性

定义和用法

download 属性规定当用户单击超链接时将下载目标(href 属性 中规定的文件)。

download 属性的可选值将成为文件下载后的新名称。允许使用任何值,浏览器会自动检测正确的文件扩展名并将其添加到文件中(例如 .img、.pdf、.txt、.html 等)。

如果省略该值,则使用原始文件名。

实例

例子 1

单击链接时下载文件(而不是导航到文件):

<a href="/logo/w3logo-5.png" download>

亲自试一试

例子 2

指定 download 属性的值,它将是下载文件的新文件名(例如使用 "w3logo.jpg" 代替 "myw3schoolsimage.jpg"):

<a href="/logo/w3logo-5.png" download="w3logo">

亲自试一试

语法

<a download="filename">

属性值

描述
filename 可选。规定下载文件的新文件名。

浏览器支持

表中的数字注明了首个完全支持该属性的浏览器版本。

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
14.0* 18.0 20.0* 10.1 15.0

* Chrome 65+ 和 Firefox 仅支持同源下载链接。