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.