EditContext

可用性有限

此功能不是基线功能,因为它在一些最广泛使用的浏览器中无法正常工作。

实验性: 这是一个 实验性技术
在生产环境中使用此功能之前,请仔细查看 浏览器兼容性表

EditContext 接口表示使用 EditContext API 设为可编辑的元素的文本编辑上下文。

EditContext API 可用于在 Web 上构建支持高级文本输入体验的富文本编辑器,例如 输入法编辑器 (IME) 组合、表情符号选择器或任何其他特定于平台的与编辑相关的 UI 表面。

构造函数

EditContext() 实验性

返回一个新的 EditContext 实例。

实例属性

EditContext.text 只读 实验性

元素的可编辑内容。

EditContext.selectionStart 只读 实验性

当前选中文本内容中,选择开始处的偏移量。

EditContext.selectionEnd 只读 实验性

当前选中文本内容中,选择结束处的偏移量。

EditContext.characterBoundsRangeStart 只读 实验性

上次 IME 组合开始的可编辑文本内容中的偏移量。

实例方法

EditContext 基于 EventTarget 接口,并包含其方法。

EditContext.attachedElements() 实验性

一个包含一个 HTMLElement 对象的 Array,该对象是与 EditContext 对象关联的元素。

EditContext.characterBounds() 实验性

EditContext 对象中字符的边界矩形列表。

EditContext.updateText() 实验性

更新 EditContext 对象的内部文本内容。

EditContext.updateSelection() 实验性

更新可编辑文本上下文中选择的内部状态。

EditContext.updateControlBounds() 实验性

通知操作系统可编辑文本区域的位置和大小。

EditContext.updateSelectionBounds() 实验性

通知操作系统可编辑文本区域中选择的位置和大小。

EditContext.updateCharacterBounds() 实验性

通知操作系统 EditContext 对象中字符的位置和大小。

事件

textupdate 实验性

当用户对文本或选择进行更改时触发。

textformatupdate 实验性

当使用 输入法编辑器 (IME) 窗口进行组合并且 IME 决定应以不同的方式设置正在组合的文本的某些部分的格式以指示组合状态时触发。

characterboundsupdate 实验性

当操作系统需要了解 EditContext 对象的可编辑文本区域中某些字符的大小和位置以显示 IME 窗口时触发。

compositionstart 实验性

当使用 IME 窗口进行组合开始时触发。

compositionend 实验性

当使用 IME 窗口进行输入结束时触发。

规范

规范
EditContext API
# dom-editcontext

浏览器兼容性

BCD 表格仅在浏览器中加载