Event.bubbles

Indicates whether the given event bubbles up through the DOM or not. "Bubbling" is essentially where an event gets 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)
}

Specifications

See Also

• stopPropagation to prevent bubbling