HTMLGeolocationElement: promptaction イベント

Limited availability

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

promptaction は HTMLGeolocationElement インターフェイスのイベントで、ユーザーが <geolocation> 要素をアクティブにし、表示されるダイアログから geolocation 権限を許可または拒否するオプションを選択するたびに発生します。

構文

このイベント名を addEventListener() 等のメソッドで使用するか、イベントハンドラープロパティを設定するかしてください。

js
addEventListener("promptaction", (event) => { })

onpromptaction = (event) => { }

イベント型

Event です。

例

promptaction を使用してユーザーの許可の選択に応答

埋め込み地図の例（ソースコード）では、promptaction イベントハンドラーを使用して、<geolocation> 権限プロンプトでユーザーが選択を行った際の応答を行います。

geo.addEventListener("promptaction", notifyUserGrantPermission);

notifyUserGrantPermission() 関数では、HTMLGeolocationElement.permissionStatus プロパティを使用して、権限の状態が denied または prompt かどうかを調べます。該当する場合は、ユーザーに再度ボタンを押して位置情報の許可を求めるよう促します。既に許可が与えられている場合は、この確認は必要ありません。

js
function notifyUserGrantPermission() {
  if (geo.permissionStatus === "denied" || geo.permissionStatus === "prompt") {
    statusElem.textContent =
      "再度「位置情報を使用」ボタンを押して、このサイトへの位置情報の許可を行うことができるようにしてください。";
  }
}

この例の完全な手順を追った解説については、HTMLGeolocationElement のメインページを参照してください。