HTMLGeolocationElement: validationstatuschange イベント

Limited availability

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

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

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

構文

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

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

onvalidationstatuschange = (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 のメインページを参照してください。