aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/api/deviceorientationevent/index.html
blob: a65efefa948164e39410cfe4d58d0ea3451b321c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
---
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>警告:</strong> 当前,火狐浏览器和谷歌浏览器并未能用同一种方式实现,在使用请注意。(见后文) </p>
</div>

<h2 id="属性">属性</h2>

<dl>
 <dt>{{domxref("DeviceOrientationEvent.absolute")}} {{readonlyinline}}</dt>
 <dd>用来说明设备是提供的旋转数据是否是绝对定位的布尔值。</dd>
 <dt>{{domxref("DeviceOrientationEvent.alpha")}} {{readonlyinline}}</dt>
 <dd>一个表示设备绕z轴旋转的角度(范围在0-360之间)的数字</dd>
 <dt> </dt>
 <dt>{{domxref("DeviceOrientationEvent.beta")}} {{readonlyinline}}</dt>
 <dd>一个表示设备绕x轴旋转(范围在-180到180之间)的数字,从前到后的方向为正方向。</dd>
 <dt>{{domxref("DeviceOrientationEvent.gamma")}} {{readonlyinline}}</dt>
 <dd>一个表示设备绕y轴旋转(范围在-90到90之间)的数字,从左向右为正方向。</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">规范</th>
   <th scope="col">状态</th>
   <th scope="col">草案</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>

<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 [1]</td>
   <td>6 [2]</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>Android Webview</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
   <th>Chrome for Android</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>3.0</td>
   <td>{{CompatVersionUnknown}} [1]</td>
   <td>6 [2]</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatNo}}</td>
   <td>4.2</td>
   <td>{{CompatVersionUnknown}} [1]</td>
  </tr>
 </tbody>
</table>
</div>

<p>[1] 在版本50之前Chrome为该事件提供绝对的值而非相对的值。开发者仍需使用绝对的值,当使用{{domxref("ondeviceorientationabsolute")}} 事件时.</p>

<p>[2] 火狐3.6, 4, and 5支持<a href="/en-US/DOM/MozOrientation">mozOrientation </a>而非标准的 <code>DeviceOrientationEvent</code></p>

<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">监测设备方向</a></li>
 <li><a href="https://developer.mozilla.org/en/DOM/Orientation_and_motion_data_explained" title="Orientation and motion data explained">转动与运动的数据说明</a></li>
</ul>