.delegate()
返回: jQuery
.delegate( selector, eventType, handler )
描述:针对匹配选择器的所有元素,把一个处理函数附加到一个或多个事件上,现在或者将来,基于一个指定的根元素集合。
加入于: 1.4.2
.delegate( selector, eventType, handler )加入于: 1.4.2
.delegate( selector, eventType, eventData, handler )加入于: 1.4.3
.delegate( selector, events )- selector类型:String一个选择器,用来筛选触发事件的元素。
- events类型:PlainObject一个或多个事件类型以及在这些事件上执行的函数构成的纯对象。
自从jQuery 1.7,.delegate()
方法就被.on()
方法取代了。然而,对于早期的版本,它依然是使用事件委托的最有效的方式。更多关于事件绑定和委托的信息,参见.on()
方法的文档。一般来说,这些是针对两种方法的等效的模板:
// jQuery 1.4.3+ $( elements ).delegate( selector, events, data, handler ); // jQuery 1.7+ $( elements ).on( events, selector, data, handler );
举个例子,下面的.delegate()
代码:
$( "table" ).delegate( "td", "click", function() { $( this ).toggleClass( "chosen" ); });
等同于下面的用.on()
写的代码:
$( "table" ).on( "click", "td", function() { $( this ).toggleClass( "chosen" ); });
要想删除用.delegate()
方法附加的事件,参见.undelegate()
方法。
传递并处理事件数据的方法与它对.on()
方法所作的相同。
其它说明
- 因为
.live()
方法处理的事件一旦委托到document的上面,就不能再停止live事件的传播。类似地,通过delegate()
方法处理的事件将传播到委托事件的元素上;当委托事件处理函数被调用时,应该已经执行了绑定在它下面的任何元素上的事件处理函数。然而,那些处理函数,可能通过调用event.stopPropagation()
或者返回false来阻止触发委托的处理函数。
示例
点击一个段落文本以添加另一个段落文本。注意——.delegate()
会把点击事件附加到所有的段落文本上——甚至是新创建的段落文本上。
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>delegate demo</title> <style> p { background: yellow; font-weight: bold; cursor: pointer; padding: 5px; } p.over { background: #ccc; } span { color: red; } </style> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <p>Click me!</p> <span></span> <script> $( "body" ).delegate( "p", "click", function() { $( this ).after( "<p>Another paragraph!</p>" ); }); </script> </body> </html>
演示结果
当每个段落文本被点击时,在一个提醒框中显示它们的文本内容:
$( "body" ).delegate( "p", "click", function() { alert( $( this ).text() ); });
要想取消一个默认操作,并阻止它向上冒泡,只要返回false:
$( "body" ).delegate( "a", "click", function() { return false; });
利用preventDefault方法可以只取消默认操作。
$( "body" ).delegate( "a", "click", function( event ) { event.preventDefault(); });
也可以绑定自定义事件。
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>delegate demo</title> <style> p { color: red; } span { color: blue; } </style> <script src="https://code.jquery.com/jquery-1.10.2.js"></script> </head> <body> <p>Has an attached custom event.</p> <button>Trigger custom event</button> <span style="display:none;"></span> <script> $( "body" ).delegate( "p", "myCustomEvent", function( e, myName, myValue ) { $( this ).text( "Hi there!" ); $( "span" ) .stop() .css( "opacity", 1 ) .text( "myName = " + myName ) .fadeIn( 30 ) .fadeOut( 1000 ); }); $( "button" ).click(function() { $( "p" ).trigger( "myCustomEvent" ); }); </script> </body> </html>
演示结果