CKTIS / HTML
download: zatražite spremanje povezanog resursa
Predložite naziv datoteke bez pretpostavke da nadjačavate politiku preuzimanja.
Verzija: HTML Living Standard
Sintaksa
<a href="..." download="note.txt">Download</a>Na sidrenoj poveznici ili poveznici slikovne karte download označava namjeru preuzimanja umjesto uobičajene navigacije. Neobvezna vrijednost predlaže naziv datoteke. Preglednik ga može prilagoditi ili koristiti podatke iz odgovora poslužitelja, a korisnička pravila i dalje mogu utjecati na postupak. Atribut ne daje pravo proizvoljnog pisanja u korisnikov datotečni sustav.
Resursi istog izvora i lokalno stvoreni URL-ovi blob jednostavan su slučaj. Preuzimanje s drugog izvora traži odgovarajuću suradnju poslužitelja, uključujući obradu privitka; sam atribut nije dopuštenje da ga se prisili. Privremeni URL objekta oslobodite kada više nije potreban, a ne prije nego što ga preuzimanje upotrijebi.
Primjer stvara mali tekstualni blob i poveznicu za preuzimanje. Stvarni klik dovršava preuzimanje s predloženim nazivom i točno očekivanim bajtovima. Stranica prijavljuje samo zahtjev; dovršetak neovisno utvrđuje test preglednika.
Primjeri
<!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>Rezultat
downloadRequested=true
Datoteka je generirani testni tekst, a ne datoteka pročitana s korisnikova računala.