Ink: requestPresenter() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

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

requestPresenter() 方法是 Ink 接口的一部分,它返回一个 Promise,该 Promise 会解析为一个 DelegatedInkTrailPresenter 对象,用于处理墨迹笔触的渲染。

语法

js
requestPresenter(param)

参数

param 可选

一个包含以下属性的对象

presentationArea 可选

一个 Element,墨迹笔触的渲染将被限制在该元素内部(更准确地说,是该元素的边框盒内)。如果未包含 param,或者 presentationArea 设置为 null,则墨迹渲染默认限制在包含视口内。

返回值

一个 Promise,它会解析为一个 DelegatedInkTrailPresenter 对象实例。

异常

Error DOMException

如果 presentationArea 不是一个有效的 Element,或者它与关联的 Ink 对象不在同一个文档中,则会抛出错误并中止操作。

示例

js
async function inkInit() {
  const ink = navigator.ink;
  let presenter = await ink.requestPresenter({ presentationArea: canvas });

  // …
}

规范

规范
Ink API
# dom-ink-requestpresenter

浏览器兼容性