Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[TS migration] Migrate 'Pressable' component to TypeScript #30777

Merged
merged 16 commits into from
Nov 7, 2023
Merged
Show file tree
Hide file tree
Changes from 7 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/components/OpacityView.js
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ const propTypes = {
* @default []
*/
// eslint-disable-next-line react/forbid-prop-types
style: PropTypes.oneOfType([PropTypes.object, PropTypes.array]),
style: PropTypes.oneOfType([PropTypes.object, PropTypes.array, PropTypes.bool]),
blazejkustra marked this conversation as resolved.
Show resolved Hide resolved

/**
* The value to use for the opacity when the view is dimmed
Expand Down
Original file line number Diff line number Diff line change
@@ -1,23 +1,19 @@
import React, {forwardRef, useCallback, useEffect, useMemo} from 'react';
import React, {ForwardedRef, forwardRef, useCallback, useEffect, useMemo} from 'react';
// eslint-disable-next-line no-restricted-imports
import {Pressable} from 'react-native';
import _ from 'underscore';
import {GestureResponderEvent, Pressable, View, ViewStyle} from 'react-native';
import useSingleExecution from '@hooks/useSingleExecution';
import Accessibility from '@libs/Accessibility';
import HapticFeedback from '@libs/HapticFeedback';
import KeyboardShortcut from '@libs/KeyboardShortcut';
import styles from '@styles/styles';
import * as StyleUtils from '@styles/StyleUtils';
import CONST from '@src/CONST';
import genericPressablePropTypes from './PropTypes';
import PressableProps from './types';

/**
* Returns the cursor style based on the state of Pressable
* @param {Boolean} isDisabled
* @param {Boolean} isText
* @returns {Object}
*/
const getCursorStyle = (isDisabled, isText) => {
function getCursorStyle(isDisabled: boolean, isText: boolean): Pick<ViewStyle, 'cursor'> {
if (isDisabled) {
return styles.cursorDisabled;
}
Expand All @@ -27,28 +23,34 @@ const getCursorStyle = (isDisabled, isText) => {
}

return styles.cursorPointer;
};
}

const GenericPressable = forwardRef((props, ref) => {
const {
function GenericPressable(
{
children,
onPress,
onPress = () => {},
onLongPress,
onKeyPress,
onKeyDown,
disabled,
style,
shouldUseHapticsOnLongPress,
shouldUseHapticsOnPress,
disabledStyle = {},
hoverStyle = {},
focusStyle = {},
pressStyle = {},
screenReaderActiveStyle = {},
shouldUseHapticsOnLongPress = false,
shouldUseHapticsOnPress = false,
nextFocusRef,
keyboardShortcut,
shouldUseAutoHitSlop,
enableInScreenReaderStates,
shouldUseAutoHitSlop = false,
enableInScreenReaderStates = CONST.SCREEN_READER_STATES.ALL,
onPressIn,
onPressOut,
accessible = true,
...rest
} = props;

}: PressableProps,
ref: ForwardedRef<View>,
) {
const {isExecuting, singleExecution} = useSingleExecution();
const isScreenReaderActive = Accessibility.useScreenReaderStatus();
const [hitSlop, onLayout] = Accessibility.useAutoHitSlop();
Expand All @@ -63,13 +65,14 @@ const GenericPressable = forwardRef((props, ref) => {
shouldBeDisabledByScreenReader = isScreenReaderActive;
}

return props.disabled || shouldBeDisabledByScreenReader || isExecuting;
}, [isScreenReaderActive, enableInScreenReaderStates, props.disabled, isExecuting]);
// eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
return disabled || shouldBeDisabledByScreenReader || isExecuting;
}, [isScreenReaderActive, enableInScreenReaderStates, disabled, isExecuting]);

const shouldUseDisabledCursor = useMemo(() => isDisabled && !isExecuting, [isDisabled, isExecuting]);

const onLongPressHandler = useCallback(
(event) => {
(event: GestureResponderEvent) => {
if (isDisabled) {
return;
}
Expand All @@ -79,8 +82,8 @@ const GenericPressable = forwardRef((props, ref) => {
if (shouldUseHapticsOnLongPress) {
HapticFeedback.longPress();
}
if (ref && ref.current) {
ref.current.blur();
if (ref && 'current' in ref) {
ref?.current?.blur();
}
onLongPress(event);

Expand All @@ -90,7 +93,7 @@ const GenericPressable = forwardRef((props, ref) => {
);

const onPressHandler = useCallback(
(event) => {
(event?: GestureResponderEvent | KeyboardEvent) => {
if (isDisabled) {
return;
}
Expand All @@ -100,8 +103,8 @@ const GenericPressable = forwardRef((props, ref) => {
if (shouldUseHapticsOnPress) {
HapticFeedback.press();
}
if (ref && ref.current) {
ref.current.blur();
if (ref && 'current' in ref) {
ref?.current?.blur();
}
onPress(event);

Expand All @@ -110,16 +113,6 @@ const GenericPressable = forwardRef((props, ref) => {
[shouldUseHapticsOnPress, onPress, nextFocusRef, ref, isDisabled],
);

const onKeyPressHandler = useCallback(
(event) => {
if (event.key !== 'Enter') {
return;
}
onPressHandler(event);
},
[onPressHandler],
);

useEffect(() => {
if (!keyboardShortcut) {
return () => {};
Expand All @@ -135,39 +128,37 @@ const GenericPressable = forwardRef((props, ref) => {
ref={ref}
onPress={!isDisabled ? singleExecution(onPressHandler) : undefined}
onLongPress={!isDisabled && onLongPress ? onLongPressHandler : undefined}
onKeyPress={!isDisabled ? onKeyPressHandler : undefined}
onKeyDown={!isDisabled ? onKeyDown : undefined}
blazejkustra marked this conversation as resolved.
Show resolved Hide resolved
onPressIn={!isDisabled ? onPressIn : undefined}
onPressOut={!isDisabled ? onPressOut : undefined}
style={(state) => [
getCursorStyle(shouldUseDisabledCursor, [props.accessibilityRole, props.role].includes('text')),
StyleUtils.parseStyleFromFunction(props.style, state),
isScreenReaderActive && StyleUtils.parseStyleFromFunction(props.screenReaderActiveStyle, state),
state.focused && StyleUtils.parseStyleFromFunction(props.focusStyle, state),
state.hovered && StyleUtils.parseStyleFromFunction(props.hoverStyle, state),
state.pressed && StyleUtils.parseStyleFromFunction(props.pressStyle, state),
isDisabled && [...StyleUtils.parseStyleFromFunction(props.disabledStyle, state), styles.noSelect],
getCursorStyle(shouldUseDisabledCursor, [rest.accessibilityRole, rest.role].includes('text')),
StyleUtils.parseStyleFromFunction(style, state),
isScreenReaderActive && StyleUtils.parseStyleFromFunction(screenReaderActiveStyle, state),
state.focused && StyleUtils.parseStyleFromFunction(focusStyle, state),
state.hovered && StyleUtils.parseStyleFromFunction(hoverStyle, state),
state.pressed && StyleUtils.parseStyleFromFunction(pressStyle, state),
isDisabled && [StyleUtils.parseStyleFromFunction(disabledStyle, state), styles.noSelect],
]}
// accessibility props
accessibilityState={{
disabled: isDisabled,
...props.accessibilityState,
...rest.accessibilityState,
}}
aria-disabled={isDisabled}
aria-keyshortcuts={keyboardShortcut && `${keyboardShortcut.modifiers}+${keyboardShortcut.shortcutKey}`}
aria-keyshortcuts={keyboardShortcut?.modifiers.map((modifier) => `${modifier}+${keyboardShortcut.shortcutKey}`) ?? []}
// ios-only form of inputs
blazejkustra marked this conversation as resolved.
Show resolved Hide resolved
onMagicTap={!isDisabled && onPressHandler}
onAccessibilityTap={!isDisabled && onPressHandler}
onMagicTap={!isDisabled ? onPressHandler : undefined}
onAccessibilityTap={!isDisabled ? onPressHandler : undefined}
accessible={accessible}
// eslint-disable-next-line react/jsx-props-no-spreading
{...rest}
>
{(state) => (_.isFunction(props.children) ? props.children({...state, isScreenReaderActive, isDisabled}) : props.children)}
{(state) => (typeof children === 'function' ? children({...state, isScreenReaderActive, isDisabled}) : children)}
</Pressable>
);
});
}

GenericPressable.displayName = 'GenericPressable';
GenericPressable.propTypes = genericPressablePropTypes.pressablePropTypes;
GenericPressable.defaultProps = genericPressablePropTypes.defaultProps;

export default GenericPressable;
export default forwardRef(GenericPressable);
26 changes: 0 additions & 26 deletions src/components/Pressable/GenericPressable/index.js

This file was deleted.

20 changes: 0 additions & 20 deletions src/components/Pressable/GenericPressable/index.native.js

This file was deleted.

20 changes: 20 additions & 0 deletions src/components/Pressable/GenericPressable/index.native.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
import React, {ForwardedRef, forwardRef} from 'react';
import {View} from 'react-native';
import GenericPressable from './BaseGenericPressable';
import PressableProps from './types';

function NativeGenericPressable(props: PressableProps, ref: ForwardedRef<View>) {
return (
<GenericPressable
focusable
accessible
// eslint-disable-next-line react/jsx-props-no-spreading
{...props}
ref={ref}
/>
blazejkustra marked this conversation as resolved.
Show resolved Hide resolved
);
}

NativeGenericPressable.displayName = 'NativeGenericPressable';

export default forwardRef(NativeGenericPressable);
30 changes: 30 additions & 0 deletions src/components/Pressable/GenericPressable/index.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
import React, {ForwardedRef, forwardRef} from 'react';
import {Role, View} from 'react-native';
import GenericPressable from './BaseGenericPressable';
import PressableProps from './types';

function WebGenericPressable(props: PressableProps, ref: ForwardedRef<View>) {
blazejkustra marked this conversation as resolved.
Show resolved Hide resolved
return (
<GenericPressable
// eslint-disable-next-line react/jsx-props-no-spreading
{...props}
ref={ref}
// change native accessibility props to web accessibility props
tabIndex={!props.accessible || !props.focusable ? -1 : 0}
role={props.accessibilityRole as Role}
id={props.nativeID}
aria-label={props.accessibilityLabel}
aria-labelledby={props.accessibilityLabelledBy}
aria-valuenow={props.accessibilityValue?.now}
aria-valuemin={props.accessibilityValue?.min}
aria-valuemax={props.accessibilityValue?.max}
aria-valuetext={props.accessibilityValue?.text}
nativeID={props.nativeID}
dataSet={{tag: 'pressable', ...(props.noDragArea && {dragArea: false}), ...props.dataSet}}
/>
);
}

WebGenericPressable.displayName = 'WebGenericPressable';

export default forwardRef(WebGenericPressable);
Loading
Loading