Search.../

onFocus( )

Adds an event handler that runs when the element receives focus.

Description

An element receives focus through user actions, such as clicking and tabbing, or programmatically, using the focus( ) function.

Note: onFocus() has no effect when applied to RadioButtonGroup elements.

Deprecation note: The $w parameter of event handlers is being deprecated. To get a scoped selector for working with elements in repeater items, use the $w.at() function and pass it the context property of the event parameter: $item = $w.at(event.context). To learn more, see here.

Syntax

function onFocus(handler: EventHandler): Element
handler: function EventHandler(event: Event, $w: $w): void

onFocus Parameters

NAME
TYPE
DESCRIPTION
handler

EventHandler

The name of the function or the function expression to run when the element receives focus.

Returns

The element on which the event is now registered.

Return Type:

EventHandler Parameters

NAME
TYPE
DESCRIPTION
event

Event

The event that occurred.

$w

$w

Deprecated: A selector function. The $w function was used to enable event handlers to work with elements in repeaters. Now, to get a scoped selector for working with repeater items, use the $w.at() function and pass it the context property of the event parameter: $item = $w.at(event.context).

Returns

This function does not return anything.

Return Type:

void
Mixed in from:$w.FocusMixin

Related Content:

Was this helpful?

Get the ID of the element that has received focus

Code Example

Copy Code
1$w("#myElement").onFocus( (event) => {
2 let targetId = event.target.id; // "myElement"
3});