元素：ariaRequired 属性

基线 2023

新可用

自 2023 年 10 月起，此功能在最新的设备和浏览器版本中均可使用。此功能可能无法在较旧的设备或浏览器中使用。

ariaRequired 属性是 Element 接口的属性，它反映了 aria-required 属性的值，该属性表示在提交表单之前，必须在元素上提供用户输入。

注意： 尽可能使用带有 type="text" 的 HTML <input> 元素或 <textarea> 元素，因为它们具有内置语义，不需要 ARIA 属性。

值

具有以下值之一的字符串

"true"

用户需要在提交表单之前在元素上提供输入。

"false"

用户输入不是提交表单的必要条件。

示例

在本例中，ID 为 txtBoxInput 的元素上的 aria-required 属性设置为 "true"，表示必须完成此输入。使用 ariaRequired，我们将值更新为 "false"。

html
<div id="txtboxMultilineLabel">Enter the tags for the article</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"

规范

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

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅