Element: webkitmouseforcechanged event

{{APIRef("Force Touch Events")}} {{Non-standard_header}} 

The non-standard webkitmouseforcechanged event is fired by Safari each time the amount of pressure changes on the trackpad/touchscreen.

webkitmouseforcechanged is a proprietary, WebKit-specific event introduced by Apple to support their Force Touch events feature.

This event first fires after the {{domxref("Element/mousedown_event", "mousedown")}}  event and stops firing before the {{domxref("Element/mouseup_event", "mouseup")}}  event.

Syntax

Use the event name in methods like {{domxref("EventTarget.addEventListener", "addEventListener()")}} , or set an event handler property.

addEventListener("webkitmouseforcechanged", (event) => { })

onwebkitmouseforcechanged = (event) => { }

Event type

A {{domxref("MouseEvent")}} . Inherits from {{domxref("UIEvent")}}  and {{domxref("Event")}} .

{{InheritanceDiagram("MouseEvent")}} 

Event properties

This interface also inherits properties of its parents, {{domxref("UIEvent")}}  and {{domxref("Event")}} .

• {{domxref("MouseEvent.altKey")}}  {{ReadOnlyInline}} 
  • : Returns true if the alt key was down when the mouse event was fired.
• {{domxref("MouseEvent.button")}}  {{ReadOnlyInline}} 
  • : The button number that was pressed (if applicable) when the mouse event was fired.
• {{domxref("MouseEvent.buttons")}}  {{ReadOnlyInline}} 
  • : The buttons being pressed (if any) when the mouse event was fired.
• {{domxref("MouseEvent.clientX")}}  {{ReadOnlyInline}} 
  • : The X coordinate of the mouse pointer in viewport coordinates.
• {{domxref("MouseEvent.clientY")}}  {{ReadOnlyInline}} 
  • : The Y coordinate of the mouse pointer in viewport coordinates.
• {{domxref("MouseEvent.ctrlKey")}}  {{ReadOnlyInline}} 
  • : Returns true if the control key was down when the mouse event was fired.
• {{domxref("MouseEvent.layerX")}}  {{Non-standard_inline}}  {{ReadOnlyInline}} 
  • : Returns the horizontal coordinate of the event relative to the current layer.
• {{domxref("MouseEvent.layerY")}}  {{Non-standard_inline}}  {{ReadOnlyInline}} 
  • : Returns the vertical coordinate of the event relative to the current layer.
• {{domxref("MouseEvent.metaKey")}}  {{ReadOnlyInline}} 
  • : Returns true if the meta key was down when the mouse event was fired.
• {{domxref("MouseEvent.movementX")}}  {{ReadOnlyInline}} 
  • : The X coordinate of the mouse pointer relative to the position of the last {{domxref("Element/mousemove_event", "mousemove")}}  event.
• {{domxref("MouseEvent.movementY")}}  {{ReadOnlyInline}} 
  • : The Y coordinate of the mouse pointer relative to the position of the last {{domxref("Element/mousemove_event", "mousemove")}}  event.
• {{domxref("MouseEvent.offsetX")}}  {{ReadOnlyInline}} 
  • : The X coordinate of the mouse pointer relative to the position of the padding edge of the target node.
• {{domxref("MouseEvent.offsetY")}}  {{ReadOnlyInline}} 
  • : The Y coordinate of the mouse pointer relative to the position of the padding edge of the target node.
• {{domxref("MouseEvent.pageX")}}  {{ReadOnlyInline}} 
  • : The X coordinate of the mouse pointer relative to the whole document.
• {{domxref("MouseEvent.pageY")}}  {{ReadOnlyInline}} 
  • : The Y coordinate of the mouse pointer relative to the whole document.
• {{domxref("MouseEvent.relatedTarget")}}  {{ReadOnlyInline}} 
  • : The secondary target for the event, if there is one.
• {{domxref("MouseEvent.screenX")}}  {{ReadOnlyInline}} 
  • : The X coordinate of the mouse pointer in screen coordinates.
• {{domxref("MouseEvent.screenY")}}  {{ReadOnlyInline}} 
  • : The Y coordinate of the mouse pointer in screen coordinates.
• {{domxref("MouseEvent.shiftKey")}}  {{ReadOnlyInline}} 
  • : Returns true if the shift key was down when the mouse event was fired.
• {{domxref("MouseEvent.mozInputSource")}}  {{non-standard_inline()}}  {{ReadOnlyInline}} 
  • : The type of device that generated the event (one of the MOZ_SOURCE_* constants). This lets you, for example, determine whether a mouse event was generated by an actual mouse or by a touch event (which might affect the degree of accuracy with which you interpret the coordinates associated with the event).
• {{domxref("MouseEvent.webkitForce")}}  {{non-standard_inline()}}  {{ReadOnlyInline}} 
  • : The amount of pressure applied when clicking.
• {{domxref("MouseEvent.x")}}  {{ReadOnlyInline}} 
  • : Alias for {{domxref("MouseEvent.clientX")}} .
• {{domxref("MouseEvent.y")}}  {{ReadOnlyInline}} 
  • : Alias for {{domxref("MouseEvent.clientY")}} .

Specifications

Not part of any specification. Apple has a description at the Mac Developer Library.

Browser compatibility

{{Compat}} 

See also

• Learn: Introduction to events
• {{domxref("Element/webkitmouseforcewillbegin_event", "webkitmouseforcewillbegin")}} 
• {{domxref("Element/webkitmouseforcedown_event", "webkitmouseforcedown")}} 
• {{domxref("Element/webkitmouseforceup_event", "webkitmouseforceup")}}