输入事件规范 第2级

本文档描述了与编辑相关的两个事件的扩展 - input 和 beforeinput，这些事件在 UI 事件规范中进行了描述 [UI-EVENTS]。这些事件的目的是允许开发者理解和/或覆盖编辑行为的默认处理，编辑操作在执行前或执行后。

除标记为非规范性的章节外，本规范中的所有作者指南、图表、示例和注释均为非规范性内容。其他所有内容均为规范性内容。

本文档中的关键词 MAY、MUST 和 MUST NOT 应按照 BCP 14 [RFC2119] [RFC8174] 的说明进行解释，仅当这些词以如上所示全部大写形式出现时，才按上述定义解释。

表达意图

用户可以通过键盘、输入法（IME）、语音或类似方法表达执行特定编辑操作的意图。特定的输入操作根据平台特定的约定映射为意图。

杀死缓冲区

此定义为非规范性内容。

杀死缓冲区 是一个与剪贴板分开的内存存储区域，用于暂存通过特定删除命令删除的富文本内容。用户可以通过表达“提取杀死缓冲区”的意图，将杀死缓冲区中的内容替换当前选中的内容。

本节为非规范性内容。

创建一个基于Web的文本编辑器需要在浏览器代码之上编写大量的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事件）发送。这包括内容的插入和删除，以及格式更改。

输入事件会在作为 编辑主机（editing hosts） 的元素上分派，包括设置了 contenteditable 属性的元素、textarea 元素，以及允许文本输入的 input 元素。

WebIDLpartial interface InputEvent {
   readonly attribute DataTransfer? dataTransfer;
   sequence<StaticRange> getTargetRanges();
};

partial dictionary InputEventInit {
   DataTransfer? dataTransfer = null;
   sequence<StaticRange> targetRanges = [];
};

合成的开始通过调度 compositionstart 事件标记。

在合成会话期间，每当文本合成系统更新其活动文本段落时，都会调度 compositionupdate 事件。

在每个 compositionupdate 事件之后，会调度一对 beforeinput 和 input 事件。 beforeinput 和 input 事件：

• 不可取消
• 具有 inputType 属性且值为 "insertCompositionText"
• data 属性等于 compositionupdate 事件的 data
• targetRange 包围了合成的活动文本段落

活动文本段落的 DOM 内容在调度 beforeinput 事件后，input 事件之前更新。

合成会话的结束通过调度 compositionend 事件标记。

当调度 "insertFromPaste" beforeinput 事件时，它 必须 之前已经调度了 paste 事件。[CLIPBOARD-APIS]

本节不是规范性的。

除了现有事件（如 keydown 和 keypress [UI-EVENTS] 事件）中已存在的 浏览器指纹识别 [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 以及编辑任务组中的所有人为他们的意见和反馈。