Proximity
Experimental: Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.
Résumé
Les événements de proximité permettent, simplement, de savoir lorsqu'un utilisateur est près de l'appareil. Ces événements permettent de réagir par rapport à cette proximité, par exemple en éteignant l'écran lorsqu'un utilisateur est en train de passer un appel téléphonique et que l'appareil est près de l'oreille.
Note : Bien entendu, il faut un capteur de proximité pour que cette API fonctionne, ceux-ci sont généralement disponibles sur les appareils mobile. Les appareils ne disposant pas d'un tel capteur pourront supporter de tels événements, ils seront en revanche incapables de les déclencher.
Événements de proximité
Lorsque le capteur de l'appareil détecte un changement entre l'appareil et l'objet, il informe le navigateur de ce changement en lui envoyant une notification. Lorsque le navigateur reçoit une notification comme celle-ci, il déclenche un événement DeviceProximityEvent (en-US) à chaque fois qu'il y a un changement et un événement UserProximityEvent (en-US) dans le cas où un changement plus brutal se produit.
Cet événement peut être capturé en utilisant un objet au niveau window en utilisant la méthode addEventListener (en utilisant les noms d'événements DeviceProximityEvent (en-US) ou UserProximityEvent (en-US)) ou en attachant un gestionnaire d'événement à la propriété window.ondeviceproximity (en-US) ou à la propriété window.onuserproximity (en-US).
Une fois qu'il a été capturé, l'événement donne accès à différentes informations :
- L'événement
DeviceProximityEvent(en-US) permet de connaître la distance exacte entre l'appareil et l'objet avec sa propriétévalue. Il fournit également la distance la plus courte et la distance la plus grande que l'appareil peut détecter avec les propriétésminetmax(en-US). - L'événement
UserProximityEvent(en-US) fournit une valeur approximative pour la distance en utilisant un booléen. La propriétéUserProximityEvent.near(en-US) vauttruesi l'objet est proche oufalsesi l'objet est loin.
Exemple
window.addEventListener('userproximity', function(event) {
if (event.near) {
// extinction de l'écran
navigator.mozPower.screenEnabled = false;
} else {
// allumage de l'écran
navigator.mozPower.screenEnabled = true;
}
});