Ink: requestPresenter()-Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Die requestPresenter()-Methode der Ink-Schnittstelle gibt ein Promise zurück, das mit einem InkPresenter-Objekt erfüllt wird, um Striche zu rendern.

Syntax

js
requestPresenter(param)

Parameter

param Optional

Ein InkPresenterParam-Objekt, das die folgende Eigenschaft enthält:

presentationArea Optional

Ein Element, innerhalb dessen die Darstellung der Tintenstriche eingeschränkt ist (genauer gesagt die Rahmenbox des Elements). Wenn param nicht inkludiert ist oder presentationArea auf null gesetzt ist, ist die Tintenwiedergabe standardmäßig auf den enthaltenden Viewport beschränkt.

Rückgabewert

Ein Promise, das zu einer Instanz des InkPresenter-Objekts aufgelöst wird.

Ausnahmen

Error DOMException

Ein Fehler wird ausgelöst und die Operation wird abgebrochen, wenn presentationArea kein gültiges Element ist oder nicht im selben Dokument wie das zugehörige Ink-Objekt enthalten ist.

Beispiel

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

  //...
}

Spezifikationen

Specification
Ink API
# dom-ink-requestpresenter

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch