HTMLDialogElement : propriété closedBy

Valeur

Une chaîne de caractères ; les valeurs possibles sont :

any

La boîte de dialogue peut être fermée par une action de « fermeture légère », une action spécifique à la plateforme ou un mécanisme défini par le·la développeur·euse.

closerequest

La boîte de dialogue peut être fermée par une action spécifique à la plateforme ou un mécanisme défini par le·la développeur·euse.

none

La boîte de dialogue ne peut être fermée que par un mécanisme défini par le·la développeur·euse.

Comportement par défaut

Si l'attribut closedby est absent ou invalide, il revient à l'état Auto. Dans l'état Auto :

• lorsque le <dialog> est ouvert avec showModal(), il se comporte comme si : closedby="closerequest"
• lorsque le <dialog> est ouvert par tout autre moyen, il se comporte comme si : closedby="none"

Exemples

Utilisation simple de closedBy

<dialog closedby="any">
  <h2>Ma boîte de dialogue</h2>
  <p>
    Peut être fermé avec la touche <kbd>Échap</kbd> ou en cliquant en dehors de
    la boîte de dialogue («&nbsp;fermeture légère&nbsp;»).
  </p>
</dialog>

<pre id="journal"></pre>

const elementJournal = document.getElementById("journal");
function journaliser(texte) {
  elementJournal.innerText = `${elementJournal.innerText}${texte}\n`;
  elementJournal.scrollTop = elementJournal.scrollHeight;
}

const dialogue = document.querySelector("dialog");
dialogue.showModal();
journaliser(`closedBy: ${dialogue.closedBy}`);

Résultat

Spécifications

Compatibilité des navigateurs

Voir aussi

• L'élément HTML <dialog>