Navigator: phương thức setAppBadge()
Khả dụng hạn chế
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Phương thức setAppBadge() của giao diện Navigator đặt huy hiệu trên biểu tượng được liên kết với ứng dụng này. Nếu một giá trị được truyền vào phương thức thì giá trị này sẽ được đặt làm giá trị của huy hiệu. Nếu không, huy hiệu sẽ hiển thị dưới dạng dấu chấm hoặc chỉ báo khác do nền tảng xác định.
Cú pháp
setAppBadge()
setAppBadge(contents)
Thông số
contentsOptional-
numbersẽ được sử dụng làm giá trị của huy hiệu. Nếucontentslà0thì huy hiệu sẽ được đặt thànhnothing, cho biết huy hiệu đã được xóa.
Giá trị trả về
Ngoại lệ
InvalidStateErrorDOMException-
Bỏ đi nếu tài liệu không được kích hoạt đầy đủ.
SecurityErrorDOMException-
Bị hủy nếu cuộc gọi bị same-origin policy chặn.
NotAllowedErrorDOMException-
Bị ném nếu
PermissionStatus.statekhông phảigranted.
Ví dụ
Trong ví dụ bên dưới, số lượng chưa đọc được chuyển tới setAppBadge(). Khi đó huy hiệu sẽ hiển thị 30.
const unread = 30;
navigator.setAppBadge(unread);
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| Badging API # setappbadge-method |