このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

Ink: requestPresenter() メソッド

利用可能性は限定的

この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。

Want more browser support for this feature? Tell us why.

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

requestPresenter() は Ink インターフェイスのメソッドで、 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

ブラウザーの互換性