CKTIS / HTML
dialog — natywne okno dialogowe
Element `dialog` reprezentuje tymczasowe okno służące do wykonania zadania lub przekazania informacji. Metoda `show()` pokazuje je niemodalnie, a `showModal()` blokuje interakcję z pozostałą częścią dokumentu.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<dialog>…</dialog>
dialog.show();
dialog.showModal();
dialog.close(result);dialog to okno do krótkiej interakcji z aplikacją, nie zamiennik menu ani podpowiedzi. Wymaga znacznika początkowego i końcowego. Bez atrybutu open domyślnie nie jest pokazywane; samo open nie tworzy okna modalnego.
show() wyświetla okno niemodalne. showModal() umieszcza je w najwyższej warstwie renderowania; reszta dokumentu staje się nieaktywna (inert). Element musi być podłączony do dokumentu. Próba wywołania showModal() dla okna już otwartego niemodalnie powoduje InvalidStateError.
Zapewnij zrozumiałą nazwę, np. przez aria-labelledby, i widoczny przycisk zamknięcia. Wybierz początkowy fokus za pomocą autofocus na odpowiedniej kontrolce. Nie ustawiaj tabindex na dialog.
close(result) zamyka okno, zapisuje podany ciąg w returnValue i powoduje zdarzenie close. requestClose(result) najpierw wywołuje anulowalne cancel; preventDefault() może zatrzymać zamknięcie. Nie usuwaj ręcznie open, ponieważ omija to prawidłowy cykl zamknięcia. closedby określa automatyczne zamykanie: any dopuszcza także kliknięcie poza oknem, closerequest — żądanie zamknięcia, a none — żadne z nich. Bez tego atrybutu okno modalne obsługuje żądania zamknięcia, a niemodalne nie.
Przykłady
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Dialog example</title>
<button id="launch" type="button">Open</button>
<dialog id="box" aria-labelledby="heading">
<h2 id="heading">Confirmation</h2>
<p>Close this dialog to continue.</p>
<button id="finish" type="button" autofocus>OK</button>
</dialog>
<p id="status" role="status">Ready</p>
<script>
const box = document.getElementById('box');
const status = document.getElementById('status');
document.getElementById('launch').addEventListener('click', () => {
box.returnValue = '';
box.showModal();
});
document.getElementById('finish').addEventListener('click', () => {
box.close('confirmed');
});
box.addEventListener('close', () => {
status.textContent = box.returnValue === 'confirmed'
? 'Result: confirmed'
: 'Result: dismissed';
});
</script>
</html>Wynik
Result: confirmed
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.