React events: keyboard press, types, tests (#15314)

* Add HoverProps type
* Add more Hover event module tests
* Add more Press event module tests
* Change default longPress delay from 1000 to 500
* Rename dispatchPressEvent -> dispatchEvent
* Consolidate state updates in Press event module
* Add keyboard support for Press events
* Add FocusProps type and unit tests

Author: necolas

packages/react-events/src/Focus.js

@@ -10,10 +10,12 @@
 import type {EventResponderContext} from 'events/EventTypes';
 import {REACT_EVENT_COMPONENT_TYPE} from 'shared/ReactSymbols';
 
-const targetEventTypes = [
-  {name: 'focus', passive: true, capture: true},
-  {name: 'blur', passive: true, capture: true},
-];
+type FocusProps = {
+  disabled: boolean,
+  onBlur: (e: FocusEvent) => void,
+  onFocus: (e: FocusEvent) => void,
+  onFocusChange: boolean => void,
+};
 
 type FocusState = {
   isFocused: boolean,
@@ -27,6 +29,11 @@ type FocusEvent = {|
   type: FocusEventType,
 |};
 
+const targetEventTypes = [
+  {name: 'focus', passive: true, capture: true},
+  {name: 'blur', passive: true, capture: true},
+];
+
 function createFocusEvent(
   type: FocusEventType,
   target: Element | Document,
@@ -39,7 +46,10 @@ function createFocusEvent(
   };
 }
 
-function dispatchFocusInEvents(context: EventResponderContext, props: Object) {
+function dispatchFocusInEvents(
+  context: EventResponderContext,
+  props: FocusProps,
+) {
   const {event, eventTarget} = context;
   if (context.isTargetWithinEventComponent((event: any).relatedTarget)) {
     return;
@@ -53,19 +63,22 @@ function dispatchFocusInEvents(context: EventResponderContext, props: Object) {
     context.dispatchEvent(syntheticEvent, {discrete: true});
   }
   if (props.onFocusChange) {
-    const focusChangeEventListener = () => {
+    const listener = () => {
       props.onFocusChange(true);
     };
     const syntheticEvent = createFocusEvent(
       'focuschange',
       eventTarget,
-      focusChangeEventListener,
+      listener,
     );
     context.dispatchEvent(syntheticEvent, {discrete: true});
   }
 }
 
-function dispatchFocusOutEvents(context: EventResponderContext, props: Object) {
+function dispatchFocusOutEvents(
+  context: EventResponderContext,
+  props: FocusProps,
+) {
   const {event, eventTarget} = context;
   if (context.isTargetWithinEventComponent((event: any).relatedTarget)) {
     return;
@@ -75,13 +88,13 @@ function dispatchFocusOutEvents(context: EventResponderContext, props: Object) {
     context.dispatchEvent(syntheticEvent, {discrete: true});
   }
   if (props.onFocusChange) {
-    const focusChangeEventListener = () => {
+    const listener = () => {
       props.onFocusChange(false);
     };
     const syntheticEvent = createFocusEvent(
       'focuschange',
       eventTarget,
-      focusChangeEventListener,
+      listener,
     );
     context.dispatchEvent(syntheticEvent, {discrete: true});
   }

packages/react-events/src/Hover.js

@@ -10,12 +10,14 @@
 import type {EventResponderContext} from 'events/EventTypes';
 import {REACT_EVENT_COMPONENT_TYPE} from 'shared/ReactSymbols';
 
-const targetEventTypes = [
-  'pointerover',
-  'pointermove',
-  'pointerout',
-  'pointercancel',
-];
+type HoverProps = {
+  disabled: boolean,
+  delayHoverEnd: number,
+  delayHoverStart: number,
+  onHoverChange: boolean => void,
+  onHoverEnd: (e: HoverEvent) => void,
+  onHoverStart: (e: HoverEvent) => void,
+};
 
 type HoverState = {
   isHovered: boolean,
@@ -31,6 +33,21 @@ type HoverEvent = {|
   type: HoverEventType,
 |};
 
+// const DEFAULT_HOVER_END_DELAY_MS = 0;
+// const DEFAULT_HOVER_START_DELAY_MS = 0;
+
+const targetEventTypes = [
+  'pointerover',
+  'pointermove',
+  'pointerout',
+  'pointercancel',
+];
+
+// If PointerEvents is not supported (e.g., Safari), also listen to touch and mouse events.
+if (typeof window !== 'undefined' && window.PointerEvent === undefined) {
+  targetEventTypes.push('touchstart', 'mouseover', 'mouseout');
+}
+
 function createHoverEvent(
   type: HoverEventType,
   target: Element | Document,
@@ -43,16 +60,9 @@ function createHoverEvent(
   };
 }
 
-// In the case we don't have PointerEvents (Safari), we listen to touch events
-// too
-if (typeof window !== 'undefined' && window.PointerEvent === undefined) {
-  targetEventTypes.push('touchstart', 'mouseover', 'mouseout');
-}
-
 function dispatchHoverStartEvents(
   context: EventResponderContext,
-  props: Object,
-  state: HoverState,
+  props: HoverProps,
 ): void {
   const {event, eventTarget} = context;
   if (context.isTargetWithinEventComponent((event: any).relatedTarget)) {
@@ -67,19 +77,22 @@ function dispatchHoverStartEvents(
     context.dispatchEvent(syntheticEvent, {discrete: true});
   }
   if (props.onHoverChange) {
-    const hoverChangeEventListener = () => {
+    const listener = () => {
       props.onHoverChange(true);
     };
     const syntheticEvent = createHoverEvent(
       'hoverchange',
       eventTarget,
-      hoverChangeEventListener,
+      listener,
     );
     context.dispatchEvent(syntheticEvent, {discrete: true});
   }
 }
 
-function dispatchHoverEndEvents(context: EventResponderContext, props: Object) {
+function dispatchHoverEndEvents(
+  context: EventResponderContext,
+  props: HoverProps,
+) {
   const {event, eventTarget} = context;
   if (context.isTargetWithinEventComponent((event: any).relatedTarget)) {
     return;
@@ -93,13 +106,13 @@ function dispatchHoverEndEvents(context: EventResponderContext, props: Object) {
     context.dispatchEvent(syntheticEvent, {discrete: true});
   }
   if (props.onHoverChange) {
-    const hoverChangeEventListener = () => {
+    const listener = () => {
       props.onHoverChange(false);
     };
     const syntheticEvent = createHoverEvent(
       'hoverchange',
       eventTarget,
-      hoverChangeEventListener,
+      listener,
     );
     context.dispatchEvent(syntheticEvent, {discrete: true});
   }
@@ -116,18 +129,22 @@ const HoverResponder = {
   },
   handleEvent(
     context: EventResponderContext,
-    props: Object,
+    props: HoverProps,
     state: HoverState,
   ): void {
     const {eventType, eventTarget, event} = context;
 
     switch (eventType) {
-      case 'touchstart':
-        // Touch devices don't have hover support
+      /**
+       * Prevent hover events when touch is being used.
+       */
+      case 'touchstart': {
         if (!state.isTouched) {
           state.isTouched = true;
         }
         break;
+      }
+
       case 'pointerover':
       case 'mouseover': {
         if (
@@ -148,7 +165,7 @@ const HoverResponder = {
             state.isInHitSlop = true;
             return;
           }
-          dispatchHoverStartEvents(context, props, state);
+          dispatchHoverStartEvents(context, props);
           state.isHovered = true;
         }
         break;
@@ -172,7 +189,7 @@ const HoverResponder = {
                 (event: any).y,
               )
             ) {
-              dispatchHoverStartEvents(context, props, state);
+              dispatchHoverStartEvents(context, props);
               state.isHovered = true;
               state.isInHitSlop = false;
             }