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

CKTIS / HTML

open — l’état d’ouverture de details et dialog

L’attribut booléen open détermine si details est déplié ou si dialog est ouvert. C’est sa présence qui compte, et non son texte ; open seul ne crée pas de boîte de dialogue modale.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<details open>…</details>
<dialog open>…</dialog>
open | open="" | open="open"

open est un attribut booléen de details et de dialog, et non un attribut global. Les formes valides sont open, open="" et open="open". Écrire open="false" est incorrect et laisse malgré tout l’attribut présent ; pour obtenir l’état faux, il faut omettre l’attribut.

Sur details, open révèle du contenu supplémentaire à côté de summary ; sans cet attribut, seul le résumé apparaît. L’activation de summary bascule l’attribut. La propriété DOM open reflète sa présence.

Sur dialog, open seul ouvre une boîte de dialogue non modale ; la modalité nécessite showModal(). Fermez-la avec close() plutôt que de supprimer manuellement l’attribut : cette suppression manuelle ignore l’événement close et, après showModal(), peut laisser le document bloqué.

Exemples

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>open attribute</title>
<details open>
  <summary>Details</summary>
  <p>Additional information.</p>
</details>
<dialog open>
  <p>Non-modal dialog.</p>
</dialog>
<pre id="result"></pre>
<script>
  const details = document.querySelector('details');
  const dialog = document.querySelector('dialog');
  const states = [`${details.open} ${dialog.open}`];
  details.open = false;
  dialog.close();
  states.push(`${details.open} ${dialog.open}`);
  document.getElementById('result').textContent = states.join('\n');
</script>
</html>

Résultat

true true
false false

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources