Вебсправочник
Справочник HTML

Атрибут download: ссылка на скачивание файла

Download сообщает о намерении скачать ресурс по ссылке и может предложить имя сохраняемого файла. Полезно заранее обозначить тип и размер реального файла в видимом тексте ссылки.

Назначение

Download сообщает о намерении скачать ресурс по ссылке и может предложить имя сохраняемого файла. Полезно заранее обозначить тип и размер реального файла в видимом тексте ссылки.

Как это работает

В примере используется небольшой встроенный текстовый ресурс, поэтому внешний сервер не нужен. Значение атрибута предлагает имя файла; браузер может изменить его с учётом своих правил и пользовательского выбора.

Пример

<p><a href="data:text/plain;charset=utf-8,Hello%20HTML" download="lesson-note.txt">Скачать учебную заметку TXT</a></p>
<p>Файл содержит одну короткую строку: Hello HTML.</p>

Что должно получиться

На обычной отдельной странице ссылка предлагает сохранить текстовую заметку. В песочнице справочника скачивания и внешние переходы ограничены, поэтому проверять действие нужно в своём HTML-файле.

Граница применения и частая ошибка

Для обычных HTTP-адресов download ограничен ресурсами того же origin; также поддерживаются blob и data. Серверные заголовки и настройки браузера влияют на результат. Наличие атрибута не гарантирует выбранное имя и не проверяет безопасность файла.

Самостоятельная проверка

Сохраните пример отдельно и проверьте имя и содержимое результата. Затем используйте реальный локальный TXT-файл по относительному пути. Не обещайте точный размер в подписи, пока не измерили публикуемый файл.

Самостоятельный учебный материал. Техническая документация: первоисточник по теме ↗. Если результат отличается, проверьте код и версию браузера.