@aleksei-golovanov/rn-context-menu NPM

iOS Context Menu for React Native

Fabric Native Component wrapper for iOS UIContextMenuInteraction. Currently does nothing on Android.

Installation

npm i @aleksei-golovanov/rn-context-menu
cd ios/
RCT_NEW_ARCH_ENABLED=1 bundle exec pod install

Usage

import React from "react";
import { Image, SafeAreaView, StyleSheet, Text, View } from "react-native";

import {
  ContextMenu,
  Menu,
  MenuAction,
  SubMenu,
} from "@aleksei-golovanov/rn-context-menu";

const actions: MenuAction[] = [
  {
    title: "share",
    onPress: () => console.log("shared"),
    iosSystemImageName: "square.and.arrow.up",
  },
  {
    title: "like",
    onPress: () => console.log("liked"),
    iosSystemImageName: "hand.thumbsup",
  },
  {
    title: "dislike",
    onPress: () => console.log("disliked"),
    iosSystemImageName: "hand.thumbsdown",
    disabled: true,
  },
  {
    title: "delete",
    onPress: () => console.log("deleted"),
    iosSystemImageName: "trash",
    destructive: true,
  },
];

const submenu: SubMenu = {
  displayInline: true,
  children: [{ title: "edit", iosSystemImageName: "pencil" }],
};

const menu: Menu = {
  title: "Select what to do",
  children: [...actions, submenu],
};

const DogCard = () => (
  <View style={styles.container}>
    <Image source={require("./dog.jpg")} style={styles.image} />
    <Text style={styles.title}>DOG</Text>
  </View>
);

function App(): React.JSX.Element {
  return (
    <SafeAreaView>
      <ContextMenu menu={menu} style={styles.view}>
        <DogCard />
      </ContextMenu>
      <ContextMenu menu={menu} style={styles.view} preview={<DogCard />}>
        <Text style={styles.text}>CUSTOM PREVIEW</Text>
      </ContextMenu>
    </SafeAreaView>
  );
}

Props

`title?: string`

The title of the menu.

`children: (MenuAction | SubMenu)[]`

Menu actions or sub-menus

MenuAction

title: string; action title \ onPress?: () => void; action handler \ iosSystemImageName?: string; iOS system image (SF Symbol) \ disabled?: boolean; action is disabled \ destructive?: boolean; action is desctructive

SubMenu

title?: string; submenu title \ iosSystemImageName?: string; iOS system image (SF Symbol) \ displayInline?: boolean; an option indicating the menu displays inline with its parent menu instead of displaying as a submenu. \ children: (MenuAction | SubMenu)[] submenu actions or sub-menus