ElementInternals: ariaOwnsElements property
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
The ariaOwnsElements property of the ElementInternals interface is an array containing the element (or elements) that define a visual, functional, or contextual relationship between a parent element that it is applied to, and its child elements.
This is used when the shadow DOM hierarchy cannot be used to represent the relationship, and it would not otherwise be available to assistive technology,
The aria-owns 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-owns attribute to indicate ownership of an element.
Unlike aria-owns, the elements assigned to this property do not have to have an id attribute.
The property reflects the element's aria-owns 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.ariaOwnsElementsis 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-ariaownselements |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
ariaOwnsElements
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
See also
aria-ownsattributeElement.ariaOwnsElements- Reflected element references in the Attribute reflection guide.