jquery one

jQuery .one() 方法

jQuery 的 .one() 方法用于为元素绑定一个事件处理函数，该函数只会执行一次。执行后，事件处理函数会自动解绑，避免重复触发。

语法

$(selector).one(event, handler);

• event: 指定事件类型（如 "click"、"mouseenter"）。
• handler: 事件触发时执行的函数。

示例

$("#button").one("click", function() {
    alert("This will only show once.");
});

传递数据

可以向事件处理函数传递额外数据：

$("#button").one("click", {message: "Hello"}, function(event) {
    alert(event.data.message); // 输出 "Hello"
});

多个事件

可以为一个元素绑定多个事件，每个事件只触发一次：

$("#button").one("click mouseenter", function() {
    console.log("Triggered once for click or mouseenter.");
});

解绑事件

尽管 .one() 会自动解绑，也可以通过 .off() 手动解绑：

$("#button").off("click");

适用场景

• 表单提交后禁用按钮，避免重复提交。
• 首次点击展开内容后不再监听点击事件。
• 单次动画或提示触发。

.one() 是简化单次事件绑定的便捷方法，避免手动解绑的繁琐操作。