Summary

Indicates whether the given event bubbles up through the DOM or not.  "Bubbling" is essentially where an event get handled first on the element it was assigned to, then subsequently handling the event on that elements parent element, then on that elements parent, and on and on.  This process continues until the event reaches an event handler and is therefore "handled."  For example, if a button has an event handler on it, and it is clicked, there will be no "bubbling" up through it's parent elements because the event is handled on the button.  However, if it is not, the event will "bubble" up, or check the parent element of the button for a handler and on and on until it either finds an event handler or reaches the DOM.

Syntax

event.bubbles

Value

A Boolean, which is true if the event bubbles up through the DOM.

Example

 function goInput(e) {
  // checks bubbles and
  if (!e.bubbles) {
     // passes event along if it's not
     passItOn(e); 
  }
  // already bubbling
  doOutput(e)
}

Note: Only certain events can bubble. Events that do bubble have this property set to true. You can use this property to check if an event is allowed to bubble or not.

Specifications

Specification Status Comment
DOM
The definition of 'Event.bubbles' in that specification.
Living Standard  
Document Object Model (DOM) Level 2 Events Specification
The definition of 'Event.bubbles' in that specification.
Obsolete Initial definition.

See Also

Document Tags and Contributors

 Last updated by: trrapp12,