0.1.2 • Published 7 years ago

react-modaliz v0.1.2

Weekly downloads
26
License
MIT
Repository
github
Last release
7 years ago

React Modaliz

React component which provide nice and simple modal popup window

Example

https://ivanzusko.github.io/react-modaliz/

Installation

Just run

npm i react-modaliz

or (if you are using Yarn)

yarn add react-modaliz

Usage

normal variant

with custom markup which will be passed as the children:

import Modaliz from 'react-modaliz';

<Modaliz
    className="any-custom-class"
    onClose={this.closeModal}
    show={this.state.showModal}
    speed={500}
>
    <h1>You title</h1>
    <div>
        <p>Lorem inpsum</p>
    </div>
</Modaliz>

simple variant

without any children, just passed as the props title and text:

import Modaliz from 'react-modaliz';

<Modaliz
    className="any-custom-class"
    onClose={this.closeModal}
    show={this.state.showModal}
    simple
    speed={500}
    text="Lorem inpsum"
    title="You title"
/>

Under the hood title will appear as h1 and text as a p in the div

Customization

PropertyTypeisRequiredDefault valueDescription
classNamestringfalseSet your className which will get suffix -wrapper for whole modal popup component, suffix -container for modal-box and suffix -overlay for overlay. E.g.: yourName-wrapper, yourName-container, yourName-close and yourName-overlay
conditionalRenderbooleanfalsefalsein some cases, if you need conditional render (e.g.: {ifSomethingTrue && <Modaliz></Modaliz>}) you should add conditionalRender property to Modaliz component
discardDefaultsbooleanfalsefalseSet it to be true if you very badly want to discard all default styles
onCloseFunctiontrueHandler for closing the modal window
showbooleanfalsefalseflag responsible for showing Modal
simplebooleanfalsefalseIf you do not want to pass any children into Modaliz and just want to display some title and text, then set simple and just pass title and text as the props. If simple is present/true and for some reason children are passed, then children will be ignored
speednumberfalse100Speed of the fading in effect
textstringfalse''Pass any string as content of the Modaliz. Works only if simple is present/true
titlestringfalse''Pass any string as title of the Modaliz. Works only if simple is present/true

P.S.

Huge appreciation to JULIAN ĆWIRKO for his react-npm-boilerplate