CKTIS / HTML
download: požadavek uložení odkazovaného zdroje
Navrhněte název souboru bez předpokladu kontroly pravidel stahování.
Verze: HTML Living Standard
Syntaxe
<a href="..." download="note.txt">Download</a>Na odkazu nebo oblasti obrazové mapy download označuje záměr stahování místo navigace. Volitelná hodnota navrhuje název souboru. Prohlížeč jej může upravit nebo použít serverové údaje; platí také uživatelská politika. Atribut nepovoluje libovolný zápis do souborového systému.
Jednoduchým případem jsou zdroje stejného původu a místní blob URL. Stahování mezi původy vyžaduje spolupráci serveru včetně zpracování přílohy; samotný atribut ho nevynutí. Dočasnou URL objektu uvolněte, až nebude potřeba, ne dříve, než ji stahování použije.
Příklad vytvoří malý textový blob a odkaz. Skutečné kliknutí dokončí stahování s navrženým názvem a přesnými bajty. Stránka hlásí jen požadavek; dokončení nezávisle potvrzuje prohlížečový test.
Příklady
<!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>Výsledek
downloadRequested=true
Soubor je vygenerovaný testovací text, nikoli soubor čtený z uživatelova počítače.