mozilla

Compare Revisions

Proximity Events

Change Revisions

Revision 378267:

Revision 378267 by Jeremie on

Revision 380329:

Revision 380329 by samdutton on

Title:
Proximity
Proximity
Slug:
WebAPI/Proximity
WebAPI/Proximity
Tags:
"WebAPI", "B2G", "Proximity", "Firefox OS"
"WebAPI", "B2G", "Proximity", "Firefox OS"
Content:

Revision 378267
Revision 380329
n14      The proximity events are a handy way to know when a user isn14      The proximity events are a handy way to know when a user is
> close from its device. This events allows to reacte to such a ch> close to a device. This events make it possible to react to such
>ange, for example by shutting down the screen of a smartphone whe> a change, for example by shutting down the screen of a smartphon
>n the user is having a phone call with the device against one of >e when the user is having a phone call with the device close to t
>his hears.>heir ear.
n18        <strong>Note:</strong> Obviously, it requires the device n18        <strong>Note:</strong> Obviously, the API requires the de
>to have a proximity sensor which mostly happen on mobile device o>vice to have a proximity sensor, which are mostly available only 
>nly. Devices without such a sensor will support those events but >on mobile devices. Devices without such a sensor may support thos
>will never fire them.>e events but will never fire them.
n25      When the device proximity sensor detect a change between thn25      When the device proximity sensor detects a change between t
>e device and an object, it notify the browser of that change. Whe>he device and an object, it notifies the browser of that change. 
>n the browser get such notification, it fires a {{domxref("Device>When the browser gets such notification, it fires a {{domxref("
>ProximityEvent")}} for any change, and it fires a {{domxref("User>DeviceProximityEvent")}} for any change, and a {{domxref("UserPro
>ProximityEvent")}} event in case of a more rough change.>ximityEvent")}} event in the case of a more rough change.
26    </p>
27    <p>26    </p>
27    <p>
28      This event can be capture at the <code>window</code> object28      This event can be captured at the <code>window</code> objec
> level by using the {{domxref("EventTarget.addEventListener","add>t level by using the {{domxref("EventTarget.addEventListener","ad
>EventListener")}} method (using the {{event("deviceproximity")}} >dEventListener")}} method (using the {{event("deviceproximity")}}
>or {{event("userproximity")}} event name) or by attaching an even> or {{event("userproximity")}} event name) or by attaching an eve
>t handler to the {{domxref("window.ondeviceproximity")}} or {{dom>nt handler to the {{domxref("window.ondeviceproximity")}} or {{do
>xref("window.onuserproximity")}} properties.>mxref("window.onuserproximity")}} properties.
29    </p>
30    <p>29    </p>
30    <p>
31      Once captured, the event object gives acces to diffrent kin31      Once captured, the event object gives access to different k
>d of information:>inds of information:
n34      <li>The {{domxref("DeviceProximityEvent")}} event provide an34      <li>The {{domxref("DeviceProximityEvent")}} event provide
>n exact match of the distance between the device and the object t>an exact match for the distance between the device and the object
>hrough its {{domxref("DeviceProximityEvent.value","value")}} prop> through its {{domxref("DeviceProximityEvent.value","value")}} pr
>erty. It also provides the closest and farthest distance the devi>operty. It also provides the closest and farthest distance the de
>ce is able to detect something throug its {{domxref("DeviceProxim>vice is able to detect something through its {{domxref("DevicePro
>ityEvent.min","min")}} and {{domxref("DeviceProximityEvent.max",">ximityEvent.min","min")}} and {{domxref("DeviceProximityEvent.max
>max")}} properties.>","max")}} properties.
t36      <li>The {{domxref("UserProximityEvent")}} event provide an t36      <li>The {{domxref("UserProximityEvent")}} event provides a 
>rough approximation about the distance, express through a boolean>rough approximation of the distance, expressed through a boolean.
>. The {{domxref("UserProximityEvent.near")}} property is <code>tr> The {{domxref("UserProximityEvent.near")}} property is <code>tru
>ue</code> if the object is close or <code>false</code> if the obj>e</code> if the object is close or <code>false</code> if the obje
>ect is far.>ct is far.

Back to History