Code Monkey home page Code Monkey logo

reactjs-popup's Introduction

Reactjs-popup

Build Status npm bundle size version downloads

MIT License All Contributors PRs Welcome Code of Conduct

Watch on GitHub Star on GitHub Tweet

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 [email protected]: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

Buy Me A Coffee

That's all, thank you for your attention, please Star on GitHub the repo to show your support.

we are all made of stars Star on GitHub

Maintainers


Youssouf EL Azizi

reactjs-popup's People

Contributors

abdullahtariq1171 avatar amaranth avatar avin-kavish avatar benomatis avatar creativebernadka avatar cwb6 avatar dependabot[bot] avatar dhruvparmar372 avatar jbdemonte avatar jefferyhus avatar kmarchan avatar marek-nogiec avatar marvinzeising avatar migggz avatar mouadziani avatar ndelangen avatar nelsonomuto avatar polrk avatar quasiyoke avatar rarara avatar rschristian avatar simplycomplexable avatar sloschi avatar smakosh avatar snyk-bot avatar ssnielsen avatar steevsachs avatar tsurutan avatar yjose avatar zakariaelas 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.