Tech Stuff - DOM stopPropagation

W3C Event Reference. Part of the Events Interface

stopPropagation Method

Stops the event at this function, prevents both further upward bubbling and subsequent mouse related events even in the browser (e.g. right mouse click context menu). You can also stop the right click using the preventDefault() method.

Syntax

object.stopPropagation()

Related Commands

preventDefault

Parameters

None

Examples

// set up click event handler
window.addEventListener("click", stopit, false);

function stopit(e)
{
	if(e.button & 2)	// allows multiple buttons 
	{
		// prevent right click context menu
		e.stopPropagation());
	}
}

The function stopit() will be called every time the click event is triggered for the window. If the user has clicked with the right button (right button = 2) we stop the event propagation which prevents the browser from seeing it and hence outputting the context menu. Note: We use & not == in the tests for the right button in case multiple buttons were pressed.

Notes:

None.

Problems, comments, suggestions, corrections (including broken links) or something to add? Please take the time from a busy life to 'mail us' (at top of screen), the webmaster (below) or info-support at zytrax. You will have a warm inner glow for the rest of the day.