HTMLGeolocationElement : évènement promptaction

Expérimental: Il s'agit d'une technologie expérimentale.
Vérifiez attentivement le tableau de compatibilité des navigateurs avant de l'utiliser en production.

L'évènement promptaction de l'interface HTMLGeolocationElement est déclenché chaque fois que l'utilisateur·ice active l'élément <geolocation> et sélectionne une option dans la boîte de dialogue qui s'affiche, soit pour accorder, soit pour refuser l'autorisation geolocation.

Syntaxe

Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété gestionnaire d'évènement.

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

onpromptaction = (event) => { }

Type d'évènement

Un objet Event.

Exemples

Utiliser `promptaction` pour réagir aux choix d'autorisation de l'utilisateur·ice

Dans notre démonstration de carte intégrée ^(angl.) (code source ^(angl.)), nous utilisons un gestionnaire d'évènement promptaction pour réagir au choix effectué par l'utilisateur·ice dans la boîte de dialogue d'autorisation de l'élément <geolocation> :

geo.addEventListener("promptaction", notifyUserGrantPermission);

Dans la fonction notifyUserGrantPermission(), nous utilisons la propriété HTMLGeolocationElement.permissionStatus pour vérifier si l'état d'autorisation est denied ou prompt et, le cas échéant, nous demandons à l'utilisateur·ice d'appuyer à nouveau sur le bouton et d'autoriser la localisation. Il n'est pas nécessaire de demander cela si l'autorisation est déjà accordée.

function notifyUserGrantPermission() {
  if (geo.permissionStatus === "denied" || geo.permissionStatus === "prompt") {
    statusElem.textContent =
      "Veuillez appuyer à nouveau sur le bouton « Utiliser la localisation » et autoriser la localisation pour ce site.";
  }
}

Voir la page principale HTMLGeolocationElement pour une explication complète de cet exemple.