---
title: DeviceOrientationEvent
slug: Web/API/DeviceOrientationEvent
translation_of: Web/API/DeviceOrientationEvent
---
<p>{{apiref("Device Orientation Events")}}{{SeeCompatTable}}</p>

<p><code>DeviceOrientationEvent</code> 提供了網頁開發者關於目前瀏覽頁面之裝置的物理旋轉方向資訊。</p>

<div class="warning">
<p><strong>Warning:</strong> Currently, Firefox and Chrome do not handle the coordinates the same way. Take care about this while using them.</p>
</div>

<h2 id="屬性">屬性</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="範例">範例</h2>

<pre class="brush: js">window.addEventListener('deviceorientation', function(event) {
  console.log(event.alpha + ' : ' + event.beta + ' : ' + event.gamma);
});</pre>

<h2 id="規範">規範</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="瀏覽器相容性">瀏覽器相容性</h2>

{{Compat("api.DeviceOrientationEvent")}}

<h2 id="參見">參見</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>