cancelBubble Property

Sets or retrieves whether the current event should bubble up the hierarchy of event handlers.

Syntax

HTML N/A

Scripting event.cancelBubble [ = bCancel ]

HTML	N/A
Scripting	event.cancelBubble [ = bCancel ]

Possible Values

false Enables bubbling.

true Cancels bubbling for this event, preventing the next event handler in the hierarchy from receiving the event.

The property is read/write with a default value of false.

Remarks

Using this property to cancel bubbling for an event does not affect subsequent events.

Example

The following document fragment cancels bubbling of the onclick event if it occurs in the IMG object when the SHIFT key is down. This prevents the event from bubbling up to the onclick event handler for the document.
Sample Code
<SCRIPT LANGUAGE="JScript">
function checkCancel()
{
    if (window.event.shiftKey)
        window.event.cancelBubble = true;
}
function showSrc()
{
    if (window.event.srcElement.tagName == "IMG")
        alert(window.event.srcElement.src);
}
</SCRIPT>

<BODY onclick="showSrc()">
<IMG onclick="checkCancel()" SRC="sample.gif">

Applies To

HTML N/A

Scripting event

Workshop Home

Essentials

Content & Component Delivery

Component Development

Data Access & Databases

Design

DHTML, HTML & CSS

Extensible Markup Language (XML)

Languages & Development Tools

Messaging & Collaboration

Networking, Protocols & Data Formats

Reusing Browser Technology

Security & Cryptography

Server Technologies

Streaming & Interactive Media

Web Content Management

Workshop Index

false	Enables bubbling.
true	Cancels bubbling for this event, preventing the next event handler in the hierarchy from receiving the event.