База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници