此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

Element:ariaRequired 属性

基线
广泛可用

自 2023年10月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

Element 接口的 ariaRequired 属性反映 aria-required 属性的值,指示在提交表单前该元素上需要用户输入。

备注:应尽可能使用 type="text" 的 HTML <input> 元素或 <textarea>,因为它们内置语义,无需 ARIA 属性。

具有以下值之一的字符串:

  • "true"
    • :用户需要在提交表单前为该元素提供输入。
  • "false"
    • :提交表单不需要用户输入。

示例

此示例中,ID 为 txtBoxInput 的元素上的 aria-required 属性设为 "true",表示必须填写该输入。使用 ariaRequired 将其更新为 "false"

html
<div id="txtboxMultilineLabel">输入文章的标签</div>
<div
  role="textbox"
  id="txtBoxInput"
  contenteditable="true"
  aria-multiline="true"
  aria-labelledby="txtboxMultilineLabel"
  aria-required="true"></div>
js
let el = document.getElementById("txtBoxInput");
console.log(el.ariaRequired); // "true"
el.ariaRequired = "false";
console.log(el.ariaRequired); // "false"

规范

规范
Accessible Rich Internet Applications (WAI-ARIA)
# dom-ariamixin-ariarequired

浏览器兼容性

参见