Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.

View in English Always switch to English

HTMLGeolocationElement : évènement promptdismiss

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 promptdismiss de l'interface HTMLGeolocationElement est déclenché chaque fois que l'utilisateur·ice active l'élément <geolocation> et ferme la boîte de dialogue qui s'affiche, en appuyant sur le bouton « fermer » ou la touche Échap.

Syntaxe

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

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

onpromptdismiss = (event) => { }

Type d'évènement

Un objet Event.

Exemples

Utiliser promptdismiss pour réagir à la fermeture de la demande d'autorisation

Dans notre démonstration de carte intégrée (angl.) (code source (angl.)), nous utilisons un gestionnaire d'évènement promptdismiss pour réagir à la fermeture de la boîte de dialogue d'autorisation de l'élément <geolocation> :

js
geo.addEventListener("promptdismiss", notifyUserRetrySelection);

Dans la fonction notifyUserRetrySelection(), nous demandons à l'utilisateur·ice d'appuyer à nouveau sur le bouton et d'autoriser la localisation.

js
function notifyUserRetrySelection() {
  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.

Spécifications

Specification
Unknown specification
# dom-inpagepermissionmixin-onpromptdismiss

Compatibilité des navigateurs

Voir aussi