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.sizeRead 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
KeyboardLayoutMapcó 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.
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> |