CKTIS / HTML
download: żądanie zapisania zasobu
Zaproponuj nazwę pliku bez zakładania kontroli nad polityką pobierania przeglądarki.
Wersja: HTML Living Standard
Składnia
<a href="..." download="note.txt">Download</a>Na odnośniku lub linku mapy obrazu download wskazuje zamiar pobrania zamiast zwykłej nawigacji. Opcjonalna wartość sugeruje nazwę pliku. Przeglądarka może ją oczyścić lub wykorzystać informacje odpowiedzi serwera, a polityka użytkownika nadal wpływa na operację. Atrybut nie daje dowolnego zapisu w systemie plików użytkownika.
Najprostszy przypadek to zasoby tego samego pochodzenia i lokalne adresy blob. Pobieranie między pochodzeniami wymaga odpowiedniej współpracy serwera, w tym obsługi załącznika; sam atrybut nie pozwala go wymusić. Zwolnij tymczasowy adres obiektu, kiedy nie będzie potrzebny, nie zanim pobieranie zdąży go użyć.
Przykład tworzy mały blob tekstowy i odnośnik. Rzeczywiste kliknięcie kończy się pobraniem proponowanej nazwy i dokładnych oczekiwanych bajtów. Strona raportuje tylko żądanie; ukończenie potwierdza osobno test przeglądarkowy.
Przykłady
<!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>Wynik
downloadRequested=true
Plik jest wygenerowanym tekstem testowym, nie plikiem odczytanym z komputera użytkownika.