I'm trying to find the jQuery equivalent of this JavaScript method call:
document.addEventListener('click', select_element, true);
I've gotten as far as:
$(document).click(select_element);
but that doesn't achieve the same result, as the last parameter of the JavaScript method - a boolean that indicates whether the event handler should be executed in the capturing or bubbling phase (per my understanding from http://www.quirksmode.org/js/events_advanced.html) - is left out.
How do I specify that parameter, or otherwise achieve the same functionality, using jQuery?
Not all browsers support event capturing (for example, Internet Explorer versions less than 9 don't) but all do support event bubbling, which is why it is the phase used to bind handlers to events in all cross-browser abstractions, jQuery's included.
The nearest to what you are looking for in jQuery is using
bind()
(superseded byon()
in jQuery 1.7+) or the event-specific jQuery methods (in this case,click()
, which callsbind()
internally anyway). All use the bubbling phase of a raised event.Here is an excellent treatment on the Mozilla Development Network (MDN) of this issue for standard JavaScript (if you do not wish to rely on jQuery or understand it better in general):
https://developer.mozilla.org/en-US/docs/DOM/element.addEventListener
Here is a discussion of event flow from a link in the above treatment:
http://www.w3.org/TR/DOM-Level-3-Events/#event-flow
Some key points are:
One thing to note is that jQuery event methods do not fire/trap
load
onembed
tags that contain SVG DOM which loads as a separate document in theembed
tag. The only way I found to trap aload
event on these were to use raw JavaScript.This will not work (I've tried
on
/bind
/load
methods):However, this works:
You should now use the
.on()
function to bind events.The closest thing would be the bind function:
http://api.jquery.com/bind/
As of jQuery 1.7,
.on()
is now the preferred method of binding events, rather than.bind()
:From http://api.jquery.com/bind/:
The documentation page is located at http://api.jquery.com/on/