用户界面事件键盘事件 key 属性实现报告(UI Events KeyboardEvent key Implementation Report)

1. 简介

[UIEvents-Key] 规范定义了一组可在 key 属性中使用的有效值集合。

本文档总结了 key 属性及其值的当前实现状态。

测试了每个用户代理的以下版本:

• Google Chrome 60.0.3112.113 (Windows 10, OS X 10.12.2, Ubuntu)

• Mozilla Firefox 55.0 (Windows 10, OS X 10.12.2, Ubuntu)

• Microsoft Edge 83.0.478.58 (Windows 10)

• Apple Safari 13.1.1 (OS X 10.14.6)

2. 测试方法

由于没有自动的方法来测试这些按键事件(特别是考虑到通常需要国际键盘)， 这些测试都是手动进行的。

此属性( key )有两种必需值: 未命名(Unnamed)和已命名(Name)。

• 未命名的值可以是任何有效的可打印的 Unicode 字符。由于这些值的数量非常大， 因此测试每一个可能的值是不现实的。替代方案是，对63个最常见的键进行抽样测试。

• 有38个必需的命名值，它们都是手动测试的。

手动测试是通过访问 domeeventviewer.com/key-event-viewer.html 测试页面并在按下测试键后检查"key"列来执行的。 要测试仅存在于特定地区键盘上的键(如"AltGraph")， 需要使用包含被测试键的键盘。

就本报告而言，Chrome、Firefox和Safari被视为独立的实现。

3. 结果

3.1. 总结

在至少2个独立的实现中对 key 属性 通过(Pass) 的所有63个采样的未命名值(sampled Unnamed)和所有38个必需的命名值 (Named required values)进行了手动测试。

候选推荐标准的校验准则因此完全满足 (The Candidate Recommendation exit criteria are therefore fulfilled)

此外，本文档描述了一些可选名称值(optional Named values)， 这些可选值在支持多媒体或遗留键盘上被使用。其中， 手动测试证实其中39个在至少2个独立的实现中通过。

3.2. 原始结果

下表显示了手动测试的结果。

当按下相应的键时，标记为"通过(Pass)"的条目将生成预期值。

当按下相应的键时，标记为"失败(Fail)"的条目会生成一些预期值以外的值。 在可能的情况下，表格项会给出一个注释，提供有关失败的更多信息。

标有"?"的条目尚未经过测试，通常是因为带有该键的设备不可用 (例如，因为带有这些键的键盘在该平台上不受支持)。

3.2.1. key 属性

key (在[UIEvents]中定义) 存在于所有测试的浏览器中。

3.2.2. 必需的未命名键(Required Unnamed Keys)

key 属性可以包含任何区域设置中的可以由任何键生成的任何字符 ，因此尝试枚举所有可能包含的值超出了本文档的范围。

本节提供基本类型的采样键，并确定用户代理是否大概支持这些键。

3.2.3. 必需的命名键(Required Named Keys)

本节列出了与标准键盘布局生成的值相对应的命名键属性值的基本集合。

3.2.4. 可选的编辑命名键(Optional Editing Named Keys)

由于这些值中的一些值依赖于特定的键盘，因此不期望用户代理支持所有这些值。

3.2.5. 可选的设备特定的命名键(Optional Device-specific Named Keys)

本节列出了与专用键盘上的键生成的值相对应的命名键属性值，例如:

• 多媒体键盘

• 支持特殊输入法的键盘

• 远程控制设备(遥控器)

由于这些值具有设备特定的性质，预计用户代理不会支持所有这些值

4. 鸣谢

特别感谢 Masayuki Nakano (Mozilla) 收集了一些实现数据(本文档中使用了) ——特别是与 IMEs 和(输入)组成相关的数据。