KeyboardLayoutMap

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.

Giao diện KeyboardLayoutMap của Keyboard API là một đối tượng chỉ đọc với các hàm để lấy chuỗi liên kết với các phím vật lý cụ thể.

Phiên bản KeyboardLayoutMap là một đối tượng giống Map chỉ đọc, trong đó mỗi khóa là một chuỗi xác định phím vật lý duy nhất trên bàn phím (một "mã phím"), và giá trị tương ứng là giá trị thuộc tính phím liên kết (có thể bị ảnh hưởng bởi bố cục bàn phím, v.v.).

Danh sách các phím hợp lệ có thể tìm thấy trong đặc tả UI Events KeyboardEvent code Values.

Thuộc tính phiên bản

KeyboardLayoutMap.size Read only Experimental

Trả về số phần tử trong đối tượng KeyboardLayoutMap.

Phương thức phiên bản

KeyboardLayoutMap[Symbol.iterator]() Experimental

Trả về một đối tượng Iterator mới chứa các cặp khóa/giá trị.

KeyboardLayoutMap.entries() Experimental

Trả về một đối tượng Iterator mới chứa các cặp khóa/giá trị.

KeyboardLayoutMap.forEach() Experimental

Thực thi hàm được cung cấp một lần cho mỗi phần tử của KeyboardLayoutMap.

KeyboardLayoutMap.get() Experimental

Trả về phần tử có khóa đã cho từ đối tượng KeyboardLayoutMap.

KeyboardLayoutMap.has() Experimental

Trả về giá trị boolean cho biết liệu đối tượng KeyboardLayoutMap có phần tử với khóa đã chỉ định hay không.

KeyboardLayoutMap.keys() Experimental

Trả về một đối tượng Iterator mới chứa các khóa cho mỗi chỉ mục trong đối tượng KeyboardLayoutMap.

KeyboardLayoutMap.values() Experimental

Trả về một đối tượng Iterator mới chứa các giá trị cho mỗi chỉ mục trong đối tượng KeyboardLayoutMap.

Ví dụ

Ví dụ sau minh họa cách lấy chuỗi theo vị trí hoặc bố cục cụ thể liên kết với mã bàn phím tương ứng với phím 'W' trên bàn phím QWERTY tiếng Anh.

js
navigator.keyboard.getLayoutMap().then((keyboardLayoutMap) => {
  const upKey = keyboardLayoutMap.get("KeyW");
  window.alert(`Press ${upKey} to move up.`);
});

Thông số kỹ thuật

Specification
Keyboard Map
# keyboardlayoutmap-interface

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