WinJS.UI.XYFocus

Article
01/26/2017

Provides an API for managing the focus given to an HTML element based on the use of an input device. This API is not used to implement Keyboard Navigation using the tabindex attribute of an HTML element.

The WinJS.UI.XYFocus namespace has these types of members:

CSS classes
Properties
Functions
Events

CSS classes

CSS class	Description
win-focusable	Marks an element as focusable.

Properties

Property	Description
focusRoot property	Gets or sets the element that is the focus root for the XYFocus system.
keyCodeMap property	Gets or sets an object that specifies the key codes used to move between focusable HTML elements.

Functions

Function	Description
findNextFocusElement function	Finds the next element that should receive focus in the specified direction. This function does not actually move the current focus.
moveFocus function	This function moves focus to the next element that should receive focus.

Events

Event	Description
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.
focuschanged event	Raised when XYFocus has successfully changed focus. The HTMLElement.focus method does not trigger this event.

Requirements

Minimum WinJS version	WinJS 3.0
Namespace	WinJS.UI

Share via