Sanitizer: phương thức setDataAttributes()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Phương thức setDataAttributes() của giao diện Sanitizer đặt liệu tất cả các thuộc tính data-* có được phép bởi bộ làm sạch, hay chúng phải được chỉ định riêng lẻ.
Nếu được đặt true, các thuộc tính dữ liệu được tự động cho phép và bạn không nên thêm chúng riêng lẻ bằng Sanitizer.allowAttribute() (hoặc Sanitizer.allowElement() cho các thuộc tính cục bộ).
Lưu ý rằng phương thức này hữu ích cho cấu hình cho phép có nhiều thuộc tính data-* mà bạn muốn cho phép.
Phương thức trả về false khi dùng với các cấu hình xóa, vốn có thể cho phép tất cả các thuộc tính data-* chỉ đơn giản bằng cách bỏ qua chúng.
Cú pháp
setDataAttributes(allow);
Tham số
allow-
truenếu tất cả các thuộc tínhdata-*được phép, vàfalsenếu chúng phải được chỉ định rõ ràng.
Giá trị trả về
true nếu thao tác thay đổi cấu hình, và false nếu cấu hình đã đặt dataAttributes theo giá trị được chỉ định hoặc dataAttributes không thể được đặt true vì bộ làm sạch này có cấu hình xóa.
Ví dụ
>Sử dụng cơ bản
Mã dưới đây cho thấy cách sử dụng cơ bản của phương thức setDataAttributes().
// Tạo bộ làm sạch (trong trường hợp này là mặc định)
const sanitizer = new Sanitizer();
// Cho phép tất cả thuộc tính data-*
sanitizer.setDataAttributes(true);
// Thuộc tính data-* được cho phép bằng cách thêm chúng
// vào mảng attributes
sanitizer.setDataAttributes(false);
Thông số kỹ thuật
| Specification |
|---|
| HTML Sanitizer API> # dom-sanitizer-setdataattributes> |