Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

[zh-CN]: add translation for KeyboardLayoutMap #23855

Merged
merged 2 commits into from
Oct 7, 2024
Merged

[zh-CN]: add translation for KeyboardLayoutMap #23855

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f55ded8
add
skyclouds2001 Sep 30, 2024
05f33b8
Apply suggestions from code review
jasonren0403 Oct 7, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
55 changes: 55 additions & 0 deletions files/zh-cn/web/api/keyboardlayoutmap/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
---
title: KeyboardLayoutMap
slug: Web/API/KeyboardLayoutMap
l10n:
sourceCommit: e92950d09467164afc9dfd8b35be9c909b63a8ab
---

{{SeeCompatTable}}{{APIRef("Keyboard API")}}

{{domxref("Keyboard API", "", "", "nocode")}} 的 **`KeyboardLayoutMap`** 接口是一个只读对象，具有检索与特定物理按键关联的字符串的功能。

`KeyboardLayoutMap` 实例是一个只读的[类 `Map` 对象](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Map#类_map_浏览器_api)，其中每个按键都是一个字符串，用于标识键盘上唯一的物理按键（“按键代码”），相应的值是关联的按键属性值（可能受键盘布局等影响）。

在 [UI 事件 KeyboardEvent 代码值](https://www.w3.org/TR/uievents-code/#key-alphanumeric-writing-system)规范中可以找到有效按键的列表。

## 实例属性

- {{domxref('KeyboardLayoutMap.size')}} {{ReadOnlyInline}} {{experimental_inline}}
- : 返回 `KeyboardLayoutMap` 对象中的元素数量。

## 实例方法

- `KeyboardLayoutMap[Symbol.iterator]()` {{experimental_inline}}
- : 返回一个包含键/值对的新 [Iterator](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Iterator) 对象。
- {{domxref('KeyboardLayoutMap.entries()')}} {{experimental_inline}}
- : 返回一个包含键/值对的新 [Iterator](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Iterator) 对象。
- {{domxref('KeyboardLayoutMap.forEach()')}} {{experimental_inline}}
- : 为 `KeyboardLayoutMap` 的每个元素执行一次提供的函数。
- {{domxref('KeyboardLayoutMap.get()')}} {{experimental_inline}}
- : 从 `KeyboardLayoutMap` 对象返回具有给定键的元素。
- {{domxref('KeyboardLayoutMap.has()')}} {{experimental_inline}}
- : 返回一个布尔值，指示 `KeyboardLayoutMap` 对象是否具有带指定键的元素。
- {{domxref('KeyboardLayoutMap.keys()')}} {{experimental_inline}}
- : 返回一个新的 [Iterator](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Iterator) 对象，该对象包含 `KeyboardLayoutMap` 对象中每个索引的键。
- {{domxref('KeyboardLayoutMap.values()')}} {{experimental_inline}}
- : 返回一个新的 [Iterator](/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Iterator) 对象，该对象包含 `KeyboardLayoutMap` 对象中每个索引的值。

## 示例

以下示例说明如何获取与英语 QWERTY 键盘上“W”键对应的键盘代码关联的位置或布局特定字符串。

```js
navigator.keyboard.getLayoutMap().then((keyboardLayoutMap) => {
const upKey = keyboardLayoutMap.get("KeyW");
window.alert(`按 ${upKey} 向上移动。`);
});
```

## 规范

{{Specifications}}

## 浏览器兼容性

{{Compat}}