activeDescendant
- Number
Node, or index of the Node, representing the descendant that is either
focused or is focusable (tabIndex
attribute is set to 0).
The value cannot represent a disabled descendant Node. Use a value of -1
to remove all descendant Nodes from the default tab flow.
If no value is specified, the active descendant will be inferred using
the following criteria:
- Examining the
tabIndex
attribute of each descendant and using the first descendant whosetabIndex
attribute is set to 0 - If no default can be inferred then the value is set to either 0 or the index of the first enabled descendant.
circular
- Boolean
Boolean indicating if focus should be set to the first/last descendant
when the end or beginning of the descendants has been reached.
descendants
- Y.NodeList
String representing the CSS selector used to define the descendant Nodes
whose focus should be managed.
focusClass
- String|Object
String representing the name of class applied to the focused active
descendant Node. Can also be an object literal used to define both the
class name, and the Node to which the class should be applied. If using
an object literal, the format is:
{ className: "focus", fn: myFunction }
. The function
referenced by the fn
property in the object literal will be
passed a reference to the currently focused active descendant Node.
keys
- Object
Object literal representing the keys to be used to navigate between the
next/previous descendant. The format for the attribute's value is
{ next: "down:40", previous: "down:38" }
. The value for the
"next" and "previous" properties are used to attach
key
event listeners. See
the Using the key Event section of
the Event documentation for more information on "key" event listeners.