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 vor der Verwendung auf produktiven Webseiten.

Die requestPresenter()-Methode der Ink-Schnittstelle gibt ein Promise zurück, das mit einem DelegatedInkTrailPresenter-Objekt erfüllt wird, um die Darstellung von Strichen zu handhaben.

Syntax

js
requestPresenter(param)

Parameter

param Optional

Ein Objekt, das die folgende Eigenschaft enthält:

presentationArea Optional

Ein Element, innerhalb dessen die Darstellung der Schriftstriche eingeschränkt ist (genauer gesagt die Rahmenbox des Elements). Wenn param nicht enthalten ist oder presentationArea auf null gesetzt ist, ist die Tintenwiedergabe standardmäßig auf das umgebende Ansichtsfenster beschränkt.

Rückgabewert

Ein Promise, das sich zu einer Instanz des DelegatedInkTrailPresenter-Objekts auflöst.

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 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