元素: ariaReadOnly 属性

基线 2023

新可用

自 2023 年 10 月起，此功能在最新的设备和浏览器版本中有效。此功能可能在较旧的设备或浏览器中无法正常工作。

ariaReadOnly 是 Element 接口的属性，它反映 aria-readonly 属性的值，表示该元素不可编辑，但可以进行其他操作。

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

值

以下值之一的字符串

"true"

用户无法更改元素的值。

"false"

用户可以设置元素的值。

示例

在这个例子中，aria-readonly 属性在 ID 为 txtBoxInput 的元素上设置为 "true"，表示该输入当前为只读。使用 ariaReadOnly，我们将值更新为 "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-readonly="true"></div>
js
let el = document.getElementById("txtBoxInput");
console.log(el.ariaReadOnly); // "true"
el.ariaReadOnly = "false";
console.log(el.ariaReadOnly); // "false"

规范

规范
可访问的富互联网应用 (WAI-ARIA)
# dom-ariamixin-ariareadonly

浏览器兼容性

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

另请参阅