ElementInternals: ariaErrorMessageElements property
MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونهکد
{{APIRef("DOM")}}
The **ariaErrorMessageElements** property of the {{domxref("ElementInternals")}} interface is an array containing the element (or elements) that provide an error message for the element it is applied to.
The [aria-errormessage](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-errormessage) topic contains additional information about how the attribute and property should be used.
Value
An array of subclasses of {{domxref("HTMLElement")}}. The inner text of these elements can be joined with spaces to get the error message.
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-errormessage](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-errormessage) attribute to set the error message for an element. Unlike aria-errormessage, 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 element's [aria-errormessage](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-errormessage) 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:
- {{domxref("Element.ariaErrorMessageElements")}} 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
{{Specifications}}
Browser compatibility
{{Compat}}
See also
- [
aria-errormessage](/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-errormessage) attribute - {{domxref("Element.ariaErrorMessageElements")}}
- Reflected element references in the _Attribute reflection_ guide.