CKTIS / HTML
download: požiadavka uloženia odkazovaného zdroja
Navrhnite názov súboru bez predpokladu kontroly nad pravidlami sťahovania.
Verzia: HTML Living Standard
Syntax
<a href="..." download="note.txt">Download</a>Na odkaze alebo oblasti obrazovej mapy download označuje zamýšľané sťahovanie namiesto navigácie. Voliteľná hodnota navrhuje názov súboru. Prehliadač ho môže upraviť alebo použiť serverové údaje; platí aj používateľská politika. Atribút nepovoľuje ľubovoľný zápis do súborového systému.
Jednoduchým prípadom sú zdroje rovnakého pôvodu a miestne blob URL. Sťahovanie medzi pôvodmi vyžaduje spoluprácu servera vrátane spracovania prílohy; samotný atribút ho nevynúti. Dočasnú URL objektu uvoľnite, keď už nebude potrebná, nie skôr, než ju sťahovanie využije.
Príklad vytvorí malý textový blob a odkaz. Skutočné kliknutie dokončí stiahnutie s navrhnutým názvom a presnými bajtmi. Stránka hlási iba požiadavku; dokončenie nezávisle potvrdí prehliadačový test.
Prí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ýsledok
downloadRequested=true
Súbor je vygenerovaný testovací text, nie súbor čítaný z používateľovho počítača.