on()
関数は、指定された要素 バインドするために使用されます。 ="_blank">イベント処理関数。
on()
函数用于为指定元素的一个或多个事件绑定事件处理函数。此外,你还可以额外传递给事件处理函数一些所需的数据。
从jQuery 1.7开始,on()
函数提供了绑定事件处理程序所需的所有功能,用于统一取代以前的bind()、 delegate()、 live()等事件函数。
即使是执行on()
函数之后新添加的元素,只要它符合条件,绑定的事件处理函数也对其有效。
此外,该函数可以为同一元素、同一事件类型绑定多个事件处理函数。触发事件时,jQuery会按照绑定的先后顺序依次执行绑定的事件处理函数。
要删除通过on()
绑定的事件,请使用off()函数。如果要附加一个事件,只执行一次,然后删除自己,请使用one()函数。
该函数属于jQuery
对象(实例)。
jQuery 1.7 新增该函数。其主要有以下两种形式的用法:
用法一:
1 jQueryObject.on( events [, selector ] [, data ], handler )
用法二:
1 jQueryObject.on( eventsMap [, selector ] [, data ] )
参数 | 描述 | ||||
---|---|---|---|---|---|
events | String类型一个或多个用空格分隔的事件类型和可选的命名空间,例如"click"、"focus click"、"keydown.myPlugin"。 | ||||
eventsMap | Object类型一个Object对象,其每个属性对应事件类型和可选的命名空间(参数events ),属性值对应绑定的事件处理函数(参数handler )。 |
||||
selector |
可选/String类型一个jQuery选择器,用于指定哪些后代元素可以触发绑定的事件。如果该参数为null さらに、追加の必要なデータをイベント ハンドラー関数に渡すこともできます。 jQuery 1.7 以降、on() 関数はイベント ハンドラーをバインドするために必要なすべての関数を提供し、以前の binding()、delegate()、live( ) およびその他のイベント関数。 |
||||
on() 経由でバインドされたイベントを削除するには、off() 関数を使用します。イベントを添付する場合は、イベントを 1 回だけ実行し、その後イベント自体を削除するには、one() 関数を使用します。 この関数は jQuery オブジェクト (インスタンス) に属します。 構文jQuery 1.7 この機能を追加しました。主に次の 2 つの使用形式があります: |
使用方法 1:1 // 这里的选择器selector用于指定可以触发事件的元素 2 // 这里的选择器ancestor应是selector的祖辈元素,selector触发的事件可以被其祖辈元素在事件流中捕获,从而以"代理"的形式触发事件。 3 4 // jQuery 1.0+ (1.4.3+支持参数data) 5 $("selector").click( [ data ,] handler ); 6 7 // jQuery 1.0+ (1.4.3+支持参数data) 8 $("selector").bind( "click" [, data ], handler ); 9 10 // jQuery 1.3+ (1.4+支持参数data)11 $("selector").live( "click" [, data ], handler );12 13 // jQuery 1.4.2+14 $("ancestor").delegate( "selector", "click" [, data ], handler );15 16 // jQuery 1.7+17 $("ancestor").on( "click", "selector" [, data ], handler ); ログイン後にコピー ログイン後にコピー 1 <p id="n1">2 <p id="n2"><span>CodePlayer</span></p>3 <p id="n3"><span>专注于编程开发技术分享</span></p>4 <em id="n4">http://www.365mini.com</em>5 </p>6 <p id="n5">Google</p> ログイン後にコピー ログイン後にコピー パラメータ
events ) に対応し、属性値はバインドされたイベント処理関数 (パラメータ handler ) に対応します。 🎜🎜🎜🎜🎜🎜selector🎜🎜🎜🎜Optional/String型 どの子孫要素がバインドされたイベントをトリガーできるかを指定するために使用されるjQueryセレクター。このパラメータが null であるか省略されている場合、現在の要素自体がイベントにバインドされていることを意味します (イベント ストリームが現在の要素に到達できる限り、実際のトリガーは子孫要素である場合もあります)。 。 🎜🎜🎜🎜🎜🎜data🎜🎜🎜🎜 オプション/任意のタイプ イベントがトリガーされると、event.data を通じて任意のデータをイベント処理関数に渡す必要があります。 🎜🎜🎜🎜🎜🎜handler🎜🎜🎜🎜 Function タイプで指定されたイベント ハンドラー関数。 🎜🎜🎜🎜🎜关于参数 关于参数 参数
参数 如果事件处理函数 返回值
重要说明: 如果传递了
示例&说明
以点击事件("click")为例,以下是jQuery中事件函数的常规用法(某些函数也存在其它形式的用法,此处暂不列出): 1 // 这里的选择器selector用于指定可以触发事件的元素 2 // 这里的选择器ancestor应是selector的祖辈元素,selector触发的事件可以被其祖辈元素在事件流中捕获,从而以"代理"的形式触发事件。 3 4 // jQuery 1.0+ (1.4.3+支持参数data) 5 $("selector").click( [ data ,] handler ); 6 7 // jQuery 1.0+ (1.4.3+支持参数data) 8 $("selector").bind( "click" [, data ], handler ); 9 10 // jQuery 1.3+ (1.4+支持参数data)11 $("selector").live( "click" [, data ], handler );12 13 // jQuery 1.4.2+14 $("ancestor").delegate( "selector", "click" [, data ], handler );15 16 // jQuery 1.7+17 $("ancestor").on( "click", "selector" [, data ], handler ); ログイン後にコピー ログイン後にコピー 请参考下面这段初始HTML代码: 1 <p id="n1">2 <p id="n2"><span>CodePlayer</span></p>3 <p id="n3"><span>专注于编程开发技术分享</span></p>4 <em id="n4">http://www.365mini.com</em>5 </p>6 <p id="n5">Google</p> ログイン後にコピー ログイン後にコピー 我们为 中的所有 元素绑定点击事件: 1 // 为p中的所有p元素绑定click事件处理程序2 // 只有n2、n3可以触发该事件3 $("p").on("click", "p", function(){4 // 这里的this指向触发点击事件的p元素(Element)5 alert( $(this).text() );6 }); ログイン後にコピー 如果要绑定所有的 元素,你可以编写如下jQuery代码: 1 //为所有p元素绑定click事件处理程序(注意:这里省略了selector参数)2 //n2、n3、n5均可触发该事件3 $("p").on("click", function(event){4 // 这里的this指向触发点击事件的p元素(Element)5 alert( $(this).text() );6 }); ログイン後にコピー 此外,我们还可以同时绑定多个事件,并为事件处理函数传递一些附加的数据,我们可以通过jQuery为事件处理函数传入的参数 1 var data = { id: 5, name: "张三" }; //为n5绑定mouseenter mouseleave两个事件,并为其传入附加数据data // 附加数据可以是任意类型 $("body").on("mouseenter mouseleave", "#n5", data, function(event){ var $me = $(this); 7 var options = event.data; // 这就是传入的附加数据 8 if( event.type == "mouseenter"){ 9 $me.html( "你好," + options.name + "!"); }else if(event.type == "mouseleave" ){ $me.html( "再见!"); } }); ログイン後にコピー 此外,即使符合条件的元素是 1 // 为p中的所有p元素绑定click事件处理程序2 // 只有n2、n3可以触发该事件3 $("p").on("click", "p", function(event){4 alert( $(this).text() );5 });6 7 // 后添加的n6也可以触发上述click事件,因为它也是p中的p元素8 $("#n1").append('<p id="n6">上述绑定的click事件对此元素也生效!</p>'); ログイン後にコピー 参数 1 function clickHandler(event){ 2 alert( "触发时的命名空间:[" + event.namespace + "]"); 3 } 4 5 var $p = $("p"); 6 7 // A:为所有p元素绑定click事件,定义在foo和bar两个命名空间下 8 $p.on( "click.foo.bar", clickHandler ); 9 10 // B:为所有p元素绑定click事件,定义在test命名空间下11 $p.on( "click.test", clickHandler );12 13 var $n2 = $("#n2");14 15 // 触发所有click事件16 $n2.trigger("click"); // 触发A和B (event.namespace = "")17 18 // 触发定义在foo命名空间下的click事件19 $n2.trigger("click.foo"); // 触发A (event.namespace = "foo")20 // 触发定义在bar命名空间下的click事件21 $n2.trigger("click.bar"); // 触发A (event.namespace = "bar")22 // 触发同时定义在foo和bar两个命名空间下的click事件23 $n2.trigger("click.foo.bar"); // 触发A (event.namespace = "bar.foo")24 25 // 触发定义在test命名空间下的click事件26 $n2.trigger("click.test"); // 触发B (event.namespace = "test")27 28 // 移除所有p元素定义在foo命名空间下的click事件处理函数29 $p.off( "click.foo" ); // 移除A30 31 on()函数的参数eventsMap是一个对象,可以"属性-值"的方式指定多个"事件类型-处理函数"。对应的示例代码如下:32 33 var data = { id: 5, name: "张三" };34 35 var events = {36 "mouseenter": function(event){37 $(this).html( "你好," + event.data.name + "!"); 38 },39 40 "mouseleave": function(event){41 $(this).html( "再见!");42 } 43 };44 45 //为n5绑定mouseenter mouseleave两个事件,并为其传入附加数据data46 $("body").on(events, "#n5", data); ログイン後にコピー
|
以上がjQuery on() セレクター関数の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。