Code Monkey home page Code Monkey logo

react-native-context-menu-view's Introduction

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

Objective C Notes

In order to share the main React Native RCTBridge instantiated in the AppDelegate with the preview view controller one method needs to be added to the AppDelegate in the Objective C project. AppDelegate.h needs to be updated to reflect the method and AppDelegate.m needs to be updaed to declare the bridge globally and a method to share the bridge whe requested but the POD file.

These changes are shown in the example ios project.

Javascript notes

The example project has been updated with redux tio show state managed between the main navigation and the preview view. This implimentation is conceptial and can be modified by the React Native Developer.

See example/ for basic 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>
  );
};

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.

react-native-context-menu-view's People

Contributors

mpiannucci avatar mwa3aan avatar jacobp100 avatar xotahal avatar mrousavy avatar alessandrod avatar maartenvanvliet avatar dependabot[bot] avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.