aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/event/cancelbubble/index.md
blob: c6cb47bf5dc14547555ae8323864b5a7af326a13 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
---
title: Event.cancelBubble
slug: Web/API/Event/cancelBubble
tags:
  - API
  - Annulation
  - DOM
  - Evènement
  - Propagation
  - Propriétés
translation_of: Web/API/Event/cancelBubble
---
{{APIRef("DOM Events")}}

La propriété **`Event.cancelBubble`** est un alias historique de {{domxref("Event.stopPropagation()")}}. Définir sa valeur à `true` (vrai) avant le renvoi à partir d'un gestionnaire d'évènements empêche la propagation de l'évènement. Dans les implémentations les plus tardives, cette définition à false (_faux_) ne fait rien. Voir {{anch("Compatibilité des navigateurs")}} pour plus de détails.

## Syntaxe

    event.cancelBubble = bool;
    var bool = event.cancelBubble;

## Exemple

    elem.onclick = function(e) {
     // fais des choses sympas ici
      e.cancelBubble = true;
    }

## Spécifications

| Spécification                                                                                | Statut                           | Commentaire |
| -------------------------------------------------------------------------------------------- | -------------------------------- | ----------- |
| {{SpecName('DOM WHATWG', '#dom-event-cancelbubble', 'cancelBubble')}} | {{Spec2('DOM WHATWG')}} |             |

## Compatibilité des navigateurs

{{Compat("api.Event.cancelBubble")}}