HTMLAllCollection
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Giao diện HTMLAllCollection đại diện cho một tập hợp gồm tất cả các phần tử trong tài liệu, có thể truy cập theo chỉ mục (như mảng) và theo thuộc tính id của phần tử. Nó được trả về bởi thuộc tính document.all.
HTMLAllCollection có hình dạng rất giống với HTMLCollection, nhưng có nhiều sự khác biệt hành vi tinh tế, ví dụ như HTMLAllCollection có thể được gọi như một hàm, và phương thức item() của nó có thể được gọi với một chuỗi đại diện cho thuộc tính id hoặc name của phần tử.
Thuộc tính phiên bản
HTMLAllCollection.lengthRead only-
Trả về số lượng phần tử trong tập hợp.
Phương thức phiên bản
HTMLAllCollection.item()-
Trả về phần tử nằm tại vị trí offset được chỉ định trong tập hợp, hoặc phần tử có giá trị khớp với thuộc tính
idhoặcname. Trả vềnullnếu không tìm thấy phần tử nào. HTMLAllCollection.namedItem()-
Trả về phần tử đầu tiên trong tập hợp có thuộc tính
idhoặcnamekhớp với tên chuỗi đã cho, hoặcnullnếu không có phần tử nào khớp.
Sử dụng trong JavaScript
Truy cập theo chỉ mục
Ngoài các phương thức trên, các phần tử trong HTMLAllCollection có thể được truy cập bằng chỉ mục số nguyên và tên thuộc tính chuỗi. Thuộc tính id HTML có thể chứa : và . là các ký tự hợp lệ, điều này đòi hỏi phải sử dụng ký hiệu ngoặc để truy cập thuộc tính. collection[i] tương đương với collection.item(i), trong đó i có thể là số nguyên, chuỗi chứa số nguyên, hoặc chuỗi đại diện cho id.
Gọi như một hàm
Một đối tượng HTMLAllCollection có thể gọi được. Khi nó được gọi không có tham số hoặc với undefined, nó trả về null. Nếu không, nó trả về cùng giá trị với phương thức item() khi được cung cấp các tham số giống nhau.
Hành vi chuyển đổi kiểu đặc biệt
Vì lý do lịch sử, document.all là một đối tượng hoạt động giống như undefined theo các cách sau:
- Nó bằng lỏng lẻo với
undefinedvànull. - Nó là giá trị falsy trong ngữ cảnh boolean.
typeofcủa nó là"undefined".
Những hành vi đặc biệt này đảm bảo rằng mã như:
if (document.all) {
// Assume that we are in IE; provide special logic
}
// Assume that we are in a modern browser
Sẽ tiếp tục cung cấp hành vi hiện đại ngay cả khi mã chạy trong trình duyệt triển khai document.all vì lý do tương thích.
Tuy nhiên, trong tất cả các ngữ cảnh khác, document.all vẫn là một đối tượng. Ví dụ:
- Nó không bằng nghiêm ngặt với
undefinedhaynull. - Khi được sử dụng ở phía bên trái của toán tử kết hợp nullish (
??) hay toán tử chuỗi tùy chọn (?.), nó sẽ không khiến biểu thức bị đoản mạch.
Thông số kỹ thuật
| Specification |
|---|
| HTML # the-htmlallcollection-interface |