diff --git a/index.html b/index.html index b006351..9d914cb 100644 --- a/index.html +++ b/index.html @@ -211,7 +211,7 @@
buttons
property. For mouse, this is when the device has at least one button depressed. For touch, this is when there is physical contact with the digitizer. For pen, this is when the pen has physical contact with the digitizer.buttons
property. For mouse, this is when the device has at least one button depressed. For touch, this is when there is physical contact with the digitizer. For pen, this is when either the pen has physical contact with the digitizer, or at least one button is depressed while hovering.pointerId
) to produce additional events within the document, then that pointer is still considered active. Examples:
button
propertybutton
button
property in a pointermove
event will be different from that in a mousemove
event. For example, while moving the mouse with the right button pressed, the pontermove
events will have the button
value -1, but the mousemove
events will have the button
value 2.buttons
propertyCurrent state of device buttons | buttons |
---|---|
Mouse move with no buttons pressed | 0 |
Left Mouse, Touch Contact, Pen contact (with no modifier buttons pressed) | 1 |
Mouse moved with no buttons pressed, Pen moved while hovering with no buttons pressed | 0 |
Left Mouse, Touch Contact, Pen contact | 1 |
Middle Mouse | 4 |
Right Mouse, Pen contact with barrel button pressed | 2 |
Right Mouse, Pen barrel button | 2 |
X1 (back) Mouse | 8 |
X2 (forward) Mouse | 16 |
Pen contact with eraser button pressed | 32 |
Pen eraser button | 32 |
pointerenter
eventpointerdown
eventA user agent MUST fire a pointer event named pointerdown
when a pointer enters the active buttons state. For mouse, this is when the device transitions from no buttons depressed to at least one button depressed. For touch, this is when physical contact is made with the digitizer. For pen, this is when the stylus makes physical contact with the digitizer.
A user agent MUST fire a pointer event named pointerdown
when a pointer enters the active buttons state. For mouse, this is when the device transitions from no buttons depressed to at least one button depressed. For touch, this is when physical contact is made with the digitizer. For pen, this is when the pen either makes physical contact with the digitizer without any button depressed, or transitions from no buttons depressed to at least one button depressed while hovering.
pointerdown
and pointerup
are not fired for all of the same circumstances as mousedown
and mouseup
. See chorded buttons for more information.For input devices that do not support hover, a user agent MUST also fire a pointer event named pointerover
followed by a pointer event named pointerenter
prior to dispatching the pointerdown
event.
pointerdown
event (if the isPrimary
property is true
). This sets the PREVENT MOUSE EVENT FLAG on the pointer. Note, however, that this does not prevent the mouseover
, mouseenter
, mouseout
, or mouseleave
events from firing.pointermove
eventpointerup
eventA user agent MUST fire a pointer event named pointerup
when a pointer leaves the active buttons state. For mouse, this is when the device transitions from at least one button depressed to no buttons depressed. For touch, this is when physical contact is removed from the digitizer. For pen, this is when the pen is removed from physical contact with the digitizer.
A user agent MUST fire a pointer event named pointerup
when a pointer leaves the active buttons state. For mouse, this is when the device transitions from at least one button depressed to no buttons depressed. For touch, this is when physical contact is removed from the digitizer. For pen, this is when the pen is removed from the physical contact with the digitizer while no button is depressed, or transitions from at least one button depressed to no buttons depressed while hovering.
For input devices that do not support hover, a user agent MUST also fire a pointer event named pointerout
followed by a pointer event named pointerleave
after dispatching the pointerup
event.
pointerdown
and pointerup
are not fired for all of the same circumstances as mousedown
and mouseup
. See chorded buttons for more information.