Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje