.focusin( handler )Returns: jQuery
Description: Bind an event handler to the "focusin" event.
-
version added: 1.4.focusin( handler )
- handlerA function to execute each time the event is triggered.
-
-
version added: 1.4.3.focusin( [eventData ], handler )
- eventDataType: AnythingAn object containing data that will be passed to the event handler.
- handlerA function to execute each time the event is triggered.
-
-
version added: 1.0.focusin()
- This signature does not accept any arguments.
This method is a shortcut for .on( "focusin", handler )
in the first two variations, and .trigger( "focusin" )
in the third.
The focusin
event is sent to an element when it, or any element inside of it, gains focus. This is distinct from the focus event in that it supports detecting the focus event on parent elements (in other words, it supports event bubbling).
This event will likely be used together with the focusout event.
Additional Notes:
- As the
.focusin()
method is just a shorthand for.on( "focusin", handler )
, detaching is possible using.off( "focusin" )
.
Example:
Watch for a focus to occur within the paragraphs on the page.
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <title>focusin demo</title> <style> span { display: none; } </style> <script src="https://code.jquery.com/jquery-3.5.0.js"></script> </head> <body> <p><input type="text"> <span>focusin fire</span></p> <p><input type="password"> <span>focusin fire</span></p> <script> $( "p" ).focusin(function() { $( this ).find( "span" ).css( "display", "inline" ).fadeOut( 1000 ); }); </script> </body> </html>