CKTIS / HTML
dialog — вграден диалогов прозорец
Елементът `dialog` представлява временен прозорец за изпълнение на задача или представяне на информация. Методът `show()` го показва немодално, а `showModal()` блокира взаимодействието с останалата част от документа.
Версия: WHATWG HTML Living Standard; index snapshot date recorded separately
Синтаксис
<dialog>…</dialog>
dialog.show();
dialog.showModal();
dialog.close(result);dialog е прозорец за кратко взаимодействие с приложението, а не заместител на меню или подсказка. Необходими са както отварящият, така и затварящият таг. Без open елементът не се показва по подразбиране; само open не създава модален диалогов прозорец.
show() показва немодален диалогов прозорец. showModal() го поставя в най-горния слой; останалата част от документа става неактивна (inert). Елементът трябва да е свързан с документа. Извикването на showModal() за диалогов прозорец, който вече е отворен немодално, предизвиква InvalidStateError.
Осигурете смислено име, например чрез aria-labelledby, и видим бутон за затваряне. Изберете началния фокус с autofocus върху подходящ контролен елемент. Не задавайте tabindex на dialog.
close(result) затваря диалоговия прозорец, записва подадения низ в returnValue и предизвиква събитие close. requestClose(result) първо задейства отменяемото събитие cancel; preventDefault() може да спре затварянето. Не премахвайте ръчно open, защото така се заобикаля правилният цикъл на затваряне. closedby управлява автоматичното затваряне: any допуска и щраквания извън прозореца, closerequest допуска заявки за затваряне, а none не допуска нито едно от двете. Без този атрибут модалните диалогови прозорци обработват заявките за затваряне, а немодалните не.
Примери
<!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>Резултат
Result: confirmed
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.