Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

download: richiedere il salvataggio di una risorsa

Suggerisci un nome senza presumere di controllare le politiche di download.

Versione: HTML Living Standard

Sintassi

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

Su un’ancora o un link di mappa immagine, download indica un download desiderato invece della navigazione. Il valore facoltativo suggerisce il nome del file. Il browser può ripulirlo o usare informazioni server, e le politiche utente restano applicabili. Non concede scritture arbitrarie nel filesystem.

Risorse della stessa origine e URL blob locali sono il caso semplice. Download fra origini richiedono collaborazione server adeguata, inclusa la gestione come allegato; l’attributo da solo non li forza. Libera gli URL temporanei quando non servono più, non prima che il download possa usarli.

L’esempio crea un piccolo blob testuale e un link. Un vero clic produce un download concluso con nome proposto e byte esatti. La pagina segnala solo la richiesta; il test browser conferma separatamente il completamento.

Esempi

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

Risultato

downloadRequested=true

Il file è testo di prova generato, non un file letto dal computer dell’utente.

Fonti