import * as React from 'react'; import { Platform, StyleSheet, Animated, BackHandler, Dimensions, Easing, I18nManager, TouchableWithoutFeedback, View, ScrollView, findNodeHandle, ViewStyle, type EmitterSubscription, } from 'react-native'; import type { NativeEventSubscription } from 'react-native/types'; type LayoutRectangle = { x: number; y: number; width: number; height: number }; // NOTE this is ignored in our case bcs of this.isAnchorCoord() condition const APPROX_STATUSBAR_HEIGHT = 25; type Props = { /** * Whether the Menu is currently visible. */ visible: boolean; /** * The anchor to open the menu from. In most cases, it will be a button that opens the menu. */ anchor: React.ReactNode | { x: number; y: number }; /** * Extra margin to add at the top of the menu to account for translucent status bar on Android. * If you are using Expo, we assume translucent status bar and set a height for status bar automatically. * Pass `0` or a custom value to and customize it. * This is automatically handled on iOS. */ statusBarHeight?: number; /** * Callback called when Menu is dismissed. The `visible` prop needs to be updated when this is called. */ onDismiss: () => void; /** * Accessibility label for the overlay. This is read by the screen reader when the user taps outside the menu. */ overlayAccessibilityLabel?: string; /** * Content of the `Menu`. */ children: React.ReactNode; /** * Style of menu's inner content. */ contentStyle?: ViewStyle; style?: ViewStyle; }; type Layout = { width: number; height: number }; type State = { rendered: boolean; top: number; left: number; menuLayout: Layout; anchorLayout: Layout; opacityAnimation: Animated.Value; scaleAnimation: Animated.ValueXY; }; // Minimum padding between the edge of the screen and the menu const SCREEN_INDENT = 8; // From https://material.io/design/motion/speed.html#duration const ANIMATION_DURATION = 250; // From the 'Standard easing' section of https://material.io/design/motion/speed.html#easing const EASING = Easing.bezier(0.4, 0, 0.2, 1); /** * Menus display a list of choices on temporary elevated surfaces. Their placement varies based on the element that opens them. * *
* * *
* * ## Usage * ```js * import * as React from 'react'; * import { View } from 'react-native'; * import { Button, Paragraph, Menu, Divider, Provider } from 'react-native-paper'; * * export default class MyComponent extends React.Component { * state = { * visible: false, * }; * * _openMenu = () => this.setState({ visible: true }); * * _closeMenu = () => this.setState({ visible: false }); * * render() { * return ( * * * Show menu * } * > * {}} title="Item 1" /> * {}} title="Item 2" /> * * {}} title="Item 3" /> * * * * ); * } * } * ``` */ export class Menu extends React.Component { // @component ./MenuItem.tsx // static Item = MenuItem; static defaultProps = { statusBarHeight: APPROX_STATUSBAR_HEIGHT, overlayAccessibilityLabel: 'Close menu', }; private backPressListener: NativeEventSubscription | undefined; private dimensionChangeListener: EmitterSubscription | undefined; static getDerivedStateFromProps(nextProps: Props, prevState: State) { if (nextProps.visible && !prevState.rendered) { return { rendered: true }; } return null; } state = { rendered: this.props.visible, top: 0, left: 0, menuLayout: { width: 0, height: 0 }, anchorLayout: { width: 0, height: 0 }, opacityAnimation: new Animated.Value(0), scaleAnimation: new Animated.ValueXY({ x: 0, y: 0 }), }; componentDidUpdate(prevProps: Props) { if (prevProps.visible !== this.props.visible) { this.updateVisibility(); } } componentWillUnmount() { this.removeListeners(); } anchor: View | null = null; menu: View | null = null; isAnchorCoord = () => !React.isValidElement(this.props.anchor); measureMenuLayout = () => new Promise((resolve) => { if (this.menu) { // $FlowFixMe this.menu.measureInWindow((x, y, width, height) => { resolve({ x, y, width, height }); }); } }); measureAnchorLayout = () => new Promise((resolve) => { const { anchor } = this.props; if (this.isAnchorCoord()) { // @ts-ignore resolve({ x: anchor.x, y: anchor.y, width: 0, height: 0 }); return; } if (this.anchor) { // $FlowFixMe this.anchor.measureInWindow((x, y, width, height) => { resolve({ x, y, width, height }); }); } }); updateVisibility = async () => { // Menu is rendered in Portal, which updates items asynchronously // We need to do the same here so that the ref is up-to-date await Promise.resolve(); if (this.props.visible) { this.show(); } else { this.hide(); } }; isBrowser = () => Platform.OS === 'web' && 'document' in global; focusFirstDOMNode = (el: View | null | typeof undefined) => { if (el && this.isBrowser()) { // When in the browser, we want to focus the first focusable item on toggle // For example, when menu is shown, focus the first item in the menu // And when menu is dismissed, send focus back to the button to resume tabbing const node: any = findNodeHandle(el); const focusableNode = node.querySelector( // This is a rough list of selectors that can be focused 'button, [href], input, select, textarea, [tabindex]:not([tabindex="-1"])' ); // $FlowFixMe focusableNode?.focus(); } }; handleDismiss = () => { if (this.props.visible) { this.props.onDismiss(); } return true; }; handleKeypress = (e: KeyboardEvent) => { // @ts-ignore if (e.key === 'Escape') { this.props.onDismiss(); } }; attachListeners = () => { this.backPressListener = BackHandler.addEventListener( 'hardwareBackPress', this.handleDismiss ); this.dimensionChangeListener = Dimensions.addEventListener( 'change', this.handleDismiss ); this.isBrowser() && document.addEventListener('keyup', this.handleKeypress); }; removeListeners = () => { this?.backPressListener?.remove(); this?.dimensionChangeListener?.remove(); this.isBrowser() && document.removeEventListener('keyup', this.handleKeypress); }; show = async () => { const windowLayout = Dimensions.get('window'); const [menuLayout, anchorLayout] = await Promise.all([ this.measureMenuLayout(), this.measureAnchorLayout(), ]); // When visible is true for first render // native views can be still not rendered and // measureMenuLayout/measureAnchorLayout functions // return wrong values e.g { x:0, y: 0, width: 0, height: 0 } // so we have to wait until views are ready // and rerun this function to show menu if ( !windowLayout.width || !windowLayout.height || !menuLayout.width || !menuLayout.height || (!anchorLayout.width && !this.isAnchorCoord()) || (!anchorLayout.height && !this.isAnchorCoord()) ) { // $FlowFixMe requestAnimationFrame(this.show); return; } this.setState( () => ({ left: anchorLayout.x, top: anchorLayout.y, anchorLayout: { height: anchorLayout.height, width: anchorLayout.width, }, menuLayout: { width: menuLayout.width, height: menuLayout.height, }, }), () => { this.attachListeners(); const { animation } = { animation: { scale: 1.0, }, }; Animated.parallel([ Animated.timing(this.state.scaleAnimation, { toValue: { x: menuLayout.width, y: menuLayout.height }, duration: ANIMATION_DURATION * animation.scale, easing: EASING, useNativeDriver: true, }), Animated.timing(this.state.opacityAnimation, { toValue: 1, duration: ANIMATION_DURATION * animation.scale, easing: EASING, useNativeDriver: true, }), ]).start(({ finished }) => { if (finished) { this.focusFirstDOMNode(this.menu); } }); } ); }; hide = () => { this.removeListeners(); const { animation } = { animation: { scale: 1.0, }, }; Animated.timing(this.state.opacityAnimation, { toValue: 0, duration: ANIMATION_DURATION * animation.scale, easing: EASING, useNativeDriver: true, }).start(({ finished }) => { if (finished) { this.setState({ menuLayout: { width: 0, height: 0 }, rendered: false }); this.state.scaleAnimation.setValue({ x: 0, y: 0 }); this.focusFirstDOMNode(this.anchor); } }); }; render() { const { visible, contentStyle, style, children, statusBarHeight, onDismiss, overlayAccessibilityLabel, } = this.props; const { rendered, menuLayout, anchorLayout, opacityAnimation, scaleAnimation, } = this.state; let { left, top } = this.state; // I don't know why but on Android measure function is wrong by 24 const additionalVerticalValue = Platform.select({ android: statusBarHeight, default: 0, }); const scaleTransforms = [ { scaleX: scaleAnimation.x.interpolate({ inputRange: [0, menuLayout.width], // $FlowFixMe outputRange: [0, 1], }), }, { scaleY: scaleAnimation.y.interpolate({ inputRange: [0, menuLayout.height], // $FlowFixMe outputRange: [0, 1], }), }, ]; const windowLayout = Dimensions.get('window'); // We need to translate menu while animating scale to imitate transform origin for scale animation const positionTransforms = []; // Check if menu fits horizontally and if not align it to right. if (left <= windowLayout.width - menuLayout.width - SCREEN_INDENT) { positionTransforms.push({ translateX: scaleAnimation.x.interpolate({ inputRange: [0, menuLayout.width], // $FlowFixMe outputRange: [-(menuLayout.width / 2), 0], }), }); // Check if menu position has enough space from left side if (left < SCREEN_INDENT) { left = SCREEN_INDENT; } } else { positionTransforms.push({ translateX: scaleAnimation.x.interpolate({ inputRange: [0, menuLayout.width], // $FlowFixMe outputRange: [menuLayout.width / 2, 0], }), }); left += anchorLayout.width - menuLayout.width; const right = left + menuLayout.width; // Check if menu position has enough space from right side if (right > windowLayout.width - SCREEN_INDENT) { left = windowLayout.width - SCREEN_INDENT - menuLayout.width; } } // If the menu is larger than available vertical space, // calculate the height of scrollable view let scrollableMenuHeight = 0; // Check if the menu should be scrollable if ( // Check if the menu overflows from bottom side top >= windowLayout.height - menuLayout.height - SCREEN_INDENT - additionalVerticalValue && // And bottom side of the screen has more space than top side top <= windowLayout.height - top ) { // Scrollable menu should be below the anchor (expands downwards) scrollableMenuHeight = windowLayout.height - top - SCREEN_INDENT - additionalVerticalValue; } else if ( // Check if the menu overflows from bottom side top >= windowLayout.height - menuLayout.height - SCREEN_INDENT - additionalVerticalValue && // And top side of the screen has more space than bottom side top >= windowLayout.height - top && // And menu overflows from top side top <= menuLayout.height - anchorLayout.height + SCREEN_INDENT - additionalVerticalValue ) { // Scrollable menu should be above the anchor (expands upwards) scrollableMenuHeight = top + anchorLayout.height - SCREEN_INDENT + additionalVerticalValue; } // Scrollable menu max height scrollableMenuHeight = scrollableMenuHeight > windowLayout.height - 2 * SCREEN_INDENT ? windowLayout.height - 2 * SCREEN_INDENT : scrollableMenuHeight; // Menu is typically positioned below the element that generates it // So first check if it fits below the anchor (expands downwards) if ( // Check if menu fits vertically top <= windowLayout.height - menuLayout.height - SCREEN_INDENT - additionalVerticalValue || // Or if the menu overflows from bottom side (top >= windowLayout.height - menuLayout.height - SCREEN_INDENT - additionalVerticalValue && // And bottom side of the screen has more space than top side top <= windowLayout.height - top) ) { positionTransforms.push({ translateY: scaleAnimation.y.interpolate({ inputRange: [0, menuLayout.height], // $FlowFixMe outputRange: [-((scrollableMenuHeight || menuLayout.height) / 2), 0], }), }); // Check if menu position has enough space from top side if (top < SCREEN_INDENT) { top = SCREEN_INDENT; } } else { positionTransforms.push({ translateY: scaleAnimation.y.interpolate({ inputRange: [0, menuLayout.height], // $FlowFixMe outputRange: [(scrollableMenuHeight || menuLayout.height) / 2, 0], }), }); top += anchorLayout.height - (scrollableMenuHeight || menuLayout.height); const bottom = top + (scrollableMenuHeight || menuLayout.height) + additionalVerticalValue; // Check if menu position has enough space from bottom side if (bottom > windowLayout.height - SCREEN_INDENT) { top = scrollableMenuHeight === windowLayout.height - 2 * SCREEN_INDENT ? -SCREEN_INDENT * 2 : windowLayout.height - menuLayout.height - SCREEN_INDENT - additionalVerticalValue; } } const shadowMenuContainerStyle = { opacity: opacityAnimation, transform: scaleTransforms, borderRadius: 5, ...(scrollableMenuHeight ? { height: scrollableMenuHeight } : {}), }; const positionStyle = { top: this.isAnchorCoord() ? top : top + additionalVerticalValue, ...(I18nManager.isRTL ? { right: left } : { left }), }; return rendered ? ( { this.menu = ref; }} collapsable={false} accessibilityViewIsModal={visible} style={[styles.wrapper, positionStyle, style]} pointerEvents={visible ? 'box-none' : 'none'} onAccessibilityEscape={onDismiss} > {(scrollableMenuHeight && ( {children} )) || {children}} ) : null; } } const styles = StyleSheet.create({ wrapper: { position: 'absolute', }, shadowMenuContainer: { opacity: 0, paddingVertical: 8, ...Platform.select({ android: { elevation: 8, }, default: { shadowColor: 'black', shadowOffset: { width: 0, height: 7, }, shadowOpacity: 0.24, shadowRadius: 8, }, }), }, surface: { backgroundColor: 'white', }, });