aria-readonly

aria-readonly 屬性指示元素不可編輯,但其他方面可操作。

描述

當您想要指示互動式元素可工作但不可編輯時,請設定 aria-readonly="true"。這會向用戶指示通常可聚焦和可複製的互動式元素已置於只讀(未停用)狀態。

aria-readonly 設定為 true 時,表示使用者可以讀取但不能設定小部件的值。只讀元素仍然與使用者相關,因此您不應阻止使用者導航到該元素或其可聚焦的後代或複製值。

示例包括

  • 不應更改的表單元素。
  • 電子表格中的行和列標題。
  • 購物車中的總值。

如果不可更改的值不能接收焦點,請改用 aria-disabled

注意:使用語義 HTML 表單控制元件時,如果設定了 readonly 屬性,則無需包含 aria-readonly="true"

注意:<input type="checkbox"> 的值無法編輯,因此 readonly 不相關。但是,當使用 role="checkbox" 建立複選框時,支援 aria-readonly 屬性。

true

元素為只讀。

false(預設值)

元素不為只讀。

關聯介面

Element.ariaReadOnly

ariaReadOnly 屬性是 Element 介面的一部分,它反映了 aria-readonly 屬性的值。

ElementInternals.ariaReadOnly

ariaReadOnly 屬性是 ElementInternals 介面的一部分,它反映了 aria-readonly 屬性的值。

關聯角色

規範

規範
可訪問的富網際網路應用程式 (WAI-ARIA)
# aria-readonly

另請參閱