CKTIS / JavaScript
HTMLElement.hidden et click() : masquer un élément ou déclencher un clic
`hidden` reflète un attribut HTML, tandis que `click()` déclenche un clic synthétique. Masquer un élément ne le désactive pas et n’empêche pas un clic par le code.
Version : ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
element.hidden
element.hidden = true // Set the hidden attribute
element.hidden = false // Remove the hidden attribute
element.hidden = "until-found"
element.click() // No arguments; returns undefinedLa propriété hidden, accessible en lecture et en écriture, reflète l’attribut HTML hidden. Elle renvoie false si l’attribut est absent, "until-found" dans l’état « masqué jusqu’à ce qu’il soit trouvé », et true sinon. Affecter true définit un attribut vide ; affecter false le supprime. La chaîne "false" n’est pas le booléen false : elle laisse l’élément dans l’état masqué.
Dans les navigateurs qui prennent en charge "until-found", la recherche dans la page ou la navigation vers un fragment d’URL peut révéler le contenu. hidden indique l’état de l’attribut, pas la visibilité réelle à l’écran : le CSS peut modifier l’affichage. Masquer un élément ne le retire pas du DOM et ne protège pas son contenu.
element.click() ne prend aucun argument et renvoie undefined. La méthode émet de façon synchrone un événement synthétique click sur l’élément, avec event.isTrusted === false. Elle ne fait rien si le contrôle de formulaire est désactivé ou si un appel à click() est déjà en cours sur le même élément. Le masquage seul ne bloque pas cette méthode.
Un clic synthétique peut déclencher l’action par défaut, par exemple cocher ou décocher une case, mais ne confère pas à lui seul l’activation utilisateur exigée par certaines API. hidden et click() relèvent de la plateforme web, pas d’ECMAScript 2024, et nécessitent un environnement qui fournit le DOM HTML.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>HTMLElement.hidden and click()</title>
<script>
const panel = document.createElement("section");
const button = document.createElement("button");
button.type = "button";
panel.hidden = true;
button.hidden = true;
button.addEventListener("click", (event) => {
console.log(`click: isTrusted=${event.isTrusted}`);
panel.hidden = false;
});
console.log(`before: panel.hidden=${panel.hidden}`);
button.click();
button.disabled = true;
button.click();
console.log(`after: panel.hidden=${panel.hidden}`);
</script>Résultat
before: panel.hidden=true click: isTrusted=false after: panel.hidden=false
Enregistrez l’exemple complet dans un fichier HTML et ouvrez-le dans un navigateur. Le résultat s’affiche dans la console de développement. Aucun des éléments n’est inséré dans la page : l’exemple montre l’état de l’attribut et le comportement de l’événement, pas le rendu. Le premier clic retire `hidden` du panneau ; le second n’appelle pas le gestionnaire.
Leçons associées
- JavaScript · Leçon 41 · Intermédiaire · Version : 3