ARIA: thuộc tính aria-checked

Mô tả

Thuộc tính aria-checked cho biết phần tử đang được chọn (true), chưa được chọn (false), hoặc trạng thái được chọn là không xác định (mixed), nghĩa là nó không phải đã chọn cũng không phải chưa chọn. Giá trị mixed được hỗ trợ bởi các vai trò đầu vào ba trạng thái của checkbox và menuitemcheckbox.

Giá trị mixed không được hỗ trợ trên radio, menuitemradio, hoặc switch và các phần tử kế thừa từ chúng. Giá trị sẽ là false nếu mixed được đặt khi không được hỗ trợ.

<span
  role="checkbox"
  id="checkBoxInput"
  aria-checked="false"
  tabindex="0"
  aria-labelledby="chk15-label"></span>
<label id="chk15-label">Đăng ký nhận bản tin</label>

Thuộc tính tabindex là bắt buộc để cho phép nhận tiêu điểm. JavaScript là bắt buộc để chuyển đổi trạng thái aria-checked. Và nếu checkbox này là một phần của biểu mẫu có thể gửi, cần thêm JavaScript để đặt tên và giá trị.

Đoạn trên có thể được viết lại thành:

<input type="checkbox" id="chk15-label" name="Subscribe" />
<label for="chk15-label">Đăng ký nhận bản tin</label>

Bằng cách dùng phần tử <input> với type="checkbox" thay vì ARIA, bạn không cần JavaScript nào.

Giá trị

false

Phần tử hỗ trợ được chọn nhưng hiện chưa được chọn.

true

Phần tử đã được chọn.

mixed

Chỉ dành cho checkbox và menuitemcheckbox, tương đương với indeterminate, biểu thị giá trị hỗn hợp, không phải đã chọn cũng không phải chưa chọn.

undefined (mặc định)

Phần tử không hỗ trợ được chọn.

Vai trò liên quan

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

• checkbox
• menuitemcheckbox
• menuitemradio
• option
• radio
• switch

Giao diện liên quan

Element.ariaChecked

Thuộc tính ariaChecked, là một phần của giao diện Element, phản ánh giá trị của thuộc tính aria-checked.

ElementInternals.ariaChecked

Thuộc tính ariaChecked, là một phần của giao diện ElementInternals, phản ánh giá trị của thuộc tính aria-checked.

myHTMLElement.ariaChecked = true;

Đặc tả

Xem thêm

• <input type="checkbox">
• <input type="radio">
• aria-pressed
• aria-selected
• Ví dụ checkbox hai trạng thái - w3.org
• Ví dụ checkbox ba trạng thái - w3.org