24783 2014-02-24 13:18:58 +0000 non-normative examples for event sequences to be added to end of 11.2 2014-03-04 02:03:51 +0000 1 1 1 Unclassified PointerEventsWG Pointer Events specification unspecified PC Windows NT RESOLVED FIXED P2 normal --- 1 redux jrossi public-pointer-events public-pointer-events-bugzilla oldest_to_newest 101233 0 1439 redux 2014-02-24 13:18:58 +0000 Created attachment 1439 HTML version of proposed note As per the discussion on the list, I'd propose this additional non-normative example note at the end of 11.2 to better illustrate the kind of event sequence authors can expect to get for touchscreen taps (as Rick said, probably the most complex case that may cause the most confusion). Attached as HTML, but for ease: Example This section is non-normative. Based on the outlined algorithm, a tap with a single finger (meaning this is a primary pointer) on a touchscreen will produce the following series of pointer events and compatibility mouse events (also listing the click event, to clarify that this is fired at the very end of sequence): 1 mousemove 2 pointerover 3 mouseover 4 mouseenter 5 pointerdown 6 mousedown 7 gotpointercapture 8 (zero or more pointermove and mousemove events, depending on movement of the finger during the tap) 9 pointerup 10 mouseup 11 lostpointercapture 12 pointerout 13 mouseout 14 mouseleave 15 click. If compatibility mouse events are being suppressed by cancelling the pointerdown event, the sequence of event for the same action will be: 1 mousemove 2 pointerover 3 mouseover 4 mouseenter 5 pointerdown 6 gotpointercapture 7 (zero or more pointermove events, depending on movement of the finger during the tap) 8 pointerup 9 lostpointercapture 10 pointerout 11 mouseout 12 mouseleave 13 click 101234 1 redux 2014-02-24 13:32:07 +0000 oops, typos: "fired at the very end of sequence" > "fired at the very end of the sequence" " the sequence of event for the same action will be" > " the sequence of events for the same action will be" 101682 2 jrossi 2014-02-28 23:52:39 +0000 Here's my proposed text: "The activation of an element (click) would typically produce the following sequence: 1 mousemove 2 pointerover 3 mouseover 4 mouseenter 5 pointerdown 6 mousedown 7 (zero or more pointermove and mousemove events, depending on movement of the pointer) 8 pointerup 9 mouseup 10 click 11 pointerout 12 mouseout 13 mouseleave If, however, the pointerdown event is cancelled during this interaction then the sequence of events is: 1 mousemove 2 pointerover 3 mouseover 4 mouseenter 5 pointerdown 6 (zero or more pointermove events, depending on movement of the pointer) 7 pointerup 8 click 9 pointerout 10 mouseout 11 mouseleave" Let me know if you think this is accurate and I'll drop it in the spec. 101694 3 redux 2014-03-01 08:01:20 +0000 If we could retain a little bit of the intro text (which mentions that this is a primary pointer), and soften the para before the second list to say "would" rather than "is" to match the one before the first list, I think we're good with the following: Example This section is non-normative. The activation of an element (click) with a single finger or stylus (meaning this is a primary pointer) would typically produce the following event sequence: 1 mousemove 2 pointerover 3 mouseover 4 mouseenter 5 pointerdown 6 mousedown 7 (zero or more pointermove and mousemove events, depending on movement of the pointer) 8 pointerup 9 mouseup 10 click 11 pointerout 12 mouseout 13 mouseleave If, however, the pointerdown event is cancelled during this interaction then the sequence of events would be: 1 mousemove 2 pointerover 3 mouseover 4 mouseenter 5 pointerdown 6 (zero or more pointermove events, depending on movement of the pointer) 7 pointerup 8 click 9 pointerout 10 mouseout 11 mouseleave 101813 4 jrossi 2014-03-04 02:03:51 +0000 Changed as suggested and discussed: https://dvcs.w3.org/hg/pointerevents/rev/0fc30a2b5dfe 1439 2014-02-24 13:18:58 +0000 2014-02-24 13:18:58 +0000 HTML version of proposed note 11.2-note-non-normative-event-sequence.html text/html 2140 redux PGRpdiBjbGFzcz0ibm90ZSI+DQo8aDQ+RXhhbXBsZTwvaDQ+DQo8cD48aT5UaGlzIHNlY3Rpb24g aXMgbm9uLW5vcm1hdGl2ZS48L2k+PC9wPg0KPHA+QmFzZWQgb24gdGhlIG91dGxpbmVkIGFsZ29y aXRobSwgYSB0YXAgd2l0aCBhIHNpbmdsZSBmaW5nZXIgKG1lYW5pbmcgdGhpcyBpcyBhIHByaW1h cnkgcG9pbnRlcikgb24gYSB0b3VjaHNjcmVlbiB3aWxsIHByb2R1Y2UgdGhlIGZvbGxvd2luZyBz ZXJpZXMgb2YgcG9pbnRlciBldmVudHMgYW5kIGNvbXBhdGliaWxpdHkgbW91c2UgZXZlbnRzIChh bHNvIGxpc3RpbmcgdGhlIDxjb2RlPmNsaWNrPC9jb2RlPiBldmVudCwgdG8gY2xhcmlmeSB0aGF0 IHRoaXMgaXMgZmlyZWQgYXQgdGhlIHZlcnkgZW5kIG9mIHNlcXVlbmNlKTo8L3A+DQoNCjxvbD4N CjxsaT48Y29kZT48ZW0+bW91c2Vtb3ZlPC9lbT48L2NvZGU+PC9saT4NCjxsaT48Y29kZT48c3Ry b25nPnBvaW50ZXJvdmVyPC9zdHJvbmc+PC9jb2RlPjwvbGk+DQo8bGk+PGNvZGU+PGVtPm1vdXNl b3ZlcjwvZW0+PC9jb2RlPjwvbGk+DQo8bGk+PGNvZGU+PGVtPm1vdXNlZW50ZXI8L2VtPjwvY29k ZT48L2xpPg0KPGxpPjxjb2RlPjxzdHJvbmc+cG9pbnRlcmRvd248L3N0cm9uZz48L2NvZGU+PC9s aT4NCjxsaT48Y29kZT48ZW0+bW91c2Vkb3duPC9lbT48L2NvZGU+PC9saT4NCjxsaT48Y29kZT48 c3Ryb25nPmdvdHBvaW50ZXJjYXB0dXJlPC9zdHJvbmc+PC9jb2RlPjwvbGk+DQo8bGk+KHplcm8g b3IgbW9yZSA8Y29kZT48c3Ryb25nPnBvaW50ZXJtb3ZlPC9zdHJvbmc+PC9jb2RlPiBhbmQgPGNv ZGU+PGVtPm1vdXNlbW92ZTwvZW0+PC9jb2RlPiBldmVudHMsIGRlcGVuZGluZyBvbiBtb3ZlbWVu dCBvZiB0aGUgZmluZ2VyIGR1cmluZyB0aGUgdGFwKTwvbGk+DQo8bGk+PGNvZGU+PHN0cm9uZz5w b2ludGVydXA8L3N0cm9uZz48L2NvZGU+PC9saT4NCjxsaT48Y29kZT48ZW0+bW91c2V1cDwvZW0+ PC9jb2RlPjwvbGk+DQo8bGk+PGNvZGU+PHN0cm9uZz5sb3N0cG9pbnRlcmNhcHR1cmU8L3N0cm9u Zz48L2NvZGU+PC9saT4NCjxsaT48Y29kZT48c3Ryb25nPnBvaW50ZXJvdXQ8L3N0cm9uZz48L2Nv ZGU+PC9saT4NCjxsaT48Y29kZT48ZW0+bW91c2VvdXQ8L2VtPjwvY29kZT48L2xpPg0KPGxpPjxj b2RlPjxlbT5tb3VzZWxlYXZlPC9lbT48L2NvZGU+PC9saT4NCjxsaT48Y29kZT48ZW0+PHN0cm9u Zz5jbGljazwvc3Ryb25nPjwvZW0+PC9jb2RlPjwvbGk+DQo8L29sPg0KDQo8cD5JZiBjb21wYXRp YmlsaXR5IG1vdXNlIGV2ZW50cyBhcmUgYmVpbmcgc3VwcHJlc3NlZCBieSBjYW5jZWxsaW5nIHRo ZSA8Y29kZT5wb2ludGVyZG93bjwvY29kZT4gZXZlbnQsIHRoZSBzZXF1ZW5jZSBvZiBldmVudCBm b3IgdGhlIHNhbWUgYWN0aW9uIHdpbGwgYmU6PC9wPg0KDQo8b2w+DQo8bGk+PGNvZGU+PGVtPm1v dXNlbW92ZTwvZW0+PC9jb2RlPjwvbGk+DQo8bGk+PGNvZGU+PHN0cm9uZz5wb2ludGVyb3Zlcjwv c3Ryb25nPjwvY29kZT48L2xpPg0KPGxpPjxjb2RlPjxlbT5tb3VzZW92ZXI8L2VtPjwvY29kZT48 L2xpPg0KPGxpPjxjb2RlPjxlbT5tb3VzZWVudGVyPC9lbT48L2NvZGU+PC9saT4NCjxsaT48Y29k ZT48c3Ryb25nPnBvaW50ZXJkb3duPC9zdHJvbmc+PC9jb2RlPjwvbGk+DQo8bGk+PGNvZGU+PHN0 cm9uZz5nb3Rwb2ludGVyY2FwdHVyZTwvc3Ryb25nPjwvY29kZT48L2xpPg0KPGxpPih6ZXJvIG9y IG1vcmUgPGNvZGU+PHN0cm9uZz5wb2ludGVybW92ZTwvc3Ryb25nPjwvY29kZT4gZXZlbnRzLCBk ZXBlbmRpbmcgb24gbW92ZW1lbnQgb2YgdGhlIGZpbmdlciBkdXJpbmcgdGhlIHRhcCk8L2xpPg0K PGxpPjxjb2RlPjxzdHJvbmc+cG9pbnRlcnVwPC9zdHJvbmc+PC9jb2RlPjwvbGk+DQo8bGk+PGNv ZGU+PHN0cm9uZz5sb3N0cG9pbnRlcmNhcHR1cmU8L3N0cm9uZz48L2NvZGU+PC9saT4NCjxsaT48 Y29kZT48c3Ryb25nPnBvaW50ZXJvdXQ8L3N0cm9uZz48L2NvZGU+PC9saT4NCjxsaT48Y29kZT48 ZW0+bW91c2VvdXQ8L2VtPjwvY29kZT48L2xpPg0KPGxpPjxjb2RlPjxlbT5tb3VzZWxlYXZlPC9l bT48L2NvZGU+PC9saT4NCjxsaT48Y29kZT48ZW0+PHN0cm9uZz5jbGljazwvc3Ryb25nPjwvZW0+ PC9jb2RlPjwvbGk+DQo8L29sPg0KDQo8L2Rpdj4NCg==