DOMTokenList: phương thức add()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Phương thức add() của giao diện DOMTokenList thêm các token đã cho vào danh sách, bỏ qua những token đã tồn tại.
Cú pháp
add(token1)
add(token1, token2)
add(token1, token2, /* …, */ tokenN)
Tham số
tokenN-
Một chuỗi biểu thị token (hoặc các token) cần thêm vào
DOMTokenList.
Giá trị trả về
Không có.
Ngoại lệ
SyntaxErrorDOMException-
Được ném ra nếu một trong các đối số là chuỗi rỗng.
InvalidCharacterErrorDOMException-
Được ném ra nếu token chứa khoảng trắng ASCII.
Ví dụ
Trong ví dụ sau, chúng ta lấy danh sách các lớp được đặt trên một phần tử <span> dưới dạng DOMTokenList, bằng Element.classList.
Sau đó chúng ta thêm một token mới vào danh sách, rồi ghi danh sách vào Node.textContent của thẻ <span>.
Trước hết là HTML:
<span class="a b c"></span>
Bây giờ là JavaScript:
const span = document.querySelector("span");
const classes = span.classList;
classes.add("d");
span.textContent = classes;
Kết quả sẽ như sau:
Bạn cũng có thể thêm nhiều token cùng lúc:
span.classList.add("d", "e", "f");
Thông số kỹ thuật
| Specification |
|---|
| DOM # ref-for-dom-domtokenlist-add① |