База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

download: поискайте записване на свързания ресурс

Предложете име на файл, без да приемате, че управлявате политиката за изтегляне.

Версия: HTML Living Standard

Синтаксис

<a href="..." download="note.txt">Download</a>

В обикновена връзка или връзка от карта на изображение download указва намерение за изтегляне вместо нормална навигация. Незадължителната стойност предлага име на файл. Браузърът може да го обезопаси или да използва информация от отговора на сървъра, а потребителските правила продължават да влияят. Атрибутът не позволява произволен запис във файловата система на потребителя.

Ресурси със същия произход и локално създадени blob URL адреси са простият случай. Изтеглянето от друг произход изисква подходящо съдействие на сървъра, включително обработка като прикачен файл; атрибутът сам не го налага. Освободете временния обектен URL, след като вече не е нужен, а не преди изтеглянето да го използва.

Примерът създава малък текстов blob и връзка за изтегляне. Истинско щракване води до завършено изтегляне с предложеното име и точно очакваните байтове. Страницата отчита само заявката; завършването се установява независимо от браузърния тест.

Примери

<!doctype html><meta charset="utf-8">
<a id="download" download="note.txt">Download local text</a><output id="result"></output><script>
const link = document.querySelector('#download');
const url = URL.createObjectURL(new Blob(['Local example.\n'], { type: 'text/plain' }));
link.href = url;
link.addEventListener('click', () => { document.querySelector('#result').textContent = 'downloadRequested=true'; });
window.addEventListener('pagehide', () => URL.revokeObjectURL(url), { once: true });
</script>

Резултат

downloadRequested=true

Файлът е генериран тестов текст, а не прочетен файл от компютъра на потребителя.

Източници