Revision 754721 of MouseWheelEvent

Revision slug: Web/API/MouseWheelEvent
Revision title: MouseWheelEvent
Revision id: 754721
Created: Feb 23, 2015, 12:47:24 PM
Creator: teoli
Is current revision? Yes
Comment

Tags:

Revision Content

The MouseWheelEvent interface represents events that occur due to the user turning a mouse wheel.

Do not use this interface for wheel events.

Like {{domxref("MouseScrollEvent")}}, this interface is non-standard and deprecated. It was used in non-Gecko browsers only. Instead use the standard {{domxref("WheelEvent")}}.

Properties

Attribute	Type	Description
`wheelDelta`	`long`	The distance in pixels (defined as so by MSDN, but the actual usage is different, see {{ domeventxref("mousewheel") }}). Read only.
`wheelDeltaX`	`long`?	The value along horizontal axis of `wheelDelta`. Read only.
`wheelDeltaY`	`long`?	The value along vertical axis of `wheelDelta`. Read only.

Browser compatibility

Feature	Chrome	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Basic support	{{ CompatVersionUnknown() }}	{{ CompatNo() }}	{{ CompatIE("6.0") }}	{{ CompatVersionUnknown() }}	{{ CompatVersionUnknown() }}
`window.MouseWheelEvent`	{{ CompatNo() }}	{{ CompatNo() }}	{{ CompatIE("9.0") }}	{{ CompatNo() }}	{{ CompatNo() }}
`wheelDeltaX`	{{ CompatVersionUnknown() }}	{{ CompatNo() }}	{{ CompatNo() }}	{{ CompatNo() }}	{{ CompatVersionUnknown() }}
`wheelDeltaY`	{{ CompatVersionUnknown() }}	{{ CompatNo() }}	{{ CompatNo() }}	{{ CompatNo() }}	{{ CompatVersionUnknown() }}

Feature	Android	Firefox Mobile (Gecko)	IE Phone	Opera Mobile	Safari Mobile
Basic support	{{ CompatUnknown() }}	{{ CompatNo() }}	{{ CompatUnknown() }}	{{ CompatUnknown() }}	{{ CompatUnknown() }}
`window.MouseWheelEvent`	{{ CompatUnknown() }}	{{ CompatNo() }}	{{ CompatUnknown() }}	{{ CompatUnknown() }}	{{ CompatUnknown() }}
`wheelDeltaX`	{{ CompatUnknown() }}	{{ CompatNo() }}	{{ CompatUnknown() }}	{{ CompatUnknown() }}	{{ CompatUnknown() }}
`wheelDeltaY`	{{ CompatUnknown() }}	{{ CompatNo() }}	{{ CompatUnknown() }}	{{ CompatUnknown() }}	{{ CompatUnknown() }}

Revision Source

<p>{{APIRef("DOM Events")}}{{ Non-standard_header() }}{{deprecated_header}}</p>

<p>The <strong><code>MouseWheelEvent</code></strong> interface represents events that occur due to the user turning a mouse wheel.</p>

<div class="note">
<p><strong>Do not use this interface for wheel events.</strong></p>

<p>Like {{domxref("MouseScrollEvent")}}, this interface is non-standard and deprecated. It was used in non-Gecko browsers only. Instead use the standard <em>{{domxref("WheelEvent")}}.</em></p>
</div>

<h2 id="Properties">Properties</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <td class="header">Attribute</td>
   <td class="header">Type</td>
   <td class="header">Description</td>
  </tr>
  <tr>
   <td><code>wheelDelta</code></td>
   <td><code>long</code></td>
   <td>The distance in pixels (defined as so by MSDN, but the actual usage is different, see {{ domeventxref("mousewheel") }}). <strong>Read only.</strong></td>
  </tr>
  <tr>
   <td><code>wheelDeltaX</code></td>
   <td><code>long</code>?</td>
   <td>The value along horizontal axis of <code>wheelDelta</code>. <strong>Read only.</strong></td>
  </tr>
  <tr>
   <td><code>wheelDeltaY</code></td>
   <td><code>long</code>?</td>
   <td>The value along vertical axis of <code>wheelDelta</code>. <strong>Read only.</strong></td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_Compatibility" name="Browser_Compatibility">Browser compatibility</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>{{ CompatVersionUnknown() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatIE("6.0") }}</td>
   <td>{{ CompatVersionUnknown() }}</td>
   <td>{{ CompatVersionUnknown() }}</td>
  </tr>
  <tr>
   <td><code>window.MouseWheelEvent</code></td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatIE("9.0") }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
  </tr>
  <tr>
   <td><code>wheelDeltaX</code></td>
   <td>{{ CompatVersionUnknown() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatVersionUnknown() }}</td>
  </tr>
  <tr>
   <td><code>wheelDeltaY</code></td>
   <td>{{ CompatVersionUnknown() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatVersionUnknown() }}</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&nbsp;Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
  </tr>
  <tr>
   <td><code>window.MouseWheelEvent</code></td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
  </tr>
  <tr>
   <td><code>wheelDeltaX</code></td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
  </tr>
  <tr>
   <td><code>wheelDeltaY</code></td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatNo() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
   <td>{{ CompatUnknown() }}</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="See_also">See also</h2>

<ul>
 <li>An event type which is used by this event object: {{ domeventxref("mousewheel") }}</li>
 <li>A standardized mouse wheel event object: {{ domxref("WheelEvent") }}</li>
 <li>Gecko's legacy mouse wheel event object: {{ domxref("MouseScrollEvent") }}</li>
 <li>The document in MSDN: {{ spec("https://msdn.microsoft.com/en-us/library/ie/ff974345%28v=vs.85%29.aspx","MouseWheelEvent object") }}</li>
</ul>

Revert to this revision