墨水:requestPresenter() 方法

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

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

语法

js
requestPresenter(param)

参数

param 可选

一个 InkPresenterParam 对象,包含以下属性

presentationArea 可选

一个 Element,墨水笔画的渲染限制在其中(确切地说,是元素的边框框)。如果未包含 param,或 presentationArea 设置为 null,则默认情况下墨水渲染限制在包含视口中。

返回值

一个 Promise,解析为 InkPresenter 对象实例。

异常

Error DOMException

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

示例

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

  //...
}

规范

规范
墨水 API
# dom-ink-requestpresenter

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅