🔗ally.query.tabbable
Finds keyboard focusable ("tabbable") elements in the DOM.
🔗Description
See ally.query.focusable
for an explanation on the different query strategies.
Consult the data tables what browsers consider focusable and what ally.js considers focusable in strategy: "strict"
or strategy: "quick"
to learn how HTML elements behave.
🔗Usage
var elements = ally.query.tabbable({
context: '.within-filter-selector',
includeContext: true,
strategy: 'quick',
});
🔗Arguments
Name | Type | Default | Description |
---|---|---|---|
context | <selector> | documentElement | The scope of the DOM in which to search. The first element of a collection is used. |
includeContext | boolean | false | Prepend the context element if it is focusable. |
strategy | "quick" , "strict" , "all" | "quick" | The approach used to find elements. |
🔗Returns
Array of HTMLElement
.
🔗Examples
🔗Example: ally.query.focusable Example
ally.query.focusable Example on jsbin.complay with the example on jsbin.com or open the source document
🔗Example: ally.query.tabbable Example
ally.query.tabbable Example on jsbin.complay with the example on jsbin.com or open the source document
🔗Notes
🔗Related resources
ally.is.tabbable
is used to filter focusable elementsally.query.focusable
is used to find focusable elementsally.query.firstTabbable
finds the first keyboard focusable element in a contextally.query.tabsequence
finds keyboard focusable elements in Sequential Navigation Focus Order