.delegate()| jqueryAPI 2.2 中文手册- AspRain.cn 致力于Web开发技术翻译整理

jQuery API 2.2.0

.delegate()

分类:事件 > 事件处理附加物

返回: jQuery

.delegate( selector, eventType, handler )

描述:针对匹配选择器的所有元素,把一个处理函数附加到一个或多个事件上,现在或者将来,基于一个指定的根元素集合。

加入于: 1.4.2
.delegate( selector, eventType, handler )
  • selector
    类型:String
    一个选择器,用来筛选触发事件的元素。
  • eventType
    类型:String
    一个字符串,包含了一个或多个用空格分隔的JavaScript事件类型,比如说“click”或者“keydown”或者自定义事件名称。
  • handler
    类型:FunctionEvent eventObject )
    一个函数,在事件触发时执行它。
加入于: 1.4.2
.delegate( selector, eventType, eventData, handler )
  • selector
    类型:String
    一个选择器,用来筛选触发事件的元素。
  • eventType
    类型:String
    一个字符串,包含了一个或多个用空格分隔的JavaScript事件类型,比如说“click”或者“keydown”或者自定义事件名称。
  • eventData
    类型:Anything
    一个对象,它包含了要传递给事件处理函数的数据。
  • handler
    类型:FunctionEvent eventObject )
    一个函数,在事件触发时执行它。
加入于: 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>

演示结果

如果网页上不能运行示例,请点击http://www.asprain.cn/jQueryAPI/delegate.htm查看示例。

如果你觉得本文档对你有用,欢迎给翻译作者支付宝打赏,支持翻译作者源源不断翻译更多有用的技术文档。