ButtonLinkAutocompleteList Class
The ButtonLinkAutocompleteList class provides functionality for showing a list of items that can be selected for the link.
Index
Methods
- _getFocusAction
- _getFocusDismissAction
- _getFocusMoveDirection
- _isValidKey
- _moveFocus
- _refresh
- _renderAutocompleteItems
- _updateItems
- componentDidMount
- componentDidUpdate
- componentWillReceiveProps
- componentWillUnmount
- focus
- getDefaultProps
- getInitialState
- handleKey
- moveFocus
- render
- shouldComponentUpdate
Properties
Methods
_getFocusAction
-
event
Returns the action, if any, that a keyboard event in the current focus manager state should produce.
Parameters:
-
eventObjectThe Keyboard event.
Returns:
An action object with type and direction properties.
_getFocusDismissAction
-
event -
focusMoveDirection
Returns the dismiss action, if any, the focus manager should execute to yield the focus. This will happen in any of these scenarios if a dismiss callback has been specified:
- A dismiss key has been pressed
- In a non-circular focus manager, when:
- The active descendant is the first one and a prev key has been pressed.
- The active descendant is the last one and a next key has been pressed.
Parameters:
-
eventObjectThe Keyboard event.
-
focusMoveDirectionNumberThe focus movement direction (if any).
Returns:
A dismiss action with dismiss and direction properties.
_getFocusMoveDirection
-
event
Returns the direction, if any, in which the focus should be moved. In presence of the shift key modifier, the direction of the movement is inverted.
Parameters:
-
eventObjectThe Keyboard event.
Returns:
The computed direction of the expected focus movement.
_isValidKey
-
keyCode -
keys
Indicates if a given keyCode is valid for the given set of keys.
Parameters:
-
keyCodeNumberAn event keyCode.
-
keysArray | NumberA key set. Can be a number an array of numbers representing the allowed keyCodes.
Returns:
A boolean value indicating if the key is valid.
_moveFocus
-
direction
Moves the focus among descendants in the especified direction.
Parameters:
-
directionNumberThe direction (1 or -1) of the focus movement among descendants.
_refresh
()
protected
Refreshes the descendants list by executing the CSS selector again and resets the descendants tabIndex.
_renderAutocompleteItems
-
items
Renders a set of list items for the provided items
Parameters:
-
itemsArrayList of autocomplete items to render
Returns:
Rendered list item instances
_updateItems
()
protected
Retrieves the data according to {this.props.term} and calls setState() with the returned data
componentDidMount
()
Lifecycle. Invoked once, only on the client, immediately after the initial rendering occurs.
componentDidUpdate
()
Lifecycle. Invoked immediately after the component's updates are flushed to the DOM. Refreshes the descendants list.
componentWillReceiveProps
()
Lifecycle. Invoked when a component is receiving new props. This method is not called for the initial render.
componentWillUnmount
()
Lifecycle. Invoked immediately before a component is unmounted from the DOM.
focus
()
Focuses the current active descendant.
Several Widgets can be nested in a component hierarchy by attaching this focus method to the widget DOM node, transferring the DOM focus control to the inner FocusManager.
getDefaultProps
()
Object
Lifecycle. Returns the default values of the properties used in the widget.
Returns:
The default properties.
getInitialState
()
Lifecycle. Invoked once before the component is mounted. The return value will be used as the initial value of this.state.
handleKey
-
event
Handles the key events on a DOM node to execute the appropriate navigation when needed.
Parameters:
-
eventObjectThe Keyboard event that was detected on the widget DOM node.
moveFocus
-
direction
Moves the focus among descendants in the especified direction.
Parameters:
-
directionNumberThe direction (1 or -1) of the focus movement among descendants.
render
()
Object
Lifecycle. Renders the UI of the list.
Returns:
The content which should be rendered.
shouldComponentUpdate
()
Boolean
Lifecycle. Invoked before rendering when new props or state are being received. This method is not called for the initial render or when forceUpdate is used.
Returns:
Returns false when the transition to the new props and state will not require a component update.
Properties
autocompleteSelected
Boolean
Indicates if this is focused when this component is updated
circular
Boolean
Indicates if focus should be set to the first/last descendant when the limits are reached.
data
Function
Autocomplete function
descendants
String
String representing the CSS selector used to define the elements that should be handled.
focusFirstChild
Boolean
Indicate if should focus the first child of a container
key
String
static
The name which will be used as an alias of the button in the configuration.
Default: buttonLinkAutocompleteList
keys
Object
Object representing the keys used to navigate between descendants. The format for the prop is:
{dismiss: value, dismissNext: value, dismissPrev: value, next: value, prev: value} where
value can be both a number or an array of numbers with the allowed keyCodes.
onDismiss
Function
Callback method to be invoked when the focus manager is to be dismissed. This happens in the following scenarios if a dismiss callback has been specified:
- A dismiss key has been pressed
- In a non-circular focus manager, when:
- The active descendant is the first one and a prev key has been pressed.
- The active descendant is the last one and a next key has been pressed.
setAutocompleteState
Function
Method to update parent selectautocomplete state
term
String
The current term to autocomplete for