Interface FocusControls

Controls that move focus inside a focus scope.

interface FocusControls {
    focusDown(options?: UnorderedFocusOptions): boolean;
    focusFirst(options?: OrderedFocusOptions): boolean;
    focusLast(options?: OrderedFocusOptions): boolean;
    focusLeft(options?: UnorderedFocusOptions): boolean;
    focusNext(options?: OrderedFocusOptions): boolean;
    focusPrevious(options?: OrderedFocusOptions): boolean;
    focusRight(options?: UnorderedFocusOptions): boolean;
    focusUp(options?: UnorderedFocusOptions): boolean;
    hasFocus(): boolean;
    isActive(): boolean;
}

Index

Methods

focusDown focusFirst focusLast focusLeft focusNext focusPrevious focusRight focusUp hasFocus isActive

Methods

focusDown

focusDown(options?: UnorderedFocusOptions): boolean
If the scope contains the currently focused element, moves focus to the closest focusable element below it.
Parameters
- Optionaloptions: UnorderedFocusOptions
  Focus options.
Returns boolean
true if an element was focused.

focusFirst

focusFirst(options?: OrderedFocusOptions): boolean
Focuses the first focusable element inside a focus scope.
Parameters
- Optionaloptions: OrderedFocusOptions
  Focus options.
Returns boolean
true if an element was focused.

focusLast

focusLast(options?: OrderedFocusOptions): boolean
Focuses the last focusable element inside a focus scope.
Parameters
- Optionaloptions: OrderedFocusOptions
  Focus options.
Returns boolean
true if an element was focused.

focusLeft

focusLeft(options?: UnorderedFocusOptions): boolean
If the scope contains the currently focused element, moves focus to the closest focusable element to the left.
Parameters
- Optionaloptions: UnorderedFocusOptions
  Focus options.
Returns boolean
true if an element was focused.

focusNext

focusNext(options?: OrderedFocusOptions): boolean
If the scope contains the currently focused element, focuses the next element in Tab order.
Parameters
- Optionaloptions: OrderedFocusOptions
  Focus options.
Returns boolean
true if an element was focused.

focusPrevious

focusPrevious(options?: OrderedFocusOptions): boolean
If the scope contains the currently focused element, focuses the previous element in Tab order.
Parameters
- Optionaloptions: OrderedFocusOptions
  Focus options.
Returns boolean
true if an element was focused.

focusRight

focusRight(options?: UnorderedFocusOptions): boolean
If the scope contains the currently focused element, moves focus to the closest focusable element to the right.
Parameters
- Optionaloptions: UnorderedFocusOptions
  Focus options.
Returns boolean
true if an element was focused.

focusUp

focusUp(options?: UnorderedFocusOptions): boolean
If the scope contains the currently focused element, moves focus to the closest focusable element above it.
Parameters
- Optionaloptions: UnorderedFocusOptions
  Focus options.
Returns boolean
true if an element was focused.

hasFocus

hasFocus(): boolean
Returns true if the currently focused element is contained within the scope container.

Returns boolean

isActive

isActive(): boolean
Returns true if the scope contains the focused element, or if the scope is part of an active focus trap.

Returns boolean