Skip to content

mwa3aan/react-native-context-menu-view

 
 

Repository files navigation

react-native-context-menu-view

Use native context menu functionality from React Native. On iOS 13+ this uses UIMenu functionality, and on Android it uses a PopUpMenu.

On iOS 12 and below, nothing happens. You may wish to do a Platform.OS === 'ios' && parseInt(Platform.Version, 10) <= 12 check, and add your own onLongPress handler.

Getting started

$ npm install react-native-context-menu-view --save

Mostly automatic installation

cd ios/
pod install

Usage

import ContextMenu from "react-native-context-menu-view";

const Example = () => {
  return (
    <ContextMenu
      previewController={'yourRNViewClass'}
      actions={[{ title: "Title 1" }, { title: "Title 2" }]}
      onPress={(e) => {
        console.warn(
          `Pressed ${e.nativeEvent.name} at index ${e.nativeEvent.index}`
        );
      }}
    >
      <View style={styles.yourOwnStyles} />
    </ContextMenu>
  );
};

See example/ for basic usage.

Props

title

Optional. The title above the popup menu.

previewController

Optional. The name of the React Native view you want to display as a custom preview

actions

Array of { title: string, systemIcon?: string, destructive?: boolean, disabled?: boolean }.

System icon refers to an icon name within SF Symbols.

Destructive items are rendered in red on iOS, and unchanged on Android.

onPress

Optional. When the popup is opened and the user picks an option. Called with { nativeEvent: { index, name } }. Will return "preview" if the preview view was touched.

onCancel

Optional. When the popop is opened and the user cancels.

About

Use native context menus in React Native

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Objective-C 32.7%
  • Java 30.3%
  • JavaScript 16.7%
  • Ruby 15.5%
  • Starlark 4.8%