Share via


WinJS.UI.XYFocus.focuschanging event

Raised before XYFocus changes focus. The HTMLElement.focus method does not trigger this event. When you handle this event, can use preventDefault to cancel the focus change.

Syntax

function handler(eventInfo) { /* Your code */ }
 
// addEventListener syntax
winJS.UI.XYFocus.addEventListener("focuschanging", handler);
winJS.UI.XYFocus.removeEventListener("focuschanging", handler);

Event information

Synchronous No
Bubbles Yes
Cancelable Yes

 

Event handler parameters

  • eventInfo
    Type: CustomEvent**

    An object that contains information about the event. The detail property of this object contains the following sub-properties:

    • detail.nextFocusElement
      Type: HTMLElement

      The element to receive focus.

    • detail.keyCode
      Type: Number

      The key code that triggered the focus change.

Remarks

After the moveFocus() function has been called, the focuschanging event fires. Once the new element has focus, the focuschanged event fires.

Requirements

Minimum WinJS version

WinJS 3.0

Namespace

WinJS.UI.XYFocus

See also

WinJS.UI.XYFocus