ARIA: aria-readonly 屬性

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

描述

當您想表明一個互動式元素可以工作但不可編輯時,請將 aria-readonly="true" 設定為 true。這會向用戶表明,一個通常可以獲得焦點並可複製內容的互動式元素已被置於只讀(非停用)狀態。

aria-readonly 設定為 true 時,意味著使用者可以讀取小部件的值,但不能設定。只讀元素對使用者仍然很重要,因此您不應阻止使用者導航到該元素或其可聚焦的後代元素,也不應阻止使用者複製其值。

示例包括

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

如果不可更改的值不應能夠獲得焦點,請改用 aria-disabled

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

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

true

該元素是隻讀的。

false(預設)

該元素不是隻讀的。

相關介面

Element.ariaReadOnly

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

ElementInternals.ariaReadOnly

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

相關角色

用於角色

繼承到角色

規範

規範
無障礙富網際網路應用程式 (WAI-ARIA)
# aria-readonly

另見