输入事件 第 1 级

本文档描述了与编辑相关的两个事件的扩展 —— input 和 beforeinput，它们在 UI 事件规范中有详细说明 [UI-EVENTS]。这些事件的目标是允许开发者在编辑发生前后理解和/或覆盖默认的编辑行为。

DataTransfer

DataTransfer 对象为某些输入类型包含富文本和纯文本数据。 [HTML]

表达意图

用户可以通过键盘、输入法、语音或类似方式 表达意图 来执行特定的编辑操作。具体的输入操作遵循平台特定的约定映射到意图。

kill buffer

此定义不是规范性的。

kill buffer 是一个内存中的富文本内容存储，与剪贴板分开，允许临时存储通过特定删除命令删除的内容。用户可以通过表达意图来用 kill buffer 中的内容替换当前选择，表达意图时会 yank kill buffer 的内容。

字符

字符 是一个 扩展字素簇。[UAX29]

本节为非规范性。

创建基于网页的文本编辑器需要在浏览器代码之外编写大量的 JavaScript，原因包括：

1. 浏览器对某些编辑操作的处理方式并不一致。
2. 浏览器在处理某些编辑操作时往往会出现漏洞。
3. 各个网站可能会有自己处理某些编辑操作的自定义偏好。
4. 浏览器中的高级文本编辑功能开发并没有遵循 可扩展 Web 宣言 的原则，即这些功能的开发并不总是与 Web 开发者社区的需求协调进行。

本规范旨在通过提供一种简单的方法来缓解这一问题，允许 Web 开发者通过 beforeinput 事件覆盖浏览器对所有与文本编辑相关的用户输入的处理，并通过 input 事件监控浏览器因用户输入而在 DOM 中的更改。

本节为非规范性。

1. 创建一个 JavaScript 文本编辑器，其中使用 <strong> 标签代替 <b> 标签来标记用户标记为加粗的文本，使用任何浏览器内置的方式加粗文本，而不需要访问所有现有的浏览器。
2. 创建一个 JavaScript 文本编辑器，该编辑器在后台使用数据模型，并由 JavaScript 负责将编辑文本的更改渲染到 DOM。
3. 创建一个 JavaScript 编辑器，该编辑器只允许富文本编辑的某个子集（例如：允许加粗，但不允许斜体）。
4. 创建一个协作编辑器，JavaScript 用于根据用户意图渲染 DOM 中的更改，用户使用不同的浏览器以不同的方式表达特定的意图。
5. 创建一个具有不同用户访问选项的 JavaScript 编辑器，其中一些用户只能添加或删除文本，另一些用户只能添加或删除某些类型的格式。

在用户尝试编辑标记时，输入事件会在操作之前（beforeinput 事件）和之后（input 事件）发送。这包括内容的插入和删除，以及格式更改。

输入事件会在作为编辑主机的元素上 调度 [UI-EVENTS]，这些元素包括设置了 contenteditable 属性的元素、textarea 元素，以及允许文本输入的 input 元素。

WebIDL

partial interface InputEvent {
       readonly attribute DataTransfer? dataTransfer;
       sequence<StaticRange> getTargetRanges();
    };
    
    partial dictionary InputEventInit {
       DataTransfer? dataTransfer = null;
       sequence<StaticRange> targetRanges = [];
    };

本节不具规范性。

除了现有事件（如 keydown 和 keypress [UI-EVENTS] 事件）已经可用的 指纹识别 [fingerprinting-guidance] 技术之外，此功能没有已知的安全或隐私影响。

如果该功能替代了现有的事件，它可能 导致可用的 指纹识别 [fingerprinting-guidance] 技术减少，因为用户的意图被记录，而不是他们使用的硬件类型来 表达 这种意图。

感谢: Michael Aufreiter, Adrian Bateman, Oliver Buchtala, Robin Berjon, Enrica Casucci, Bo Cupp, Domenic Denicola, Emil Eklund, Olivier Forget, Aryeh Gregor, Marijn Haverbeke, Yoshifumi Inoue, Koji Ishii, Gary Kacmarcik, Ian Kilpatrick, Frederico Caldeira Knabben, Takayoshi Kochi, Piotrek Koszuliński, Travis Leithead, Grisha Lyukshin, Miles Maxfield, Chaals McCathie Nevile, Masayuki Nakano, Ryosuke Niwa, Julie Parent, Ben Peters, Florian Rivoal, Morgan Smith, Hallvord R. M. Steen, Johan Sörlin, Cristian Talau, Dave Tapuska, Ojan Vafai, Léonie Watson, Xiaoqian Wu, Chong Zhang, Joanmarie, 以及所有参与编辑任务组的成员们，感谢你们的贡献和反馈。