HTMLElement: sự kiện command
Baseline
2025
Newly available
Since December 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Sự kiện command của giao diện HTMLElement được kích hoạt trên một phần tử được điều khiển thông qua một button với các giá trị commandForElement và command hợp lệ, bất cứ khi nào nút được tương tác (ví dụ: khi nó được nhấp).
Cú pháp
Sử dụng tên sự kiện trong các phương thức như addEventListener(), hoặc thiết lập một thuộc tính trình xử lý sự kiện.
addEventListener("command", (event) => { })
oncommand = (event) => { }
Kiểu sự kiện
Một CommandEvent. Kế thừa từ Event.
Ví dụ
Ví dụ cơ bản
const popover = document.getElementById("mypopover");
// …
popover.addEventListener("command", (event) => {
if (event.command === "show-popover") {
console.log("Popover sắp được hiển thị");
}
});
Phân phối và hủy sự kiện
Cần lưu ý rằng các sự kiện command được kích hoạt trên phần tử được gọi. Nếu nút được nhấp, trước tiên nó sẽ phân phối một sự kiện click, nếu bị hủy thì sự kiện command sẽ không được kích hoạt và hành vi mặc định sẽ không được chạy.
Ngoài việc hủy sự kiện click trên nút, cũng có thể hủy sự kiện command.
Ví dụ:
button.addEventListener("click", (event) => {
event.preventDefault(); // sự kiện `command` sẽ không bao giờ được kích hoạt
});
element.addEventListener("command", (event) => {
event.preventDefault(); // sự kiện `command` được kích hoạt nhưng hành vi mặc định bị hủy
});
Đặc tả kỹ thuật
| Specification |
|---|
| HTML # event-command |