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

CKTIS / HTML

closedby: разрешени начини за затваряне на диалог

Отделяйте автоматичното затваряне от изричните контроли на приложението.

Версия: HTML Living Standard

Синтаксис

<dialog closedby="none">...</dialog>

Върху диалог closedby избира позволените автоматични затваряния. any включва щракване отвън и заявки за затваряне; closerequest включва заявки като Escape, но не затваряне с щракване отвън; none забранява автоматично затваряне с потребителско действие. Липсваща или невалидна стойност дава автоматично състояние: модален диалог допуска заявки за затваряне, немодален не се затваря автоматично.

Това не изключва преднамерени действия на приложението. Налични остават close() и requestClose(); вторият метод задейства отменимо събитие за отказ и пренебрегва ограничението closedby. При изключено автоматично затваряне винаги осигурявайте достъпен изричен изход. Не премахвайте ръчно атрибута за отвореност вместо правилните методи за затваряне.

Сценарият отваря модален диалог, натиска Escape при забранено затваряне, сменя настройката и натиска отново. Chromium 145 го запазва отворен при първата заявка и го затваря при втората. Примерът проверява DOM възможността и запазва бутон за затваряне; не приемайте, че всеки браузър поддържа този по-нов атрибут.

Примери

<!doctype html><meta charset="utf-8">
<dialog id="dialog" closedby="none"><p>Press Escape twice.</p><button id="exit" type="button">Close explicitly</button></dialog>
<output id="result"></output><script>
const dialog = document.querySelector('#dialog');
document.querySelector('#exit').onclick = () => dialog.close();
if (!('closedBy' in dialog)) {
  document.querySelector('#result').textContent = 'closedby unsupported; explicit close remains available';
} else {
  let count = 0, firstOpen;
  document.addEventListener('keydown', event => {
    if (event.key !== 'Escape') return;
    count += 1;
    if (count === 1) setTimeout(() => { firstOpen = dialog.open; dialog.closedBy = 'closerequest'; }, 0);
  });
  dialog.addEventListener('close', () => {
    document.querySelector('#result').textContent = 'none-open=' + firstOpen + '; closerequest-open=' + dialog.open;
  });
}
dialog.showModal();
</script>

Резултат

none-open=true; closerequest-open=false

Тестът изпраща две действителни клавиатурни събития към изолираната страница и проверява отвореността след всяко.

Източници