stopPropagation(),preventDefault()和return false

阅读本文之前你最好了解JavaScript在浏览器中 事件冒泡事件捕获 两个概念。

因为HTML结构中存在着父、子节点的事件冒泡,以及浏览器默认动作,所以我们使用 JavaScript 时为了达到预期效果经常需要阻止事件和动作执行. 一般我们会用到三种方法, 分别是 stopPropagation(),preventDefault() 和 return false。它们之间有什么区别,该怎么使用呢?将在本文中进行讲解。

名词解释

监听事件:指在节点上能被监听的页面操作。如: select 节点的 change 事件, a 节点的 click 事件。
浏览器默认动作:指特定页面元素上带有的功能。如: 点击 a 链接节点的跳转动作, 表单提交动作。
stopPropagation():阻止事件冒泡。
preventDefault():阻止浏览器默认行为。

stopPropagation()

因为事件可以在各层级的节点中传递,不管是冒泡还是捕获,有时我们希望事件在特定节点执行完之后不再传递,可以使用事件对象的 stopPropagation() 方法。
假设页面上存在一个浮动弹出层,显示在最前面,当点击弹出层以外页面区域时,隐藏弹出层。为了做到这样的效果,我们会监听 documentElement 的 click 事件,一旦事件被触发即隐藏弹出层。但是…
这显然存在问题。当用户点击弹出层时,我们不希望它隐藏掉。但因为事件的冒泡传递,documentElement 的 click 事件也会被触发。这个时候,我们可以监听弹出层的 click 事件,并使用 stopPropagation() 方法阻止冒泡。请参考下面的代码:

[code lang=”javascript”]

// 在弹出对话框上点击时, 不进行任何页面操作, 并阻止冒泡
document.getElementById(‘dialog’).onclick = function(ev) {
ev.stopPropagation();
};
// 在 documentElement 节点上监听到点击事件时, 隐藏对话框
document.documentElement.onclick = function(ev) {
document.getElementById(‘dialog’).style.display = ‘none’;
};

[/code]

stopPropagation() 相当好用,可是 IE8 及以前版本都不支持(用jquery就不用考略这点了)。IE 的事件对象包含特有的属性 cancelBubble, 只要将它赋值为 false 即可阻止事件继续。如:

[code lang=”javascript”]

// 在弹出对话框上点击时, 不进行任何页面操作, 并阻止冒泡
document.getElementById(‘dialog’).onclick = function(ev) {
ev.cancelBubble = false;
};

[/code]

preventDefault()

一个带事件监听的链接代码如下:

[code lang=”html”]

<a href="http://w3c.org" onclick="alert(‘my name is chic!’);">点击我哦!</a>

[/code]

点击该链接, 显示对话框后跳转页面。由此可知,除了执行监听事件还会触发浏览器默认动作;执行监听事件在前,触发浏览器默认动作在后。
这里有个经典示例, 我们希望点击链接在新窗口打开页面,但不希望当前页面跳转。这个时候可以使用 preventDefault() 阻止后面将要执行的浏览器默认动作。

[code lang=”html”]
<a id="link" href="http://w3c.org">W3C 首页链接</a>
<script>
//在新窗口, 打开页面
document.getElementById(‘link’).onclick = function(ev) {
// 阻止浏览器默认动作 (页面跳转)
ev.preventDefault();
// 在新窗口打开页面
window.open(this.href);
};
</script>
[/code]

return false

退出执行,return false 之后的所有触发事件和动作都不会被执行。有时候 return false 可以用来替代 stopPropagation() 和 preventDefault(),比如我们上面新窗口打开链接的例子,如:

[code lang=”html”]
<a id="link" href="http://w3c.org">W3C 首页链接</a>
<script>
//在新窗口, 打开页面
document.getElementById(‘link’).onclick = function(ev) {
// 在新窗口打开页面
window.open(this.href);
// 退出执行 (在监听事件之后执行的浏览器默认动作将不会被执行)
return false;
};
</script>
[/code]

有人认为 return false = stopPropagation() + preventDefault(),其实是错的。return false 不但阻止事件,还可以返回对象,跳出循环等… 方便地一刀切而不够灵活,滥用易出错.

“return false”之所以被误用的如此厉害,是因为它看起来像是完成了我们交给它的工作,浏览器不会再将我们重定向到 href 中的链接,表单也不会被继续提交,但这么做到底有什么不对呢?

可能在你刚开始学习关于jQuery事件处理时,看到的第一个例子就是关于如何阻止浏览器执行默认行为,比如下面这段演示click事件的代码

[code lang=”javascript”]
$("a.toggle").click(function () {
$("#mydiv").toggle();
return false; // Prevent browser from visiting `#`
});

[/code]

这个函数使用toggle来显示或者隐藏 #mydiv,然后阻止浏览器继续访问href中指定的链接。

像上面这样的例子会让用户养成使用“return false”来阻止浏览器执行默认行为的坏习惯,在这篇文章里,我将会讨论关于阻止浏览器执行默认行为的两个非常重要的主题:

选择正确的方法:return false还是preventDefault,stopPropagation或者stopImmediatePropagation
选择合适的位置,开始,结束,还是中间某个地方:你应该在事件回调的哪个部分取消浏览器执行默认行为?

注意:当我在这篇文章中提到event bubbling(事件冒泡),我想表达的是大部分事件都是先在初始DOM上触发,然后再通过DOM树往上,在每一级父元素上触发,事件不会在兄弟节点或是子节点上冒泡(当事件向下冒泡时,我们叫它事件捕捉(event capturing)),你可以在这里了解更多关于事件起泡和捕捉的介绍。

选择正确的方法

“return false”之所以被误用的如此厉害,是因为它看起来像是完成了我们交给它的工作,浏览器不会再将我们重定向到href中的链接,表单也不会被继续提交,但这么做到底有什么不对呢?

”return false“到底做了什么?

当你每次调用”return false“的时候,它实际上做了3件事情:

  1. event.preventDefault();
  2. event.stopPropagation();
  3. 停止回调函数执行并立即返回。

“等等”,你叫了起来!我只是想让浏览器停止继续执行默认行为而已,我不需要它去做另外2件事。

这3件事中用来阻止浏览器继续执行默认行为的只有preventDefault,除非你想要停止事件冒泡,否则使用return false会为你的代码埋下很大的隐患,让我们通过一个真实的例子来看看这样的误用会造成什么后果:

这是我们用来演示的HTML:

[code lang=”html”]
<div class="post">
<h2><a href="http://jb51.net">My Page</a></h2>
<div class="content">
Teaser text…
</div>
</div>
<div class="post">
<h2><a href="http://jb51.net">My Other Page</a></h2>
<div class="content">
Teaser text…
</div>
</div>

[/code]

现在假设我们想要在用户点击文章标题时,将文章动态载入到div.contentd中:

[code lang=”html”]
jQuery(document).ready(function ($) {
$("div.post h2 a").click(function () {
var a = $(this),
href = a.attr(‘href’), // Let jQuery normalize `href`,
content = a.parent().next();
content.load(href + " #content");
return false; // "cancel" the default behavior of following the link
});
});

[/code]

这段代码可以正常工作(至少目前是),但如果我们顺着这个思路继续,如果我想要在用户点击了一个div.post元素(或者任何一个它的子元素)时,给它加上一个active类,我就需要给div.post增加了一个click回调:

[code lang=”javascript”]
// Inside Document Ready:
var posts = $("div.post");
posts.click(function () {
// Remove active from all div.post
posts.removeClass("active");
// Add it back to this one
$(this).addClass("active");
});

[/code]

现在,如果我们点击一个帖子的标题,这段代码会工作吗?答案是不会,因为我们在标题的click回调里使用了return false而不是我们应该使用的,”return false“等于event.preventDefault();加event.stopPropagation();,所以事件冒泡就被终止了,click事件不会被冒泡到div.post上,我们为它添加的事件回调当然也就不会被调用了。

如果我们把它和live或者delegate事件混在一起使用时,情况就更糟了。

[code lang=”javascript”]
$("a").click(function () {
// do something
return false;
});

$("a").live("click", function () {
// THIS WON’T FIRE
});

[/code]

那么我们真正需要的是什么呢?

preventDefault()

大多数情况下,当你使用return false时,你其实真正需要的是e.preventDefault()。要使用e.preventDefault,你需要确保你传递了event参数到你的回掉函数中(在这个例子里,就是那个e):

[code lang=”javascript”]
$("a").click(function (e) {
// e == our event data
e.preventDefault();
});

[/code]

它会替我们完成所有工作,但不会阻止父节点继续处理事件,要记住,你放在代码中的限制越少,你的代码就越灵活,也就越易于维护。

stopPropagation()

但有些情况下,你有可能需要停止事件冒泡,让我们看看下面的例子:

[code lang=”html”]
<div class="post">
Normal text and then a <a href="http://jb51.net">link</a> and then more text.
</div>

[/code]

现在,让我们假设如果你点了div上除了a链接之外的地方,我们希望能发生点什么事情(比如改变下背景什么的),但是不能影响用户点击a链接的行为(从可用性的角度,这个例子不怎么好,你可能不希望用户点击别的地方时发生任何事情)。

[code lang=”javascript”]
$("div.post").click(function () {
// Do the first thing;
});

$("div.post a").click(function (e) {
// Don’t cancel the browser’s default action
// and don’t bubble this event!
e.stopPropagation();
});

[/code]

在这种情况下,如果我们使用return false,div的click事件不会被触发,但是用户也不会到达他们点的那个链接。

stopImmediatePropagation()

这个方法会停止一个事件继续执行,即使当前的对象上还绑定了其它处理函数,所有绑定在一个对象上的事件会按绑定顺序执行,看看下面的例子:

[code lang=”javascript”]
$("div a").click(function () {
// Do something
});

$("div a").click(function (e) {
// Do something else
e.stopImmediatePropagation();
});

$("div a").click(function () {
// THIS NEVER FIRES
});

$("div").click(function () {
// THIS NEVER FIRES
});

[/code]

你可能会觉得这个例子看起来很别扭,没错,尽管如此,但有时这的确会发生,如果你的代码非常复杂,那么不同的widgets和plugin就有可能在同一个对象上添加事件,如果遇到这种情况,那你就很有必要理解和使用stopImmediatePropagation。

return false

只有当你同时需要preventDefault和stopPropagation,并且你的代码可以接受直到你的回调执行完成才停止执行浏览器的默认行为,那你就可以使用”return false“。但我强烈建议你别在写给其它jQuery开发者的演示代码中使用这个方法,因为这会造成更多误用,只有在你确信非用不可的情况下再去使用”return false“。

选择适当的位置

如果你使用了”return false“,它只会在你的回调函数执行结束才去取消浏览器的默认行为,但是使用e.preventDefault,我们有更多的选择,它可以随时停止浏览器执行默认动作,而不管你将它放在函数的哪个部分。

  1. 开发阶段,你应该总是将它放在第一行。你最不想做的事情可能就是你正在调试将一个form改成ajax提交的时候,它却已经被按照老方法提交了。

  2. 产品阶段,如果你采用了渐进增强(progressive enhancement),那就把它放到回调的结束位置,或者是逻辑终点,如果在一个普通页面采用渐进增强,那你就需要在服务器端考虑如果浏览器不支持JS时(或者被禁用时),对链接的click事件和表单的提交事件的处理。这里的好处是,我们不考虑关闭JS的情况,只考虑支持js时的强狂,如果你的回调代码出错抛出了异常,让我们看看下面的代码:

[code lang=”javascript”]
var data = {};
$("a").click(function (e) {
e.preventDefault(); // cancel default behavior
// Throws an error because `my` is undefined
$("body").append(data.my.link);
// The original link doesn’t work AND the "cool"
// JavaScript has broken. The user is left with NOTHING!
});

[/code]

现在,让我们看看同样的事件,把preventDefault调用放在底部的效果:

[code lang=”javascript”]
var data = {};
$("a").click(function (e) {
// Throws an error because `my` is undefined
$("body").append(data.my.link);

// This line is never reached, and your website
// falls back to using the `href` instead of this
// "cool" broken JavaScript!
e.preventDefault(); // cancel default behavior
});
[/code]

这对表单提交也同样有效,你可以更好的应对出错的情况,别指望你的代码一直正常工作,在发生错误时有正确的应对总胜过假设代码不会出错。

3.在产品阶段,如果功能这设计JS,那就还应该放在第一行。

记住,不必非得是函数的第一行,但是越早越好,这里的原则是:如果函数的功能是通过JS实现的(不涉及服务端交互),那就没必要考虑兼容,在这种情况下,添加在第一行可以防止URL中出现#字符,但显然,你还是应该尽可能多的增加些错误处理代码,以防止用户在出错时变得不知所措。

您的赞助将会支持作者创作及本站运维

发表评论


TOP