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.