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

View in English Always switch to English

HTMLGeolocationElement: validationstatuschange イベント

validationstatuschangeHTMLGeolocationElement インターフェイスのイベントで、<geolocation> 要素の isValid 値が変更されるたびに発生します。

これは、<geolocation> 要素にブロッカーが追加または除去された結果として発生します。

構文

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

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

onvalidationstatuschange = (event) => { }

イベント型

Event です。

validationstatuschange を使用して無効な理由を報告

埋め込み地図の例(ソースコード)では、validationstatuschange イベントハンドラーを使用して、<geolocation> 要素が有効になったことを報告し、また無効にになった際はその無効の理由を報告します。

js
geo.addEventListener("validationstatuschange", () => {
  if (geo.isValid) {
    reasonElem.textContent = `<geolocation> は有効です`;
  } else {
    reasonElem.textContent = `無効な理由: ${geo.invalidReason}`;
  }
});

有効性の状態が変化するたび、<geolocation> 要素が有効かどうかを HTMLGeolocationElement.isValid を使用して調べ、有効の場合、その旨を確認するメッセージを <p> 要素のコンテンツテキストに表示します。<geolocation> 要素が無効な場合、HTMLGeolocationElement.invalidReason<p> 要素のコンテンツテキストに表示します。

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

仕様書

This feature does not appear to be defined in any specification.

ブラウザーの互換性

関連情報