Keyboard
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Giao diện Keyboard của Keyboard API cung cấp các hàm để truy xuất bản đồ bố cục bàn phím và bật/tắt chụp các lần nhấn phím từ bàn phím vật lý.
Danh sách các giá trị code hợp lệ được tìm thấy trong thông số kỹ thuật UI Events KeyboardEvent code Values.
Thuộc tính phiên bản
Cũng kế thừa các thuộc tính từ giao diện cha, EventTarget.
Phương thức phiên bản
Cũng kế thừa các phương thức từ giao diện cha, EventTarget.
Keyboard.getLayoutMap()Experimental-
Trả về một
Promisephân giải với một phiên bản củaKeyboardLayoutMap, là một đối tượng dạng bản đồ với các hàm để truy xuất các chuỗi liên quan đến các phím vật lý cụ thể. Keyboard.lock()Experimental-
Trả về một
Promisephân giải sau khi bật tính năng chụp các lần nhấn phím cho bất kỳ hoặc tất cả các phím trên bàn phím vật lý. Keyboard.unlock()Experimental-
Mở khóa tất cả các phím đã bị chụp bởi phương thức
lock()và trả về đồng bộ.
Ví dụ
>Ánh xạ bàn phím
Ví dụ sau minh họa cách lấy chuỗi theo vị trí hoặc bố cục cụ thể liên quan đến phím tương ứng với phím 'W' trên bàn phím QWERTY tiếng Anh.
if (navigator.keyboard) {
const keyboard = navigator.keyboard;
keyboard.getLayoutMap().then((keyboardLayoutMap) => {
const upKey = keyboardLayoutMap.get("KeyW");
window.alert(`Press ${upKey} to move up.`);
});
} else {
// Do something else.
}
Khóa bàn phím
Ví dụ sau chụp các phím W, A, S và D, gọi lock() với danh sách chứa giá trị thuộc tính code của mỗi phím:
navigator.keyboard.lock(["KeyW", "KeyA", "KeyS", "KeyD"]);
Thao tác này chụp các phím này bất kể phím bổ trợ nào được sử dụng cùng. Giả sử bố cục QWERTY Hoa Kỳ tiêu chuẩn, đăng ký KeyW đảm bảo rằng W, Shift+W, Control+W, Control+Shift+W và tất cả các tổ hợp phím bổ trợ khác với W đều được gửi đến ứng dụng. Tương tự cho KeyA, KeyS và KeyD.
Thông số kỹ thuật
| Specification |
|---|
| Keyboard Map> # keyboard-interface> |
| Keyboard Lock> # keyboard-interface> |