Element: ariaErrorMessageElements 属性
Element 接口的 ariaErrorMessageElements 属性是一个数组,其中包含为应用了该属性的元素提供错误消息的元素(或元素)。
有关该属性和属性应如何使用的更多信息,请参阅 aria-errormessage 主题。
值
一个 HTMLElement 的子类数组。这些元素的内部文本可以与空格连接起来以获取错误消息。
读取时,返回的数组是静态的且只读的。写入时,将复制分配的数组:之后对数组的更改不会影响属性的值。
描述
该属性是使用 aria-errormessage 属性为元素设置错误消息的灵活替代方案。与 aria-errormessage 不同,分配给此属性的元素不必具有 id 属性。
当 aria-errormessage 属性被定义时,该属性会反映元素的 aria-errormessage 属性,但仅限于已列出且匹配有效作用域内元素的 ID 值。如果设置了该属性,则相应的属性会被清除。有关反射元素引用和作用域的更多信息,请参阅反射属性指南中的 反射元素引用。
示例
带错误消息的电子邮件输入
本示例演示了我们如何使用 aria-errormessage 为输入无效电子邮件地址设置错误消息,并演示了如何使用 ariaErrorMessageElements 获取和设置消息。
HTML
首先,我们定义一个 HTML 电子邮件输入,将其 aria-errormessage 属性设置为引用 ID 为 err1 的元素。然后,我们定义一个具有此 ID 的 <span> 元素,其中包含一条错误消息。
CSS
我们创建了一些样式,默认隐藏错误消息,但在元素的 aria-invalid 属性设置为 true 时使其可见并显示为错误样式。
JavaScript
然后,我们检查输入,并根据 typeMismatch 约束 violation 将 ariaInvalid 设置为 true 或 false。ariaInvalid 反过来会被反映在 aria-invalid 属性中,该属性会根据需要隐藏和显示错误。
然后,我们记录 aria-errormessage 属性的值、ariaErrorMessageElements 以及 ariaErrorMessageElements 的内部文本。
结果
当您输入电子邮件地址时,错误文本将显示出来,直到电子邮件地址有效为止。请注意,日志显示了从属性读取的错误消息引用、ariaErrorMessageElements 中的元素以及该元素的内部文本,即其错误消息。
规范
| 规范 |
|---|
| 无障碍富互联网应用程序 (WAI-ARIA) # dom-ariamixin-ariaerrormessageelements |
浏览器兼容性
加载中…
另见
aria-errormessage属性ElementInternals.ariaErrorMessageElements- Attribute reflection 指南中的Reflected element references。