WinJS.UI.XYFocus.focuschanging event

Article
01/26/2017

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

Partager via