@types/jquery 3.5.29 → 3.5.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. jquery/JQuery.d.ts +163 -95
  2. jquery/README.md +1 -1
  3. jquery/package.json +3 -3
jquery/JQuery.d.ts CHANGED
@@ -1574,25 +1574,25 @@ $( "div.test" ).bind({
1574
1574
  * Bind an event handler to the "blur" JavaScript event, or trigger that event on an element.
1575
1575
  * @param eventData An object containing data that will be passed to the event handler.
1576
1576
  * @param handler A function to execute each time the event is triggered.
1577
- * @see \`{@link https://api.jquery.com/blur/ }\`
1577
+ * @see \`{@link https://api.jquery.com/blur-shorthand/ }\`
1578
1578
  * @since 1.4.3
1579
1579
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
1580
1580
  *
1581
1581
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
1582
1582
  *
1583
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
1583
+ * **Solution**: Instead of `.blur(fn)` use `.on("blur", fn)`. Instead of `.blur()` use `.trigger("blur")`.
1584
1584
  */
1585
1585
  blur<TData>(eventData: TData, handler: JQuery.TypeEventHandler<TElement, TData, TElement, TElement, "blur">): this;
1586
1586
  /**
1587
1587
  * Bind an event handler to the "blur" JavaScript event, or trigger that event on an element.
1588
1588
  * @param handler A function to execute each time the event is triggered.
1589
- * @see \`{@link https://api.jquery.com/blur/ }\`
1589
+ * @see \`{@link https://api.jquery.com/blur-shorthand/ }\`
1590
1590
  * @since 1.0
1591
1591
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
1592
1592
  *
1593
1593
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
1594
1594
  *
1595
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
1595
+ * **Solution**: Instead of `.blur(fn)` use `.on("blur", fn)`. Instead of `.blur()` use `.trigger("blur")`.
1596
1596
  * @example ​ ````To trigger the blur event on all paragraphs:
1597
1597
  ```javascript
1598
1598
  $( "p" ).blur();
@@ -1607,13 +1607,13 @@ $( "p" ).blur();
1607
1607
  * Bind an event handler to the "change" JavaScript event, or trigger that event on an element.
1608
1608
  * @param eventData An object containing data that will be passed to the event handler.
1609
1609
  * @param handler A function to execute each time the event is triggered.
1610
- * @see \`{@link https://api.jquery.com/change/ }\`
1610
+ * @see \`{@link https://api.jquery.com/change-shorthand/ }\`
1611
1611
  * @since 1.4.3
1612
1612
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
1613
1613
  *
1614
1614
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
1615
1615
  *
1616
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
1616
+ * **Solution**: Instead of `.change(fn)` use `.on("change", fn)`. Instead of `.change()` use `.trigger("change")`.
1617
1617
  */
1618
1618
  change<TData>(
1619
1619
  eventData: TData,
@@ -1622,13 +1622,13 @@ $( "p" ).blur();
1622
1622
  /**
1623
1623
  * Bind an event handler to the "change" JavaScript event, or trigger that event on an element.
1624
1624
  * @param handler A function to execute each time the event is triggered.
1625
- * @see \`{@link https://api.jquery.com/change/ }\`
1625
+ * @see \`{@link https://api.jquery.com/change-shorthand/ }\`
1626
1626
  * @since 1.0
1627
1627
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
1628
1628
  *
1629
1629
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
1630
1630
  *
1631
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
1631
+ * **Solution**: Instead of `.change(fn)` use `.on("change", fn)`. Instead of `.change()` use `.trigger("change")`.
1632
1632
  * @example ​ ````Attaches a change event to the select that gets the text for each selected option and writes them in the div. It then triggers the event for the initial text draw.
1633
1633
  ```html
1634
1634
  <!doctype html>
@@ -1850,7 +1850,8 @@ $( "div" ).children( ".selected" ).css( "color", "blue" );
1850
1850
  */
1851
1851
  children<K extends keyof HTMLElementTagNameMap>(selector: K): JQuery<HTMLElementTagNameMap[K]>;
1852
1852
  children<K extends keyof SVGElementTagNameMap>(selector: K): JQuery<SVGElementTagNameMap[K]>;
1853
- children(selector?: JQuery.Selector): JQuery;
1853
+ // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
1854
+ children<E extends Element = HTMLElement>(selector?: JQuery.Selector): JQuery<E>;
1854
1855
  /**
1855
1856
  * Remove from the queue all items that have not yet been run.
1856
1857
  * @param queueName A string containing the name of the queue. Defaults to fx, the standard effects queue.
@@ -2032,7 +2033,10 @@ $( "b" ).clone().prependTo( "p" );
2032
2033
  * @see \`{@link https://api.jquery.com/closest/ }\`
2033
2034
  * @since 1.4
2034
2035
  */
2035
- closest(selector: JQuery.Selector, context: Element): this;
2036
+ closest<K extends keyof HTMLElementTagNameMap>(selector: K, context: Element): JQuery<HTMLElementTagNameMap[K]>;
2037
+ closest<K extends keyof SVGElementTagNameMap>(selector: K, context: Element): JQuery<SVGElementTagNameMap[K]>;
2038
+ // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
2039
+ closest<E extends Element = HTMLElement>(selector: JQuery.Selector, context: Element): JQuery<E>;
2036
2040
  /**
2037
2041
  * For each element in the set, get the first element that matches the selector by testing the element itself and traversing up through its ancestors in the DOM tree.
2038
2042
  * @param selector_selection_element _&#x40;param_ `selector_selection_element`
@@ -2115,7 +2119,15 @@ $( document ).on( "click", function( event ) {
2115
2119
  </html>
2116
2120
  ```
2117
2121
  */
2118
- closest(selector_selection_element: JQuery.Selector | Element | JQuery): this;
2122
+ closest<K extends keyof HTMLElementTagNameMap>(
2123
+ selector_selection_element: K | JQuery<K>,
2124
+ ): JQuery<HTMLElementTagNameMap[K]>;
2125
+ closest<K extends keyof SVGElementTagNameMap>(
2126
+ selector_selection_element: K | JQuery<K>,
2127
+ ): JQuery<SVGElementTagNameMap[K]>;
2128
+ // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
2129
+ closest<E extends Element = HTMLElement>(selector_selection_element: JQuery.Selector): JQuery<E>;
2130
+ closest<E extends Element = HTMLElement>(selector_selection_element: E | JQuery<E>): JQuery<E>;
2119
2131
  /**
2120
2132
  * Get the children of each element in the set of matched elements, including text and comment nodes.
2121
2133
  * @see \`{@link https://api.jquery.com/contents/ }\`
@@ -2171,13 +2183,13 @@ $( "#frameDemo" ).contents().find( "a" ).css( "background-color", "#BADA55" );
2171
2183
  * Bind an event handler to the "contextmenu" JavaScript event, or trigger that event on an element.
2172
2184
  * @param eventData An object containing data that will be passed to the event handler.
2173
2185
  * @param handler A function to execute each time the event is triggered.
2174
- * @see \`{@link https://api.jquery.com/contextmenu/ }\`
2186
+ * @see \`{@link https://api.jquery.com/contextmenu-shorthand/ }\`
2175
2187
  * @since 1.4.3
2176
2188
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
2177
2189
  *
2178
2190
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
2179
2191
  *
2180
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
2192
+ * **Solution**: Instead of `.contextmenu(fn)` use `.on("contextmenu", fn)`. Instead of `.contextmenu()` use `.trigger("contextmenu")`.
2181
2193
  */
2182
2194
  contextmenu<TData>(
2183
2195
  eventData: TData,
@@ -2186,13 +2198,13 @@ $( "#frameDemo" ).contents().find( "a" ).css( "background-color", "#BADA55" );
2186
2198
  /**
2187
2199
  * Bind an event handler to the "contextmenu" JavaScript event, or trigger that event on an element.
2188
2200
  * @param handler A function to execute each time the event is triggered.
2189
- * @see \`{@link https://api.jquery.com/contextmenu/ }\`
2201
+ * @see \`{@link https://api.jquery.com/contextmenu-shorthand/ }\`
2190
2202
  * @since 1.0
2191
2203
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
2192
2204
  *
2193
2205
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
2194
2206
  *
2195
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
2207
+ * **Solution**: Instead of `.contextmenu(fn)` use `.on("contextmenu", fn)`. Instead of `.contextmenu()` use `.trigger("contextmenu")`.
2196
2208
  * @example ​ ````To show a &quot;Hello World!&quot; alert box when the contextmenu event is triggered on a paragraph on the page:
2197
2209
  ```javascript
2198
2210
  $( "p" ).contextmenu(function() {
@@ -2703,13 +2715,13 @@ $( "button" ).click(function() {
2703
2715
  * Bind an event handler to the "dblclick" JavaScript event, or trigger that event on an element.
2704
2716
  * @param eventData An object containing data that will be passed to the event handler.
2705
2717
  * @param handler A function to execute each time the event is triggered.
2706
- * @see \`{@link https://api.jquery.com/dblclick/ }\`
2718
+ * @see \`{@link https://api.jquery.com/dblclick-shorthand/ }\`
2707
2719
  * @since 1.4.3
2708
2720
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
2709
2721
  *
2710
2722
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
2711
2723
  *
2712
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
2724
+ * **Solution**: Instead of `.dblclick(fn)` use `.on("dblclick", fn)`. Instead of `.dblclick()` use `.trigger("dblclick")`.
2713
2725
  */
2714
2726
  dblclick<TData>(
2715
2727
  eventData: TData,
@@ -2718,13 +2730,13 @@ $( "button" ).click(function() {
2718
2730
  /**
2719
2731
  * Bind an event handler to the "dblclick" JavaScript event, or trigger that event on an element.
2720
2732
  * @param handler A function to execute each time the event is triggered.
2721
- * @see \`{@link https://api.jquery.com/dblclick/ }\`
2733
+ * @see \`{@link https://api.jquery.com/dblclick-shorthand/ }\`
2722
2734
  * @since 1.0
2723
2735
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
2724
2736
  *
2725
2737
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
2726
2738
  *
2727
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
2739
+ * **Solution**: Instead of `.dblclick(fn)` use `.on("dblclick", fn)`. Instead of `.dblclick()` use `.trigger("dblclick")`.
2728
2740
  * @example ​ ````To bind a &quot;Hello World!&quot; alert box to the dblclick event on every paragraph on the page:
2729
2741
  ```javascript
2730
2742
  $( "p" ).dblclick(function() {
@@ -4249,7 +4261,9 @@ $( "p" )
4249
4261
  */
4250
4262
  find<K extends keyof HTMLElementTagNameMap>(selector_element: K | JQuery<K>): JQuery<HTMLElementTagNameMap[K]>;
4251
4263
  find<K extends keyof SVGElementTagNameMap>(selector_element: K | JQuery<K>): JQuery<SVGElementTagNameMap[K]>;
4252
- find<E extends HTMLElement>(selector_element: JQuery.Selector | Element | E | JQuery<E>): JQuery<E>;
4264
+ // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
4265
+ find<E extends Element = HTMLElement>(selector_element: JQuery.Selector): JQuery<E>;
4266
+ find<E extends Element = HTMLElement>(selector_element: E | JQuery<E>): JQuery<E>;
4253
4267
  /**
4254
4268
  * Stop the currently-running animation, remove all queued animations, and complete all animations for the matched elements.
4255
4269
  * @param queue The name of the queue in which to stop animations.
@@ -4406,13 +4420,13 @@ $( "p span" ).first().addClass( "highlight" );
4406
4420
  * Bind an event handler to the "focus" JavaScript event, or trigger that event on an element.
4407
4421
  * @param eventData An object containing data that will be passed to the event handler.
4408
4422
  * @param handler A function to execute each time the event is triggered.
4409
- * @see \`{@link https://api.jquery.com/focus/ }\`
4423
+ * @see \`{@link https://api.jquery.com/focus-shorthand/ }\`
4410
4424
  * @since 1.4.3
4411
4425
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
4412
4426
  *
4413
4427
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
4414
4428
  *
4415
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
4429
+ * **Solution**: Instead of `.focus(fn)` use `.on("focus", fn)`. Instead of `.focus()` use `.trigger("focus")`.
4416
4430
  */
4417
4431
  focus<TData>(
4418
4432
  eventData: TData,
@@ -4421,13 +4435,13 @@ $( "p span" ).first().addClass( "highlight" );
4421
4435
  /**
4422
4436
  * Bind an event handler to the "focus" JavaScript event, or trigger that event on an element.
4423
4437
  * @param handler A function to execute each time the event is triggered.
4424
- * @see \`{@link https://api.jquery.com/focus/ }\`
4438
+ * @see \`{@link https://api.jquery.com/focus-shorthand/ }\`
4425
4439
  * @since 1.0
4426
4440
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
4427
4441
  *
4428
4442
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
4429
4443
  *
4430
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
4444
+ * **Solution**: Instead of `.focus(fn)` use `.on("focus", fn)`. Instead of `.focus()` use `.trigger("focus")`.
4431
4445
  * @example ​ ````Fire focus.
4432
4446
  ```html
4433
4447
  <!doctype html>
@@ -4478,13 +4492,13 @@ $( document ).ready(function() {
4478
4492
  * Bind an event handler to the "focusin" event.
4479
4493
  * @param eventData An object containing data that will be passed to the event handler.
4480
4494
  * @param handler A function to execute each time the event is triggered.
4481
- * @see \`{@link https://api.jquery.com/focusin/ }\`
4495
+ * @see \`{@link https://api.jquery.com/focusin-shorthand/ }\`
4482
4496
  * @since 1.4.3
4483
4497
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
4484
4498
  *
4485
4499
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
4486
4500
  *
4487
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
4501
+ * **Solution**: Instead of `.focusin(fn)` use `.on("focusin", fn)`. Instead of `.focusin()` use `.trigger("focusin")`.
4488
4502
  */
4489
4503
  focusin<TData>(
4490
4504
  eventData: TData,
@@ -4493,13 +4507,13 @@ $( document ).ready(function() {
4493
4507
  /**
4494
4508
  * Bind an event handler to the "focusin" event.
4495
4509
  * @param handler A function to execute each time the event is triggered.
4496
- * @see \`{@link https://api.jquery.com/focusin/ }\`
4510
+ * @see \`{@link https://api.jquery.com/focusin-shorthand/ }\`
4497
4511
  * @since 1.4
4498
4512
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
4499
4513
  *
4500
4514
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
4501
4515
  *
4502
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
4516
+ * **Solution**: Instead of `.focusin(fn)` use `.on("focusin", fn)`. Instead of `.focusin()` use `.focusin("click")`.
4503
4517
  * @example ​ ````Watch for a focus to occur within the paragraphs on the page.
4504
4518
  ```html
4505
4519
  <!doctype html>
@@ -4544,7 +4558,7 @@ $( "p" ).focusin(function() {
4544
4558
  *
4545
4559
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
4546
4560
  *
4547
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
4561
+ * **Solution**: Instead of `.focusout(fn)` use `.on("focusout", fn)`. Instead of `.focusout()` use `.trigger("focusout")`.
4548
4562
  */
4549
4563
  focusout<TData>(
4550
4564
  eventData: TData,
@@ -4559,7 +4573,7 @@ $( "p" ).focusin(function() {
4559
4573
  *
4560
4574
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
4561
4575
  *
4562
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
4576
+ * **Solution**: Instead of `.focusout(fn)` use `.on("focusout", fn)`. Instead of `.focusout()` use `.trigger("focusout")`.
4563
4577
  * @example ​ ````Watch for a loss of focus to occur inside paragraphs and note the difference between the focusout count and the blur count. (The blur count does not change because those events do not bubble.)
4564
4578
  ```html
4565
4579
  <!doctype html>
@@ -6031,13 +6045,13 @@ $( "li" ).click(function() {
6031
6045
  * Bind an event handler to the "keydown" JavaScript event, or trigger that event on an element.
6032
6046
  * @param eventData An object containing data that will be passed to the event handler.
6033
6047
  * @param handler A function to execute each time the event is triggered.
6034
- * @see \`{@link https://api.jquery.com/keydown/ }\`
6048
+ * @see \`{@link https://api.jquery.com/keydown-shorthand/ }\`
6035
6049
  * @since 1.4.3
6036
6050
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
6037
6051
  *
6038
6052
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
6039
6053
  *
6040
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
6054
+ * **Solution**: Instead of `.keydown(fn)` use `.on("keydown", fn)`. Instead of `.keydown()` use `.trigger("keydown")`.
6041
6055
  */
6042
6056
  keydown<TData>(
6043
6057
  eventData: TData,
@@ -6046,13 +6060,13 @@ $( "li" ).click(function() {
6046
6060
  /**
6047
6061
  * Bind an event handler to the "keydown" JavaScript event, or trigger that event on an element.
6048
6062
  * @param handler A function to execute each time the event is triggered.
6049
- * @see \`{@link https://api.jquery.com/keydown/ }\`
6063
+ * @see \`{@link https://api.jquery.com/keydown-shorthand/ }\`
6050
6064
  * @since 1.0
6051
6065
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
6052
6066
  *
6053
6067
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
6054
6068
  *
6055
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
6069
+ * **Solution**: Instead of `.keydown(fn)` use `.on("keydown", fn)`. Instead of `.keydown()` use `.trigger("keydown")`.
6056
6070
  * @example ​ ````Show the event object for the keydown handler when a key is pressed in the input.
6057
6071
  ```html
6058
6072
  <!doctype html>
@@ -6123,13 +6137,13 @@ $( "#other" ).click(function() {
6123
6137
  * Bind an event handler to the "keypress" JavaScript event, or trigger that event on an element.
6124
6138
  * @param eventData An object containing data that will be passed to the event handler.
6125
6139
  * @param handler A function to execute each time the event is triggered.
6126
- * @see \`{@link https://api.jquery.com/keypress/ }\`
6140
+ * @see \`{@link https://api.jquery.com/keypress-shorthand/ }\`
6127
6141
  * @since 1.4.3
6128
6142
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
6129
6143
  *
6130
6144
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
6131
6145
  *
6132
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
6146
+ * **Solution**: Instead of `.keypress(fn)` use `.on("keypress", fn)`. Instead of `.keypress()` use `.trigger("keypress")`.
6133
6147
  */
6134
6148
  keypress<TData>(
6135
6149
  eventData: TData,
@@ -6138,13 +6152,13 @@ $( "#other" ).click(function() {
6138
6152
  /**
6139
6153
  * Bind an event handler to the "keypress" JavaScript event, or trigger that event on an element.
6140
6154
  * @param handler A function to execute each time the event is triggered.
6141
- * @see \`{@link https://api.jquery.com/keypress/ }\`
6155
+ * @see \`{@link https://api.jquery.com/keypress-shorthand/ }\`
6142
6156
  * @since 1.0
6143
6157
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
6144
6158
  *
6145
6159
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
6146
6160
  *
6147
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
6161
+ * **Solution**: Instead of `.keypress(fn)` use `.on("keypress", fn)`. Instead of `.keypress()` use `.trigger("keypress")`.
6148
6162
  * @example ​ ````Show the event object when a key is pressed in the input. Note: This demo relies on a simple $.print() plugin (https://api.jquery.com/resources/events.js) for the event object&#39;s output.
6149
6163
  ```html
6150
6164
  <!doctype html>
@@ -6221,7 +6235,7 @@ $( "#other" ).click(function() {
6221
6235
  *
6222
6236
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
6223
6237
  *
6224
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
6238
+ * **Solution**: Instead of `.keyup(fn)` use `.on("keyup", fn)`. Instead of `.keyup()` use `.trigger("keyup")`.
6225
6239
  */
6226
6240
  keyup<TData>(
6227
6241
  eventData: TData,
@@ -6236,7 +6250,7 @@ $( "#other" ).click(function() {
6236
6250
  *
6237
6251
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
6238
6252
  *
6239
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
6253
+ * **Solution**: Instead of `.keyup(fn)` use `.on("keyup", fn)`. Instead of `.keyup()` use `.trigger("keyup")`.
6240
6254
  * @example ​ ````Show the event object for the keyup handler (using a simple $.print plugin) when a key is released in the input.
6241
6255
  ```html
6242
6256
  <!doctype html>
@@ -6676,13 +6690,13 @@ $( "input" ).click(function() {
6676
6690
  * Bind an event handler to the "mousedown" JavaScript event, or trigger that event on an element.
6677
6691
  * @param eventData An object containing data that will be passed to the event handler.
6678
6692
  * @param handler A function to execute each time the event is triggered.
6679
- * @see \`{@link https://api.jquery.com/mousedown/ }\`
6693
+ * @see \`{@link https://api.jquery.com/mousedown-shorthand/ }\`
6680
6694
  * @since 1.4.3
6681
6695
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
6682
6696
  *
6683
6697
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
6684
6698
  *
6685
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
6699
+ * **Solution**: Instead of `.mousedown(fn)` use `.on("mousedown", fn)`. Instead of `.mousedown()` use `.trigger("mousedown")`.
6686
6700
  */
6687
6701
  mousedown<TData>(
6688
6702
  eventData: TData,
@@ -6691,13 +6705,13 @@ $( "input" ).click(function() {
6691
6705
  /**
6692
6706
  * Bind an event handler to the "mousedown" JavaScript event, or trigger that event on an element.
6693
6707
  * @param handler A function to execute each time the event is triggered.
6694
- * @see \`{@link https://api.jquery.com/mousedown/ }\`
6708
+ * @see \`{@link https://api.jquery.com/mousedown-shorthand/ }\`
6695
6709
  * @since 1.0
6696
6710
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
6697
6711
  *
6698
6712
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
6699
6713
  *
6700
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
6714
+ * **Solution**: Instead of `.mousedown(fn)` use `.on("mousedown", fn)`. Instead of `.mousedown()` use `.trigger("mousedown")`.
6701
6715
  * @example ​ ````Show texts when mouseup and mousedown event triggering.
6702
6716
  ```html
6703
6717
  <!doctype html>
@@ -6734,13 +6748,13 @@ $( "p" )
6734
6748
  * Bind an event handler to be fired when the mouse enters an element, or trigger that handler on an element.
6735
6749
  * @param eventData An object containing data that will be passed to the event handler.
6736
6750
  * @param handler A function to execute each time the event is triggered.
6737
- * @see \`{@link https://api.jquery.com/mouseenter/ }\`
6751
+ * @see \`{@link https://api.jquery.com/mouseenter-shorthand/ }\`
6738
6752
  * @since 1.4.3
6739
6753
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
6740
6754
  *
6741
6755
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
6742
6756
  *
6743
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
6757
+ * **Solution**: Instead of `.mouseenter(fn)` use `.on("mouseenter", fn)`. Instead of `.mouseenter()` use `.trigger("mouseenter")`.
6744
6758
  */
6745
6759
  mouseenter<TData>(
6746
6760
  eventData: TData,
@@ -6749,13 +6763,13 @@ $( "p" )
6749
6763
  /**
6750
6764
  * Bind an event handler to be fired when the mouse enters an element, or trigger that handler on an element.
6751
6765
  * @param handler A function to execute each time the event is triggered.
6752
- * @see \`{@link https://api.jquery.com/mouseenter/ }\`
6766
+ * @see \`{@link https://api.jquery.com/mouseenter-shorthand/ }\`
6753
6767
  * @since 1.0
6754
6768
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
6755
6769
  *
6756
6770
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
6757
6771
  *
6758
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
6772
+ * **Solution**: Instead of `.mouseenter(fn)` use `.on("mouseenter", fn)`. Instead of `.mouseenter()` use `.trigger("mouseenter")`.
6759
6773
  * @example ​ ````Show texts when mouseenter and mouseout event triggering.
6760
6774
  mouseover fires when the pointer moves into the child element as well, while mouseenter fires only when the pointer moves into the bound element.
6761
6775
  ```html
@@ -6835,13 +6849,13 @@ $( "div.enterleave" )
6835
6849
  * Bind an event handler to be fired when the mouse leaves an element, or trigger that handler on an element.
6836
6850
  * @param eventData An object containing data that will be passed to the event handler.
6837
6851
  * @param handler A function to execute each time the event is triggered.
6838
- * @see \`{@link https://api.jquery.com/mouseleave/ }\`
6852
+ * @see \`{@link https://api.jquery.com/mouseleave-shorthand/ }\`
6839
6853
  * @since 1.4.3
6840
6854
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
6841
6855
  *
6842
6856
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
6843
6857
  *
6844
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
6858
+ * **Solution**: Instead of `.mouseleave(fn)` use `.on("mouseleave", fn)`. Instead of `.mouseleave()` use `.trigger("mouseleave")`.
6845
6859
  */
6846
6860
  mouseleave<TData>(
6847
6861
  eventData: TData,
@@ -6850,13 +6864,13 @@ $( "div.enterleave" )
6850
6864
  /**
6851
6865
  * Bind an event handler to be fired when the mouse leaves an element, or trigger that handler on an element.
6852
6866
  * @param handler A function to execute each time the event is triggered.
6853
- * @see \`{@link https://api.jquery.com/mouseleave/ }\`
6867
+ * @see \`{@link https://api.jquery.com/mouseleave-shorthand/ }\`
6854
6868
  * @since 1.0
6855
6869
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
6856
6870
  *
6857
6871
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
6858
6872
  *
6859
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
6873
+ * **Solution**: Instead of `.mouseleave(fn)` use `.on("mouseleave", fn)`. Instead of `.mouseleave()` use `.trigger("mouseleave")`.
6860
6874
  * @example ​ ````Show number of times mouseout and mouseleave events are triggered. mouseout fires when the pointer moves out of child element as well, while mouseleave fires only when the pointer moves out of the bound element.
6861
6875
  ```html
6862
6876
  <!doctype html>
@@ -6934,13 +6948,13 @@ $( "div.enterleave" )
6934
6948
  * Bind an event handler to the "mousemove" JavaScript event, or trigger that event on an element.
6935
6949
  * @param eventData An object containing data that will be passed to the event handler.
6936
6950
  * @param handler A function to execute each time the event is triggered.
6937
- * @see \`{@link https://api.jquery.com/mousemove/ }\`
6951
+ * @see \`{@link https://api.jquery.com/mousemove-shorthand/ }\`
6938
6952
  * @since 1.4.3
6939
6953
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
6940
6954
  *
6941
6955
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
6942
6956
  *
6943
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
6957
+ * **Solution**: Instead of `.mousemove(fn)` use `.on("mousemove", fn)`. Instead of `.mousemove()` use `.trigger("mousemove")`.
6944
6958
  */
6945
6959
  mousemove<TData>(
6946
6960
  eventData: TData,
@@ -6949,13 +6963,13 @@ $( "div.enterleave" )
6949
6963
  /**
6950
6964
  * Bind an event handler to the "mousemove" JavaScript event, or trigger that event on an element.
6951
6965
  * @param handler A function to execute each time the event is triggered.
6952
- * @see \`{@link https://api.jquery.com/mousemove/ }\`
6966
+ * @see \`{@link https://api.jquery.com/mousemove-shorthand/ }\`
6953
6967
  * @since 1.0
6954
6968
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
6955
6969
  *
6956
6970
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
6957
6971
  *
6958
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
6972
+ * **Solution**: Instead of `.mousemove(fn)` use `.on("mousemove", fn)`. Instead of `.mousemove()` use `.trigger("mousemove")`.
6959
6973
  * @example ​ ````Show the mouse coordinates when the mouse is moved over the yellow div. Coordinates are relative to the window, which in this case is the iframe.
6960
6974
  ```html
6961
6975
  <!doctype html>
@@ -7018,13 +7032,13 @@ $( "div" ).mousemove(function( event ) {
7018
7032
  * Bind an event handler to the "mouseout" JavaScript event, or trigger that event on an element.
7019
7033
  * @param eventData An object containing data that will be passed to the event handler.
7020
7034
  * @param handler A function to execute each time the event is triggered.
7021
- * @see \`{@link https://api.jquery.com/mouseout/ }\`
7035
+ * @see \`{@link https://api.jquery.com/mouseout-shorthand/ }\`
7022
7036
  * @since 1.4.3
7023
7037
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
7024
7038
  *
7025
7039
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
7026
7040
  *
7027
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
7041
+ * **Solution**: Instead of `.mouseout(fn)` use `.on("mouseout", fn)`. Instead of `.mouseout()` use `.trigger("mouseout")`.
7028
7042
  */
7029
7043
  mouseout<TData>(
7030
7044
  eventData: TData,
@@ -7033,13 +7047,13 @@ $( "div" ).mousemove(function( event ) {
7033
7047
  /**
7034
7048
  * Bind an event handler to the "mouseout" JavaScript event, or trigger that event on an element.
7035
7049
  * @param handler A function to execute each time the event is triggered.
7036
- * @see \`{@link https://api.jquery.com/mouseout/ }\`
7050
+ * @see \`{@link https://api.jquery.com/mouseout-shorthand/ }\`
7037
7051
  * @since 1.0
7038
7052
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
7039
7053
  *
7040
7054
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
7041
7055
  *
7042
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
7056
+ * **Solution**: Instead of `.mouseout(fn)` use `.on("mouseout", fn)`. Instead of `.mouseout()` use `.trigger("mouseout")`.
7043
7057
  * @example ​ ````Show the number of times mouseout and mouseleave events are triggered.
7044
7058
  mouseout fires when the pointer moves out of the child element as well, while mouseleave fires only when the pointer moves out of the bound element.
7045
7059
  ```html
@@ -7119,13 +7133,13 @@ $( "div.enterleave" )
7119
7133
  * Bind an event handler to the "mouseover" JavaScript event, or trigger that event on an element.
7120
7134
  * @param eventData An object containing data that will be passed to the event handler.
7121
7135
  * @param handler A function to execute each time the event is triggered.
7122
- * @see \`{@link https://api.jquery.com/mouseover/ }\`
7136
+ * @see \`{@link https://api.jquery.com/mouseover-shorthand/ }\`
7123
7137
  * @since 1.4.3
7124
7138
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
7125
7139
  *
7126
7140
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
7127
7141
  *
7128
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
7142
+ * **Solution**: Instead of `.mouseover(fn)` use `.on("mouseover", fn)`. Instead of `.mouseover()` use `.trigger("mouseover")`.
7129
7143
  */
7130
7144
  mouseover<TData>(
7131
7145
  eventData: TData,
@@ -7134,13 +7148,13 @@ $( "div.enterleave" )
7134
7148
  /**
7135
7149
  * Bind an event handler to the "mouseover" JavaScript event, or trigger that event on an element.
7136
7150
  * @param handler A function to execute each time the event is triggered.
7137
- * @see \`{@link https://api.jquery.com/mouseover/ }\`
7151
+ * @see \`{@link https://api.jquery.com/mouseover-shorthand/ }\`
7138
7152
  * @since 1.0
7139
7153
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
7140
7154
  *
7141
7155
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
7142
7156
  *
7143
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
7157
+ * **Solution**: Instead of `.mouseover(fn)` use `.on("mouseover", fn)`. Instead of `.mouseover()` use `.trigger("mouseover")`.
7144
7158
  * @example ​ ````Show the number of times mouseover and mouseenter events are triggered.
7145
7159
  mouseover fires when the pointer moves into the child element as well, while mouseenter fires only when the pointer moves into the bound element.
7146
7160
  ```html
@@ -7220,13 +7234,13 @@ $( "div.enterleave" )
7220
7234
  * Bind an event handler to the "mouseup" JavaScript event, or trigger that event on an element.
7221
7235
  * @param eventData An object containing data that will be passed to the event handler.
7222
7236
  * @param handler A function to execute each time the event is triggered.
7223
- * @see \`{@link https://api.jquery.com/mouseup/ }\`
7237
+ * @see \`{@link https://api.jquery.com/mouseup-shorthand/ }\`
7224
7238
  * @since 1.4.3
7225
7239
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
7226
7240
  *
7227
7241
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
7228
7242
  *
7229
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
7243
+ * **Solution**: Instead of `.mouseup(fn)` use `.on("mouseup", fn)`. Instead of `.mouseup()` use `.trigger("mouseup")`.
7230
7244
  */
7231
7245
  mouseup<TData>(
7232
7246
  eventData: TData,
@@ -7235,13 +7249,13 @@ $( "div.enterleave" )
7235
7249
  /**
7236
7250
  * Bind an event handler to the "mouseup" JavaScript event, or trigger that event on an element.
7237
7251
  * @param handler A function to execute each time the event is triggered.
7238
- * @see \`{@link https://api.jquery.com/mouseup/ }\`
7252
+ * @see \`{@link https://api.jquery.com/mouseup-shorthand/ }\`
7239
7253
  * @since 1.0
7240
7254
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
7241
7255
  *
7242
7256
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
7243
7257
  *
7244
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
7258
+ * **Solution**: Instead of `.mouseup(fn)` use `.on("mouseup", fn)`. Instead of `.mouseup()` use `.trigger("mouseup")`.
7245
7259
  * @example ​ ````Show texts when mouseup and mousedown event triggering.
7246
7260
  ```html
7247
7261
  <!doctype html>
@@ -7333,7 +7347,10 @@ $( "p" ).next( ".selected" ).css( "background", "yellow" );
7333
7347
  </html>
7334
7348
  ```
7335
7349
  */
7336
- next(selector?: JQuery.Selector): this;
7350
+ next<K extends keyof HTMLElementTagNameMap>(selector: K): JQuery<HTMLElementTagNameMap[K]>;
7351
+ next<K extends keyof SVGElementTagNameMap>(selector: K): JQuery<SVGElementTagNameMap[K]>;
7352
+ // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
7353
+ next<E extends Element = HTMLElement>(selector?: JQuery.Selector): JQuery<E>;
7337
7354
  /**
7338
7355
  * Get all following siblings of each element in the set of matched elements, optionally filtered by a selector.
7339
7356
  * @param selector A string containing a selector expression to match elements against.
@@ -7414,7 +7431,10 @@ $( ":nth-child(1)" ).nextAll( "p" ).addClass( "after" );
7414
7431
  </html>
7415
7432
  ```
7416
7433
  */
7417
- nextAll(selector?: string): this;
7434
+ nextAll<K extends keyof HTMLElementTagNameMap>(selector: K): JQuery<HTMLElementTagNameMap[K]>;
7435
+ nextAll<K extends keyof SVGElementTagNameMap>(selector: K): JQuery<SVGElementTagNameMap[K]>;
7436
+ // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
7437
+ nextAll<E extends Element = HTMLElement>(selector?: JQuery.Selector): JQuery<E>;
7418
7438
  /**
7419
7439
  * Get all following siblings of each element up to but not including the element matched by the selector, DOM node, or jQuery object passed.
7420
7440
  * @param selector_element _&#x40;param_ `selector_element`
@@ -7465,7 +7485,19 @@ $( "#term-1" )
7465
7485
  </html>
7466
7486
  ```
7467
7487
  */
7468
- nextUntil(selector_element?: JQuery.Selector | Element | JQuery, filter?: JQuery.Selector): this;
7488
+ nextUntil<K extends keyof HTMLElementTagNameMap>(
7489
+ selector_element: JQuery.Selector | Element | JQuery,
7490
+ filter: K,
7491
+ ): JQuery<HTMLElementTagNameMap[K]>;
7492
+ nextUntil<K extends keyof SVGElementTagNameMap>(
7493
+ selector_element: JQuery.Selector | Element | JQuery,
7494
+ filter: K,
7495
+ ): JQuery<SVGElementTagNameMap[K]>;
7496
+ // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
7497
+ nextUntil<E extends Element = HTMLElement>(
7498
+ selector_element?: JQuery.Selector | Element | JQuery,
7499
+ filter?: JQuery.Selector,
7500
+ ): JQuery<E>;
7469
7501
  /**
7470
7502
  * Remove elements from the set of matched elements.
7471
7503
  * @param selector_function_selection _&#x40;param_ `selector_function_selection`
@@ -7839,7 +7871,7 @@ $( "*", document.body ).click(function( event ) {
7839
7871
  </html>
7840
7872
  ```
7841
7873
  */
7842
- offsetParent(): this;
7874
+ offsetParent(): JQuery;
7843
7875
  /**
7844
7876
  * Attach an event handler function for one or more events to the selected elements.
7845
7877
  * @param events One or more space-separated event types and optional namespaces, such as "click" or "keydown.myPlugin".
@@ -8819,7 +8851,10 @@ $( "p" ).parent( ".selected" ).css( "background", "yellow" );
8819
8851
  </html>
8820
8852
  ```
8821
8853
  */
8822
- parent(selector?: JQuery.Selector): this;
8854
+ parent<K extends keyof HTMLElementTagNameMap>(selector: K): JQuery<HTMLElementTagNameMap[K]>;
8855
+ parent<K extends keyof SVGElementTagNameMap>(selector: K): JQuery<SVGElementTagNameMap[K]>;
8856
+ // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
8857
+ parent<E extends Element = HTMLElement>(selector?: JQuery.Selector): JQuery<E>;
8823
8858
  /**
8824
8859
  * Get the ancestors of each element in the current set of matched elements, optionally filtered by a selector.
8825
8860
  * @param selector A string containing a selector expression to match elements against.
@@ -8934,7 +8969,7 @@ $( "span" ).click(function() {
8934
8969
  parents<K extends keyof HTMLElementTagNameMap>(selector: K | JQuery<K>): JQuery<HTMLElementTagNameMap[K]>;
8935
8970
  parents<K extends keyof SVGElementTagNameMap>(selector: K | JQuery<K>): JQuery<SVGElementTagNameMap[K]>;
8936
8971
  // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
8937
- parents<E extends HTMLElement>(selector?: JQuery.Selector): JQuery<E>;
8972
+ parents<E extends Element = HTMLElement>(selector?: JQuery.Selector): JQuery<E>;
8938
8973
  /**
8939
8974
  * Get the ancestors of each element in the current set of matched elements, up to but not including the element matched by the selector, DOM node, or jQuery object.
8940
8975
  * @param selector_element _&#x40;param_ `selector_element`
@@ -8988,7 +9023,19 @@ $( "li.item-2" )
8988
9023
  </html>
8989
9024
  ```
8990
9025
  */
8991
- parentsUntil(selector_element?: JQuery.Selector | Element | JQuery, filter?: JQuery.Selector): this;
9026
+ parentsUntil<K extends keyof HTMLElementTagNameMap>(
9027
+ selector_element: JQuery.Selector | Element | JQuery,
9028
+ filter: K,
9029
+ ): JQuery<HTMLElementTagNameMap[K]>;
9030
+ parentsUntil<K extends keyof SVGElementTagNameMap>(
9031
+ selector_element: JQuery.Selector | Element | JQuery,
9032
+ filter: K,
9033
+ ): JQuery<SVGElementTagNameMap[K]>;
9034
+ // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
9035
+ parentsUntil<E extends Element = HTMLElement>(
9036
+ selector_element?: JQuery.Selector | Element | JQuery,
9037
+ filter?: JQuery.Selector,
9038
+ ): JQuery<E>;
8992
9039
  /**
8993
9040
  * Get the current coordinates of the first element in the set of matched elements, relative to the offset parent.
8994
9041
  * @see \`{@link https://api.jquery.com/position/ }\`
@@ -9244,7 +9291,10 @@ $( "p" ).prev( ".selected" ).css( "background", "yellow" );
9244
9291
  </html>
9245
9292
  ```
9246
9293
  */
9247
- prev(selector?: JQuery.Selector): this;
9294
+ prev<K extends keyof HTMLElementTagNameMap>(selector: K): JQuery<HTMLElementTagNameMap[K]>;
9295
+ prev<K extends keyof SVGElementTagNameMap>(selector: K): JQuery<SVGElementTagNameMap[K]>;
9296
+ // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
9297
+ prev<E extends Element = HTMLElement>(selector?: JQuery.Selector): JQuery<E>;
9248
9298
  /**
9249
9299
  * Get all preceding siblings of each element in the set of matched elements, optionally filtered by a selector.
9250
9300
  * @param selector A string containing a selector expression to match elements against.
@@ -9287,7 +9337,10 @@ $( "div:last" ).prevAll().addClass( "before" );
9287
9337
  </html>
9288
9338
  ```
9289
9339
  */
9290
- prevAll(selector?: JQuery.Selector): this;
9340
+ prevAll<K extends keyof HTMLElementTagNameMap>(selector: K): JQuery<HTMLElementTagNameMap[K]>;
9341
+ prevAll<K extends keyof SVGElementTagNameMap>(selector: K): JQuery<SVGElementTagNameMap[K]>;
9342
+ // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
9343
+ prevAll<E extends Element = HTMLElement>(selector?: JQuery.Selector): JQuery<E>;
9291
9344
  /**
9292
9345
  * Get all preceding siblings of each element up to but not including the element matched by the selector, DOM node, or jQuery object.
9293
9346
  * @param selector_element _&#x40;param_ `selector_element`
@@ -9339,7 +9392,19 @@ $( "#term-3" ).prevUntil( term1, "dd" )
9339
9392
  </html>
9340
9393
  ```
9341
9394
  */
9342
- prevUntil(selector_element?: JQuery.Selector | Element | JQuery, filter?: JQuery.Selector): this;
9395
+ prevUntil<K extends keyof HTMLElementTagNameMap>(
9396
+ selector_element: JQuery.Selector | Element | JQuery,
9397
+ filter: K,
9398
+ ): JQuery<HTMLElementTagNameMap[K]>;
9399
+ prevUntil<K extends keyof SVGElementTagNameMap>(
9400
+ selector_element: JQuery.Selector | Element | JQuery,
9401
+ filter: K,
9402
+ ): JQuery<SVGElementTagNameMap[K]>;
9403
+ // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
9404
+ prevUntil<E extends Element = HTMLElement>(
9405
+ selector_element?: JQuery.Selector | Element | JQuery,
9406
+ filter?: JQuery.Selector,
9407
+ ): JQuery<E>;
9343
9408
  /**
9344
9409
  * Return a Promise object to observe when all actions of a certain type bound to the collection, queued or not, have finished.
9345
9410
  * @param type The type of queue that needs to be observed.
@@ -10341,13 +10406,13 @@ $( "button" ).on( "click", function() {
10341
10406
  * Bind an event handler to the "resize" JavaScript event, or trigger that event on an element.
10342
10407
  * @param eventData An object containing data that will be passed to the event handler.
10343
10408
  * @param handler A function to execute each time the event is triggered.
10344
- * @see \`{@link https://api.jquery.com/resize/ }\`
10409
+ * @see \`{@link https://api.jquery.com/resize-shorthand/ }\`
10345
10410
  * @since 1.4.3
10346
10411
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
10347
10412
  *
10348
10413
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
10349
10414
  *
10350
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
10415
+ * **Solution**: Instead of `.resize(fn)` use `.on("resize", fn)`. Instead of `.resize()` use `.trigger("resize")`.
10351
10416
  */
10352
10417
  resize<TData>(
10353
10418
  eventData: TData,
@@ -10356,13 +10421,13 @@ $( "button" ).on( "click", function() {
10356
10421
  /**
10357
10422
  * Bind an event handler to the "resize" JavaScript event, or trigger that event on an element.
10358
10423
  * @param handler A function to execute each time the event is triggered.
10359
- * @see \`{@link https://api.jquery.com/resize/ }\`
10424
+ * @see \`{@link https://api.jquery.com/resize-shorthand/ }\`
10360
10425
  * @since 1.0
10361
10426
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
10362
10427
  *
10363
10428
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
10364
10429
  *
10365
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
10430
+ * **Solution**: Instead of `.resize(fn)` use `.on("resize", fn)`. Instead of `.resize()` use `.trigger("resize")`.
10366
10431
  * @example ​ ````To see the window width while (or after) it is resized, try:
10367
10432
  ```javascript
10368
10433
  $( window ).resize(function() {
@@ -10379,13 +10444,13 @@ $( window ).resize(function() {
10379
10444
  * Bind an event handler to the "scroll" JavaScript event, or trigger that event on an element.
10380
10445
  * @param eventData An object containing data that will be passed to the event handler.
10381
10446
  * @param handler A function to execute each time the event is triggered.
10382
- * @see \`{@link https://api.jquery.com/scroll/ }\`
10447
+ * @see \`{@link https://api.jquery.com/scroll-shorthand/ }\`
10383
10448
  * @since 1.4.3
10384
10449
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
10385
10450
  *
10386
10451
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
10387
10452
  *
10388
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
10453
+ * **Solution**: Instead of `.scroll(fn)` use `.on("scroll", fn)`. Instead of `.scroll()` use `.trigger("scroll")`.
10389
10454
  */
10390
10455
  scroll<TData>(
10391
10456
  eventData: TData,
@@ -10394,13 +10459,13 @@ $( window ).resize(function() {
10394
10459
  /**
10395
10460
  * Bind an event handler to the "scroll" JavaScript event, or trigger that event on an element.
10396
10461
  * @param handler A function to execute each time the event is triggered.
10397
- * @see \`{@link https://api.jquery.com/scroll/ }\`
10462
+ * @see \`{@link https://api.jquery.com/scroll-shorthand/ }\`
10398
10463
  * @since 1.0
10399
10464
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
10400
10465
  *
10401
10466
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
10402
10467
  *
10403
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
10468
+ * **Solution**: Instead of `.scroll(fn)` use `.on("scroll", fn)`. Instead of `.scroll()` use `.trigger("scroll")`.
10404
10469
  * @example ​ ````To do something when your page is scrolled:
10405
10470
  ```html
10406
10471
  <!doctype html>
@@ -10609,13 +10674,13 @@ $( "p:last" ).text( "scrollTop:" + p.scrollTop() );
10609
10674
  * Bind an event handler to the "select" JavaScript event, or trigger that event on an element.
10610
10675
  * @param eventData An object containing data that will be passed to the event handler.
10611
10676
  * @param handler A function to execute each time the event is triggered.
10612
- * @see \`{@link https://api.jquery.com/select/ }\`
10677
+ * @see \`{@link https://api.jquery.com/select-shorthand/ }\`
10613
10678
  * @since 1.4.3
10614
10679
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
10615
10680
  *
10616
10681
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
10617
10682
  *
10618
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
10683
+ * **Solution**: Instead of `.select(fn)` use `.on("select", fn)`. Instead of `.select()` use `.trigger("select")`.
10619
10684
  */
10620
10685
  select<TData>(
10621
10686
  eventData: TData,
@@ -10624,13 +10689,13 @@ $( "p:last" ).text( "scrollTop:" + p.scrollTop() );
10624
10689
  /**
10625
10690
  * Bind an event handler to the "select" JavaScript event, or trigger that event on an element.
10626
10691
  * @param handler A function to execute each time the event is triggered.
10627
- * @see \`{@link https://api.jquery.com/select/ }\`
10692
+ * @see \`{@link https://api.jquery.com/select-shorthand/ }\`
10628
10693
  * @since 1.0
10629
10694
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
10630
10695
  *
10631
10696
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
10632
10697
  *
10633
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
10698
+ * **Solution**: Instead of `.select(fn)` use `.on("select", fn)`. Instead of `.select()` use `.trigger("select")`.
10634
10699
  * @example ​ ````To do something when text in input boxes is selected:
10635
10700
  ```html
10636
10701
  <!doctype html>
@@ -11068,7 +11133,10 @@ $( "p" ).siblings( ".selected" ).css( "background", "yellow" );
11068
11133
  </html>
11069
11134
  ```
11070
11135
  */
11071
- siblings(selector?: JQuery.Selector): this;
11136
+ siblings<K extends keyof HTMLElementTagNameMap>(selector: K): JQuery<HTMLElementTagNameMap[K]>;
11137
+ siblings<K extends keyof SVGElementTagNameMap>(selector: K): JQuery<SVGElementTagNameMap[K]>;
11138
+ // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
11139
+ siblings<E extends Element = HTMLElement>(selector?: JQuery.Selector): JQuery<E>;
11072
11140
  /**
11073
11141
  * Reduce the set of matched elements to a subset specified by a range of indices.
11074
11142
  * @param start An integer indicating the 0-based position at which the elements begin to be selected. If negative,
@@ -11655,13 +11723,13 @@ $( "#toggle" ).on( "click", function() {
11655
11723
  * Bind an event handler to the "submit" JavaScript event, or trigger that event on an element.
11656
11724
  * @param eventData An object containing data that will be passed to the event handler.
11657
11725
  * @param handler A function to execute each time the event is triggered.
11658
- * @see \`{@link https://api.jquery.com/submit/ }\`
11726
+ * @see \`{@link https://api.jquery.com/submit-shorthand/ }\`
11659
11727
  * @since 1.4.3
11660
11728
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
11661
11729
  *
11662
11730
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
11663
11731
  *
11664
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
11732
+ * **Solution**: Instead of `.submit(fn)` use `.on("submit", fn)`. Instead of `.submit()` use `.trigger("submit")`.
11665
11733
  */
11666
11734
  submit<TData>(
11667
11735
  eventData: TData,
@@ -11670,13 +11738,13 @@ $( "#toggle" ).on( "click", function() {
11670
11738
  /**
11671
11739
  * Bind an event handler to the "submit" JavaScript event, or trigger that event on an element.
11672
11740
  * @param handler A function to execute each time the event is triggered.
11673
- * @see \`{@link https://api.jquery.com/submit/ }\`
11741
+ * @see \`{@link https://api.jquery.com/submit-shorthand/ }\`
11674
11742
  * @since 1.0
11675
11743
  * @deprecated ​ Deprecated since 3.3. Use \`{@link on }\` or \`{@link trigger }\`.
11676
11744
  *
11677
11745
  * **Cause**: The `.on()` and `.trigger()` methods can set an event handler or generate an event for any event type, and should be used instead of the shortcut methods. This message also applies to the other event shorthands, including: blur, focus, focusin, focusout, resize, scroll, dblclick, mousedown, mouseup, mousemove, mouseover, mouseout, mouseenter, mouseleave, change, select, submit, keydown, keypress, keyup, and contextmenu.
11678
11746
  *
11679
- * **Solution**: Instead of `.click(fn)` use `.on("click", fn)`. Instead of `.click()` use `.trigger("click")`.
11747
+ * **Solution**: Instead of `.submit(fn)` use `.on("submit", fn)`. Instead of `.submit()` use `.trigger("submit")`.
11680
11748
  * @example ​ ````If you&#39;d like to prevent forms from being submitted unless a flag variable is set, try:
11681
11749
  ```html
11682
11750
  <!doctype html>
jquery/README.md CHANGED
@@ -8,7 +8,7 @@ This package contains type definitions for jquery (https://jquery.com).
8
8
  Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/jquery.
9
9
 
10
10
  ### Additional Details
11
- * Last updated: Wed, 22 Nov 2023 00:24:48 GMT
11
+ * Last updated: Wed, 25 Sep 2024 19:19:36 GMT
12
12
  * Dependencies: [@types/sizzle](https://npmjs.com/package/@types/sizzle)
13
13
 
14
14
  # Credits
jquery/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@types/jquery",
3
- "version": "3.5.29",
3
+ "version": "3.5.31",
4
4
  "description": "TypeScript definitions for jquery",
5
5
  "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/jquery",
6
6
  "license": "MIT",
@@ -127,6 +127,6 @@
127
127
  "dependencies": {
128
128
  "@types/sizzle": "*"
129
129
  },
130
- "typesPublisherContentHash": "c3055dbf38935d6cab1eb0b3a8774efc077599ff8bad2539e061404145a6c310",
131
- "typeScriptVersion": "4.5"
130
+ "typesPublisherContentHash": "6cfdf9b26cfe360ba66dfb7ed330168ae7a66b3ab3cc613ee135d7a5f424f09b",
131
+ "typeScriptVersion": "4.8"
132
132
  }