ARIA: thuộc tính aria-readonly

Thuộc tính aria-readonly cho biết rằng phần tử không thể chỉnh sửa, nhưng vẫn có thể thao tác.

Mô tả

Khi bạn muốn cho biết rằng một phần tử tương tác vẫn hoạt động nhưng không thể chỉnh sửa, hãy đặt aria-readonly="true". Điều này cho người dùng biết rằng một phần tử tương tác vốn thường có thể focus và sao chép đã được đặt vào trạng thái chỉ đọc, không phải vô hiệu hóa.

Khi aria-readonly được đặt thành true, điều đó có nghĩa là người dùng có thể đọc nhưng không thể đặt giá trị của widget. Các phần tử chỉ đọc vẫn có liên quan với người dùng, vì vậy bạn không nên chặn người dùng điều hướng đến phần tử đó hoặc các phần tử con có thể focus của nó, cũng như không nên chặn việc sao chép giá trị.

Ví dụ gồm:

  • Các trường biểu mẫu không nên thay đổi.
  • Tiêu đề hàng và cột trong bảng tính.
  • Tổng giá trị trong giỏ hàng.

Nếu giá trị không thể thay đổi không nên nhận focus, hãy dùng aria-disabled thay thế.

Note: Khi dùng các form control HTML ngữ nghĩa, nếu bạn đặt thuộc tính readonly, bạn không cần thêm aria-readonly="true".

Note: Giá trị của <input type="checkbox"> không thể chỉnh sửa, nên readonly không còn liên quan. Tuy nhiên, khi tạo checkbox bằng role="checkbox" thì thuộc tính aria-readonly được hỗ trợ.

Giá trị

true

Phần tử là chỉ đọc.

false (mặc định)

Phần tử không phải chỉ đọc.

Giao diện liên quan

Element.ariaReadOnly

Thuộc tính ariaReadOnly, thuộc giao diện Element, phản ánh giá trị của thuộc tính aria-readonly.

ElementInternals.ariaReadOnly

Thuộc tính ariaReadOnly, thuộc giao diện ElementInternals, phản ánh giá trị của thuộc tính aria-readonly.

Vai trò liên quan

Được dùng trong các vai trò:

Kế thừa vào các vai trò:

Thông số kỹ thuật

Specification
Accessible Rich Internet Applications (WAI-ARIA)
# aria-readonly

Xem thêm