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 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, in dem die Darstellung der Tintenstriche eingeschränkt ist (genauer gesagt, die Rahmenbox des Elements). Wenn param nicht enthalten ist oder presentationArea auf null gesetzt ist, wird die Tinten-Darstellung standardmäßig auf den umgebenden Viewport begrenzt.

Rückgabewert

Ein Promise, das zu einer DelegatedInkTrailPresenter-Objektinstanz aufgelöst wird.

Ausnahmen

Error DOMException

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

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