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 deviceproximity ou userproximity) 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 :

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;
  }
});

Spécifications

Spécification Statut Commentaire
Proximity Sensor
La définition de 'Proximity Events' dans cette spécification.
Version de travail Spécification initiale

Compatibilité des navigateurs

DeviceProximityEvent

BCD tables only load in the browser

UserProximityEvent

BCD tables only load in the browser

Voir aussi