download

Описание

Атрибут download (от англ. "download" ‒ «скачать, загрузить») указывает на необходимость загрузки указанного ресурса с последующим сохранением на устройство пользователя, а не его открытия в браузере. Если у этого атрибута есть значение, оно будет использовано как заполненное название файла в окне сохранения, которое открывается, когда пользователь нажимает на ссылку, при этом пользователь может поменять название перед сохранением файла. Ограничений на позволенные значения нет (хотя оно будет конвертировано в нижние подчёркивания, предотвращая специфичные пути), но стоит обратить внимание, что у большинства файловых систем есть ограничения на то, какие знаки препинания поддерживаются файловой системой, и браузеры регулируют названия согласно ограничениям.

Синтаксис

<a download>текст ссылки</a>
или
<a download="имя_файла">текст ссылки</a>

Например

<a href="1.jpg" download>Скачать картинку</a>
или
<a href="raport.docx" download="raport_12_02_2019.docx">Скачать отчет</a>

Пример

  • Атрибут может быть использован вместе с blob: URLs и data: URLs, чтобы пользователи могли проще скачать контент, который сгенерирован с помощью JavaScript (например, картинка, созданная с помощью онлайн-сайта для рисования).
  • Если представлен HTTP-заголовок Content-Disposition, и он содержит иное название, у HTTP-заголовка есть преимущество над атрибутом.
  • Если этот атрибут установлен и Content-Disposition установлен на inline, Firefox отдаёт преимущество Content-Disposition, но в тоже время Chrome отдаёт преимущество атрибуту download.
  • Этот атрибут соблюдается только на ресурсах с тем же доменом.

Совместимость браузеров

Настольные браузеры

Базовая поддержка 141320нет1510.1

Мобильные браузеры

Базовая поддержка 4.470?6346нет4

См. также: