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

瀏覽器相容性