CKTIS / HTML
onclose — obsługa zdarzenia zamknięcia
Atrybut onclose zawiera kod JavaScript obsługujący zdarzenie close. Typowym zastosowaniem jest reakcja na zamknięcie elementu dialog, na przykład odczyt jego returnValue. Nie służy do blokowania zamknięcia.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
onclose="JavaScript statements"onclose to globalny atrybut obsługi zdarzenia close. Jego wartością jest kod JavaScript, a nie wartość logiczna. Można go zapisać na dowolnym elemencie HTML, ale samo dodanie atrybutu nie sprawia, że element zaczyna emitować to zdarzenie.
Typowym zastosowaniem jest element dialog. Wywołanie close() zamyka otwarte okno dialogowe i kolejkuje zdarzenie close. W procedurze zapisanej w atrybucie this oznacza element, a event udostępnia zdarzenie. Wynik zamknięcia można odczytać przez this.returnValue.
Zdarzenie close elementu dialog nie bąbelkuje i nie można go anulować. Aby powstrzymać żądanie zamknięcia, obsłuż anulowalne zdarzenie cancel; samo close() pomija ten etap. Ręczne usunięcie atrybutu open nie wywołuje close.
Nie myl atrybutu z właściwością JavaScript element.onclose, której przypisuje się funkcję, ani z addEventListener('close', handler), które pozwala rejestrować wielu słuchaczy. W przykładzie procedura odczytuje wynik done i aktualizuje tekst dopiero po dostarczeniu zakolejkowanego zdarzenia.
Przykłady
<!doctype html>
<meta charset="utf-8">
<title>onclose</title>
<dialog id="demo" onclose="document.getElementById('result').textContent = 'closed: ' + this.returnValue">
<p>Dialog</p>
</dialog>
<output id="result">waiting</output>
<script>
const dialog = document.getElementById('demo');
dialog.show();
dialog.close('done');
</script>Wynik
closed: done
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.