ElementInternals: ariaControlsElements property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("DOM")}}
The **ariaControlsElements** property of the {{domxref("ElementInternals")}} interface is an array containing the element (or elements) that are controlled by the element it is applied to. For example, this might be set on a combobox to indicate the element that it pops up, or on a [scrollbar](/en-US/docs/Web/Accessibility/ARIA/Reference/Roles/scrollbar_role) to indicate the ID of the element it controls.
The [aria-controls](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-controls) topic contains additional information about how the attribute and property should be used.
Value
An array of subclasses of {{domxref("HTMLElement")}}, representing the elements that are controlled by this element.
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-controls](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-controls) attribute to set the controlled elements. Unlike aria-controls, the elements assigned to this property do not have to have an [id](/en-US/docs/Web/HTML/Reference/Global_attributes/id) attribute.
The property reflects the [aria-controls](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-controls) 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.
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- [
aria-controls](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-controls) attribute - {{domxref("Element.ariaControlsElements")}}
- Reflected element references in the _Attribute reflection_ guide