ElementInternals: ariaErrorMessageElements 属性

基准线 2025
新推出

自 ⁨2025 年 4 月⁩起,此功能适用于最新设备和浏览器版本。此功能可能不适用于较旧的设备或浏览器。

ElementInternals 接口的 ariaErrorMessageElements 属性是一个数组,其中包含为应用了它的元素提供错误消息的元素(一个或多个)。

有关该属性和值的用法,请参阅 aria-errormessage 主题。

一个 HTMLElement 的子类的数组。这些元素的内部文本可以与空格连接起来以获取错误消息。

读取时,返回的数组是静态的且只读的。写入时,将复制分配的数组:之后对数组的更改不会影响属性的值。

描述

此属性是使用 aria-errormessage 属性为元素设置错误消息的灵活替代方案。与 aria-errormessage 不同,分配给此属性的元素不必具有 id 属性。

当定义了元素的 aria-errormessage 属性时,此属性会反映该属性,但仅限于已列出的、匹配有效范围内元素的引用 id 值。如果设置了此属性,则对应的属性会被清除。有关反射的元素引用和范围的更多信息,请参阅反射属性指南中的 Reflected element references

示例

以下文档中的示例是相关的

  • Element.ariaErrorMessageElements 是此属性的 DOM 等效项。它的用法相同,但在 DOM 中而不是在 Shadow DOM 和/或自定义元素中使用。

规范

规范
无障碍富互联网应用程序 (WAI-ARIA)
# dom-ariamixin-ariaerrormessageelements

浏览器兼容性

另见