Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLDialogElement : propriété closedBy

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

La propriété closedBy de l'interface HTMLDialogElement indique les types d'actions utilisateur·ice·s qui peuvent être utilisées pour fermer l'élément <dialog> associé. Elle définit ou retourne la valeur de l'attribut closedby du dialogue.

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.

Exemples

Utilisation simple de closedBy

html
<dialog open closedby="any">
  <h2>Ma boîte de dialogue</h2>
  <p>
    Fermable avec la touche Échap ou en cliquant en dehors de la boîte de
    dialogue. Comportement de «&nbsp;fermeture légère&nbsp;».
  </p>
</dialog>
js
const dialogElem = document.querySelector("dialog");

// Affiche "any" dans la console
console.log(dialogElem.closedBy);

Spécifications

Specification
HTML
# dom-dialog-closedby

Compatibilité des navigateurs

Voir aussi

  • Élément HTML implémentant cette interface :