Creating a download link in HTML is straightforward; add an anchor tag and point to the file within the “href” attribute. Some file types, however, won’t be downloaded; they’ll be opened in the browser. In this case consider using the “download” attribute.
If you have server-side access to your website there are some workarounds you can use, such as configuring the .htaccess, to download these files directly. If your site is hosted with a free service like WordPress.com, Blogspot, or perhaps Github pages which don’t allow you to do so, consider using the download attribute.
Using the HTML5 Download Attribute
The download attribute is part of the HTML5 spec and expresses a link as download link rather than a navigational link.
Syntax
1 |
<a href="download/acme-doc.txt" download>Download Text</a> |
The download attribute allows you to optionally rename the file name upon downloading. When the file resides on the server, especially if it’s been automatically generated, this can be ideal for giving users a file with a more sensible name when downloaded, perhaps like: Acme Documentation (ver. 2.0.1).txt (not forgetting the file extension).
Here’s how that would look in practice:
1 |
<a href="download/acme-doc-2.0.1.txt" download="Acme Documentation (ver. 2.0.1).txt">Download Text</a> |
Give it a try on the demo page, and you should find the file downloaded with the name specified in the download attribute.
A Couple of Notes:
- Firefox only allows users to download files of the same origin due to a security concern. The file must come from your own server or domain name, otherwise it will be opened in the browser.
- While downloading cross-origin files is allowed in Chrome and the latest Opera (with Chromium/Blink), they will both ignore the attribute value. In other words, the file name will remain unchanged.
download attribute can also be used with the less common <area> element.Providing Fallback for Internet Explorer
The download attribute has not been implemented in Internet Explorer, though it is supported by Edge.
In order to make things bullet proof we can add a decent fallback, such as providing extra instructions below the download link for non-supporting browsers. To do so, we will need to download Modernizr with the download feature test included.
Then we can add the following script.
1 |
if ( ! Modernizr.adownload ) { |
2 |
var $link = $('a'); |
3 |
|
4 |
$link.each(function() { |
5 |
var $download = $(this).attr('download'); |
6 |
|
7 |
if (typeof $download !== typeof undefined && $download !== false) { |
8 |
var $el = $('<div>').addClass('download-instruction').text('Right-click and select "Download Linked File"'); |
9 |
$el.insertAfter($(this)); |
10 |
}
|
11 |
|
12 |
});
|
13 |
}
|
The script will test whether the browser supports the download attribute; if not it will append a new <div> with the class for styling purposes as well as the instruction text, and insert it immediately below any link which has been furnished with the download attribute.
Conclusion
The HTML5 download attribute makes handling download links very convenient for anyone who has no access to server-side configuration.
Learn More HTML
