jQuery off() 方法

定义和用法

off() 方法通常用于移除通过 on() 方法添加的事件处理程序。

自 jQuery 1.7 版本起，off() 方法是 unbind()、die() 和 undelegate() 方法的新的替代品。该方法给 API 带来很多便利，我们推荐使用该方法，它简化了 jQuery 代码库。

注意：如需移除指定的事件处理程序，当事件处理程序被添加时，选择器字符串必须匹配 on() 方法传递的参数。

提示：如需添加只运行一次的事件然后移除，请使用 one() 方法。

语法

$(selector).off(event,selector,function(eventObj),map)

参数

参数	描述
event	必需。规定要从被选元素移除的一个或多个事件或命名空间。由空格分隔多个事件值。必须是有效的事件。
selector	可选。规定添加事件处理程序时最初传递给 on() 方法的选择器。
function(eventObj)	可选。规定当事件发生时运行的函数。
map	规定事件映射 ({event:function, event:function, ...})，包含要添加到元素的一个或多个事件，以及当事件发生时运行的函数。

示例

下例演示了移除所有<p>元素上的 click 事件：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>欢迎来到蝴蝶教程</title>
    //此版本是百度cdn 1.11.1，当然你可以使用更高的版本，从2.0版本以上的是不支持ie6-8的
    <script type="text/javascript" src="http://libs.baidu.com/jquery/1.11.1/jquery.min.js"></script>
    <script>
        $(document).ready(function () {
            $("p").on("click",function(){
                $(this).css("background-color","red");
            });
            $("button").click(function(){
                $("p").off("click");
            });
        });
    </script>
</head>
<body>
    <p>点击这个段落修改它的背景颜色。</p>
    <p>点击一下按钮再点击这个段落( click 事件被移除 )。</p>
    <button>移除 click 事件句柄</button>
</body>
</html>

尝试一下

定义和用法

语法

参数

示例

相关页面