KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

download: het opslaan van een bron aanvragen

Stel een bestandsnaam voor zonder downloadbeleid te kunnen afdwingen.

Versie: HTML Living Standard

Syntax

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

Op een anker of afbeeldingskaartlink geeft download een gewenste download in plaats van navigatie aan. De optionele waarde stelt een bestandsnaam voor. De browser kan die opschonen of serverinformatie gebruiken; gebruikersbeleid blijft van invloed. Het geeft geen willekeurige schrijftoegang tot het bestandssysteem.

Bronnen met dezelfde oorsprong en lokale blob-URL’s zijn het eenvoudige geval. Downloads tussen oorsprongen vereisen passende servermedewerking, waaronder bijlageverwerking; het attribuut alleen dwingt ze niet af. Geef tijdelijke object-URL’s pas vrij wanneer ze niet meer nodig zijn, niet vóór gebruik door de download.

Het voorbeeld maakt een kleine tekstblob met downloadlink. Een echte klik levert een voltooide download met voorgestelde naam en exacte bytes. De pagina meldt alleen het verzoek; de browsertest stelt voltooiing apart vast.

Voorbeelden

<!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>

Resultaat

downloadRequested=true

Het bestand is gegenereerde testtekst, geen bestand dat van de gebruikerscomputer is gelezen.

Bronnen