ElementInternals: ariaFlowToElements property

Baseline 2025
Newly available

Since April 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

The ariaFlowToElements property of the ElementInternals interface is an array containing the element (or elements) that provide an alternate reading order of content, overriding the general default reading order at the user's discretion. If just one element is provided this is the next element in the reading order. If multiple elements are provided, then each element represents a possible path that should be offered to the user for selection.

The aria-flowto topic contains additional information about how the attribute and property should be used.

Value

An array of subclasses of HTMLElement.

When read, the returned array is a static and read-only. When written, the assigned array is copied: subsequent changes to the array do not affect the value of the property.

Description

The property is a flexible alternative to using the aria-flowto attribute to set an alternative reading order. Unlike aria-flowto, the elements assigned to this property do not have to have an id attribute.

The property reflects the element's aria-flowto attribute when it is defined, but only for listed reference id values that match valid in-scope elements. If the property is set, then the corresponding attribute is cleared. For more information about reflected element references and scope see Reflected element references in the Reflected attributes guide.

Examples

The examples in the following documents are relevant:

  • Element.ariaFlowToElements is the DOM equivalent of this property. It is used in the same way, but within the DOM instead of a shadow DOM and/or custom element.

Specifications

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariaflowtoelements

Browser compatibility

See also