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.

EventTarget Keyboard

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 Promise phân giải với một phiên bản của KeyboardLayoutMap, 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 Promise phâ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.

js
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, SD, gọi lock() với danh sách chứa giá trị thuộc tính code của mỗi phím:

js
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, KeySKeyD.

Thông số kỹ thuật

Specification
Keyboard Map
# keyboard-interface
Keyboard Lock
# keyboard-interface

Tương thích trình duyệt