Partager via


WinJS.UI.XYFocus

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

See also

Quickstart: Adding WinJS controls

tabindex attribute| tabindex property