Skip to content

Commit 3ca0bd0

Browse files
nathggnskswedberg
authored andcommitted
Update one.xml - add example that shows multiple event types Makes it clear that one will trigger handlers once per event type. Fixes jquery#352
1 parent f981228 commit 3ca0bd0

File tree

1 file changed

+14
-1
lines changed

1 file changed

+14
-1
lines changed

entries/one.xml

+14-1
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
<?xml version="1.0"?>
22
<entry type="method" name="one" return="jQuery">
33
<title>.one()</title>
4-
<desc>Attach a handler to an event for the elements. The handler is executed at most once per element.</desc>
4+
<desc>Attach a handler to an event for the elements. The handler is executed at most once per element per event type.</desc>
55
<signature>
66
<added>1.1</added>
77
<argument name="events" type="String">
@@ -107,6 +107,19 @@ $( "p" ).one( "click", function() {
107107
alert( $( this ).text() );
108108
});
109109
]]></code>
110+
</example>
111+
<example>
112+
<desc>Event handlers will trigger once per element per event type</desc>
113+
<code><![CDATA[
114+
var n = 0;
115+
$(".target").one("click mouseenter", function() {
116+
$(".count").html(++n);
117+
});
118+
]]></code>
119+
<html><![CDATA[
120+
<div class="count">0</div>
121+
<div class="target">Hover/click me</div>
122+
]]></html>
110123
</example>
111124
<category slug="events/event-handler-attachment"/>
112125
<category slug="version/1.1"/>

0 commit comments

Comments
 (0)