reactjs-popup

React Popup Component - Modals,Tooltips and Menus —  All in one

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
reactjs-popup
1,581662.0.5a year ago5 years agoMinified + gzip package size for reactjs-popup in KB

Readme

Reactjs-popup
!Build Statusbuild-badgebuild !npm bundle sizenpm-bundle-sizebuild !versionversion-badgepackage !downloadsdownloads-badgenpmtrends
!MIT Licenselicense-badgelicense All Contributors !PRs Welcomeprs-badgeprs !Code of Conductcoc-badgecoc
!Watch on GitHubgithub-watch-badgegithub-watch !Star on GitHubgithub-star-badgegithub-star !Tweettwitter-badgetwitter
Reactjs-popup is a simple react popup component that helps you create simple and complex Modals, tooltips, and Menus for your next React App.
You should consider using reactjs-popup for those couple of reasons :
  • ✅ Modal, Tooltip, Menu : All in one library 🏋️
  • ✅ Very tiny library (3kb) ⚡️
  • ✅ Fully accessible
  • ✅ Function as children pattern to take control over your popup anywhere in your code 💪
  • ✅ Easy to use 🚀
  • ✅ TypeScript Support 👌
  • ✅ IE Support. 🚀
  • ✅ Full style customization 👌 (js, CSS, styled-components)
  • ✅ Support for controlled Modals & Tooltips
  • ✅ Default & Custom Animations

Demo

This is a simple Demo to demonstrate how you can create Modals, Tooltips, Menus using reactjs-popup.
Live Demo
 reactjs popup demo

Installing / Getting started

This package is available in NPM repository as reactjs-popup. It will work correctly with all popular bundlers.
npm install reactjs-popup --save

Using yarn
yarn add reactjs-popup

Include the Component

To start using reactjs popup you just need to import the component from the reactjs-popup package.
import React from 'react';
import Popup from 'reactjs-popup';
import 'reactjs-popup/dist/index.css';

export default () => (
  <Popup trigger={<button> Trigger</button>} position="right center">
    <div>Popup content here !!</div>
  </Popup>
);
Documentation
Contributing

Clone Repo

Fork and then clone the repo
git clone git@github.com:your-username/reactjs-popup.git

Start Developing

Install all npm scripts:
npm install
or
yarn install
we use storybook to build popup use cases.
To start storybook:
yarn storybook

Run Test in watch mode
yarn test

To make contributing simply you need to create a new story for your use case under stories directory to demonstrate the new features or the bug fix .
Make Changes 😀.
If you want to contribute check out the help wanted issues for things that need fixing.
Before submitting a pull request run npm run test to run the unit tests .

Licensing

The code in this project is licensed under MIT license.
Show your support!

Sponsor

if you are interested to Sponsor this library and list your logo in this section, Make sure to contact me.

Show Your Support

src="https://cdn.buymeacoffee.com/buttons/default-orange.png" alt="Buy Me A Coffee" height="40px" />

That's all, thank you for your attention, please !Star on GitHubgithub-star-badgegithub-star the repo to show your support.
we are all made of stars !Star on GitHubgithub-star-badgegithub-star

Maintainers

<tr>
  <td align="center">
    <a href="http://elazizi.com/">
      <img width="150" height="150" src="https://github.com/yjose.png?v=3&s=150">
      </br>
      Youssouf EL Azizi
    </a>
    <div>
      <a href="https://twitter.com/ElaziziYoussouf">
        <img src="https://img.shields.io/twitter/follow/ElaziziYoussouf.svg?style=social&label=Follow" />
      </a>
    </div>
  </td>
</tr>