mozilla

Revision 536361 of DeviceOrientationEvent

  • Revision slug: Web/API/DeviceOrientationEvent
  • Revision title: DeviceOrientationEvent
  • Revision id: 536361
  • Created:
  • Creator: teoli
  • Is current revision? No
  • Comment

Revision Content

{{DomRef}}{{SeeCompatTable}}

The DeviceOrientationEvent provides web developers with information from the physical orientation of the device running the web page.

Warning: Currently, Firefox and Chrome does not handle the coordinates the same way. Take care about this while using them.

Properties

{{domxref("DeviceOrientationEvent.absolute")}} {{readonlyinline}}
A boolean that indicates whether or not the device is providing orientation data absolutely.
{{domxref("DeviceOrientationEvent.alpha")}} {{readonlyinline}}
A number representing the motion of the device around the z axis, express in degrees with values ranging from 0 to 360
{{domxref("DeviceOrientationEvent.beta")}} {{readonlyinline}}
A number representing the motion of the device around the x axis, express in degrees with values ranging from -180 to 180. This represents a front to back motion of the device.
{{domxref("DeviceOrientationEvent.gamma")}} {{readonlyinline}}
A number representing the motion of the device around the y axis, express in degrees with values ranging from -90 to 90. This represents a left to right motion of the device.

Example

window.addEventListener('deviceorientation', function(event) {
  console.log(event.alpha + ' : ' + event.beta + ' : ' + event.gamma);
});

Specifications

Specification Status Comment
{{SpecName('Device Orientation')}} {{Spec2('Device Orientation')}} Initial specification.

Browser compatibility

Compatibility for DeviceOrientationEvent:

{{ CompatibilityTable() }}

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 7.0 3.6 (mozOrientation),
6
{{ CompatUnknown() }} {{ CompatUnknown() }} {{ CompatUnknown() }}
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 3.0 3.6 (mozOrientation),
6
{{ CompatNo() }} {{ CompatNo() }} 4.2

Gecko-specific notes

Firefox 3.6, 4, and 5 supported mozOrientation instead of the standard DeviceOrientationEvent interface

See also

Revision Source

<p>{{DomRef}}{{SeeCompatTable}}</p>
<p>The <code>DeviceOrientationEvent</code> provides web developers with information from the physical orientation of the device running the web page.</p>
<div class="warning">
 <p><strong>Warning:</strong> Currently, Firefox and Chrome does not handle the coordinates the same way. Take care about this while using them.</p>
</div>
<h2 id="Properties">Properties</h2>
<dl>
 <dt>
  {{domxref("DeviceOrientationEvent.absolute")}} {{readonlyinline}}</dt>
 <dd>
  A boolean that indicates whether or not the device is providing orientation data absolutely.</dd>
 <dt>
  {{domxref("DeviceOrientationEvent.alpha")}} {{readonlyinline}}</dt>
 <dd>
  A number representing the motion of the device around the z axis, express in degrees with values ranging from 0 to 360</dd>
 <dt>
  {{domxref("DeviceOrientationEvent.beta")}} {{readonlyinline}}</dt>
 <dd>
  A number representing the motion of the device around the x axis, express in degrees with values ranging from -180 to 180. This represents a front to back motion of the device.</dd>
 <dt>
  {{domxref("DeviceOrientationEvent.gamma")}} {{readonlyinline}}</dt>
 <dd>
  A number representing the motion of the device around the y axis, express in degrees with values ranging from -90 to 90. This represents a left to right motion of the device.</dd>
</dl>
<h2 id="Example">Example</h2>
<pre class="brush: js">
window.addEventListener('deviceorientation', function(event) {
&nbsp; console.log(event.alpha + ' : ' + event.beta + ' : ' + event.gamma);
});</pre>
<h2 id="Specifications">Specifications</h2>
<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('Device Orientation')}}</td>
   <td>{{Spec2('Device Orientation')}}</td>
   <td>Initial specification.</td>
  </tr>
 </tbody>
</table>
<h2 id="Browser_compatibility">Browser compatibility</h2>
<p>Compatibility for DeviceOrientationEvent:</p>
<p>{{ CompatibilityTable() }}</p>
<div id="compat-desktop">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>Feature</th>
    <th>Chrome</th>
    <th>Firefox (Gecko)</th>
    <th>Internet Explorer</th>
    <th>Opera</th>
    <th>Safari (WebKit)</th>
   </tr>
   <tr>
    <td>Basic support</td>
    <td>7.0</td>
    <td>3.6 (mozOrientation),<br />
     6</td>
    <td>{{ CompatUnknown() }}</td>
    <td>{{ CompatUnknown() }}</td>
    <td>{{ CompatUnknown() }}</td>
   </tr>
  </tbody>
 </table>
</div>
<div id="compat-mobile">
 <table class="compat-table">
  <tbody>
   <tr>
    <th>Feature</th>
    <th>Android</th>
    <th>Firefox Mobile (Gecko)</th>
    <th>IE Phone</th>
    <th>Opera Mobile</th>
    <th>Safari Mobile</th>
   </tr>
   <tr>
    <td>Basic support</td>
    <td>3.0</td>
    <td>3.6 (mozOrientation),<br />
     6</td>
    <td>{{ CompatNo() }}</td>
    <td>{{ CompatNo() }}</td>
    <td>4.2</td>
   </tr>
  </tbody>
 </table>
</div>
<h3 id="Gecko-specific_notes">Gecko-specific notes</h3>
<p>Firefox 3.6, 4, and 5 supported <a href="/en-US/DOM/MozOrientation" title="MozOrientation">mozOrientation </a>instead of the standard <code>DeviceOrientationEvent</code> interface</p>
<h2 id="See_also">See also</h2>
<ul>
 <li>{{ event("deviceorientation") }}</li>
 <li>{{ domxref("DeviceMotionEvent") }}</li>
 <li>{{ event("devicemotion") }}</li>
 <li><a href="/en-US/docs/WebAPI/Detecting_device_orientation" title="/en-US/docs/WebAPI/Detecting_device_orientation">Detecting device orientation</a></li>
 <li><a href="https://developer.mozilla.org/en/DOM/Orientation_and_motion_data_explained" title="Orientation and motion data explained">Orientation and motion data explained</a></li>
</ul>
Revert to this revision