EditContext: characterBounds() 方法

有限可用性

此功能并非基线,因为它在一些最广泛使用的浏览器中不起作用。

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

characterBounds() 方法是 EditContext 接口的方法,它返回一个包含 EditContext 对象中字符的边界矩形列表的 Array

EditContext 对象中字符的位置和大小由操作系统使用,以便在需要时正确地定位平台特定的与编辑相关的 UI 表面,例如 输入法编辑器 (IME) 窗口。这在操作系统无法自动检测字符位置和大小的情况下尤其重要,例如在 <canvas> 元素中渲染文本时。

Web 开发人员很可能对使用 characterboundsupdate 事件以及 EditContext.updateCharacterBounds() 方法更新字符边界感兴趣,方法是当操作系统指示它需要有关字符位置和大小的信息时。

characterBounds() 方法返回最后使用 updateCharacterBounds() 更新的字符边界列表。该列表不包含 EditContext 对象中每个字符的项目,只包含使用 updateCharacterBounds() 更新的字符。要了解字符在 EditContext 对象中的位置,请使用 EditContext.characterBoundsRangeStart 属性。

语法

js
characterBounds()

返回值

包含 DOMRect 对象的 Array

规范

规范
EditContext API
# dom-editcontext-characterbounds

浏览器兼容性

BCD 表格仅在浏览器中加载

参见