CKTIS / HTML
onclose — gérer un événement close
L’attribut onclose contient du code JavaScript qui gère l’événement close. Il sert généralement à réagir à la fermeture d’un élément dialog, par exemple en lisant sa propriété returnValue. Il ne permet pas d’empêcher la fermeture.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onclose="JavaScript statements"onclose est un attribut global de gestionnaire d’événement pour close. Sa valeur est du code JavaScript, et non une valeur booléenne. Il peut être écrit sur n’importe quel élément HTML, mais sa simple présence ne fait pas émettre cet événement à l’élément.
Il est souvent utilisé avec l’élément dialog. L’appel de close() ferme une boîte de dialogue ouverte et met en file d’attente un événement close. Dans le gestionnaire de l’attribut, this désigne l’élément et event fournit l’objet événement. Le résultat de la fermeture se lit avec this.returnValue.
L’événement close d’un élément dialog ne remonte pas dans l’arbre et ne peut pas être annulé. Pour empêcher une demande de fermeture, gérez l’événement annulable cancel ; close() ignore cette étape. La suppression manuelle de l’attribut open ne déclenche pas close.
Ne confondez pas l’attribut avec la propriété JavaScript element.onclose, à laquelle on affecte une fonction, ni avec addEventListener('close', handler), qui permet d’ajouter plusieurs écouteurs. Dans l’exemple, le gestionnaire lit le résultat done et ne met à jour le texte qu’après la distribution de l’événement mis en file d’attente.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>onclose</title>
<dialog id="demo" onclose="document.getElementById('result').textContent = 'closed: ' + this.returnValue">
<p>Dialog</p>
</dialog>
<output id="result">waiting</output>
<script>
const dialog = document.getElementById('demo');
dialog.show();
dialog.close('done');
</script>Résultat
closed: done
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.