Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

closedby : décider comment un dialogue peut se fermer

Séparez la fermeture automatique des commandes explicites de l’application.

Version : HTML Living Standard

Syntaxe

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

Sur un dialogue, closedby sélectionne les actions automatiques de fermeture autorisées. any inclut les clics extérieurs et les demandes de fermeture ; closerequest inclut les demandes comme Échap, mais pas la fermeture par clic extérieur ; none désactive la fermeture automatique déclenchée par l’utilisateur. Les valeurs absentes ou invalides utilisent l’état automatique : un dialogue modal autorise les demandes de fermeture, tandis qu’un dialogue non modal ne se ferme pas automatiquement.

Cela ne désactive pas les actions délibérées de l’application. close() et requestClose() restent disponibles ; la seconde déclenche l’événement d’annulation annulable et ignore la restriction closedby. Prévoyez toujours une sortie explicite accessible lorsque la fermeture automatique est désactivée. Ne supprimez pas manuellement l’attribut open pour remplacer les méthodes de fermeture appropriées.

Le dispositif ouvre un dialogue modal, appuie sur Échap pendant que la fermeture est désactivée, puis change le réglage et appuie à nouveau sur Échap. Chromium 145 a conservé le dialogue ouvert au premier essai et l’a fermé à la seconde demande. L’exemple vérifie la capacité DOM et conserve un bouton de fermeture explicite ; cet attribut récent ne doit pas être supposé fonctionnel dans tous les navigateurs.

Exemples

<!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>

Résultat

none-open=true; closerequest-open=false

Le test envoie deux véritables événements de clavier à la page isolée et vérifie l’état d’ouverture après chacun.

Sources