Properties

    2.   // boolean to control the state of the popover
    3.   isOpen:  PropTypes.bool,
    4.   autoFocus: PropTypes.bool,
    5.   // if modal should be centered vertically in viewport
    6.   centered: PropTypes.bool,
    7.   // corresponds to bootstrap's modal sizes, ie. 'lg' or 'sm'
    8.   size: PropTypes.string,
    9.   // callback for toggling isOpen in the controlling component
    10.   toggle:  PropTypes.func,
    11.   role: PropTypes.string, // defaults to "dialog"
    12.   // used to reference the ID of the title element in the modal
    13.   labelledBy: PropTypes.string,
    14.   keyboard: PropTypes.bool,
    15.   // control backdrop, see 
    16.   backdrop: PropTypes.oneOfType([
    17.     PropTypes.bool,
    18.     PropTypes.oneOf(['static'])
    19.   ]),
    20.   // if body of modal should be scrollable when content is long
    21.   scrollable: PropTypes.bool,
    22.   // allows for a node/component to exist next to the modal (outside of it). Useful for external close buttons
    23.   // external: PropTypes.node,
    24.   // called on componentDidMount
    25.   onEnter: PropTypes.func,
    26.   // called on componentWillUnmount
    27.   onExit: PropTypes.func,
    28.   // called when done transitioning in
    29.   onOpened: PropTypes.func,
    30.   // called when done transitioning out
    31.   onClosed: PropTypes.func,
    32.   className: PropTypes.string,
    33.   wrapClassName: PropTypes.string,
    34.   modalClassName: PropTypes.string,
    35.   backdropClassName: PropTypes.string,
    36.   contentClassName: PropTypes.string,
    37.   // boolean to control whether the fade transition occurs (default: true)
    38.   fade: PropTypes.bool,
    39.   cssModule: PropTypes.object,
    40.   // zIndex defaults to 1000.
    41.   zIndex: PropTypes.oneOfType([
    42.     PropTypes.number,
    43.     PropTypes.string,
    44.   ]),
    45.   // backdropTransition - controls backdrop transition
    46.   // timeout is 150ms by default to match bootstrap
    47.   // see Fade for more details
    48.   backdropTransition: PropTypes.shape(Fade.propTypes),
    49.   // modalTransition - controls modal transition
    50.   // timeout is 300ms by default to match bootstrap
    51.   // see  for more details
    52.   modalTransition: PropTypes.shape(Fade.propTypes),
    53.   innerRef: PropTypes.object,
    54.   // if modal should be destructed/removed from DOM after closing
    55.   unmountOnClose: PropTypes.bool // defaults to true
    56. }

    Backdrop

    1. /* eslint react/no-multi-comp: 0, react/prop-types: 0 */
    3. import React from 'react';
    4. import { Button, Modal, ModalHeader, ModalBody, ModalFooter, Input, Label, Form, FormGroup } from 'reactstrap';
    6. class ModalExample extends React.Component {
    7.   constructor(props) {
    8.     super(props);
    9.     this.state = {
    10.       modal: false,
    11.       backdrop: true
    12.     };
    14.     this.toggle = this.toggle.bind(this);
    15.     this.changeBackdrop = this.changeBackdrop.bind(this);
    16.   }
    18.   toggle() {
    19.     this.setState(prevState => ({
    20.       modal: !prevState.modal
    21.     }));
    22.   }
    24.   changeBackdrop(e) {
    25.     let value = e.target.value;
    26.     if (value !== 'static') {
    27.       value = JSON.parse(value);
    28.     }
    29.     this.setState({ backdrop: value });
    30.   }
    32.   render() {
    33.     return (
    34.       <div>
    35.         <Form inline onSubmit={(e) => e.preventDefault()}>
    36.           <FormGroup>
    37.             <Label for="backdrop">Backdrop value</Label>{' '}
    38.             <Input type="select" name="backdrop" id="backdrop" onChange={this.changeBackdrop}>
    39.               <option value="true">true</option>
    40.               <option value="false">false</option>
    41.               <option value="static">"static"</option>
    42.             </Input>
    43.           </FormGroup>
    44.           {' '}
    45.           <Button color="danger" onClick={this.toggle}>{this.props.buttonLabel}</Button>
    46.         </Form>
    47.         <Modal isOpen={this.state.modal} toggle={this.toggle} className={this.props.className} backdrop={this.state.backdrop}>
    48.           <ModalHeader toggle={this.toggle}>Modal title</ModalHeader>
    49.           <ModalBody>
    50.             Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
    51.           <ModalFooter>
    52.             <Button color="primary" onClick={this.toggle}>Do Something</Button>{' '}
    53.             <Button color="secondary" onClick={this.toggle}>Cancel</Button>
    54.           </ModalFooter>
    55.         </Modal>
    56.       </div>
    58.   }
    59. }
    61. export default ModalExample;

    Nested Modals

    Modals - 图1

    Modals with Custom Transition Timeouts

    1. /* eslint react/no-multi-comp: 0, react/prop-types: 0 */
    3. import React from 'react';
    4. import { Button, Modal, ModalHeader, ModalBody, ModalFooter } from 'reactstrap';
    6. class ModalExample extends React.Component {
    7.   constructor(props) {
    8.     super(props);
    9.     this.state = {
    10.       modal: false
    11.     };
    13.     this.toggle = this.toggle.bind(this);
    14.   }
    16.   toggle() {
    17.     this.setState(prevState => ({
    18.       modal: !prevState.modal
    19.     }));
    20.   }
    22.   render() {
    23.     return (
    24.       <div>
    25.         <Button color="danger" onClick={this.toggle}>{this.props.buttonLabel}</Button>
    26.         <Modal isOpen={this.state.modal} modalTransition={{ timeout: 700 }} backdropTransition={{ timeout: 1300 }}
    27.           toggle={this.toggle} className={this.props.className}>
    28.           <ModalHeader toggle={this.toggle}>Modal title</ModalHeader>
    29.           <ModalBody>
    30.             Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
    31.           </ModalBody>
    32.           <ModalFooter>
    33.             <Button color="primary" onClick={this.toggle}>Do Something</Button>{' '}
    34.             <Button color="secondary" onClick={this.toggle}>Cancel</Button>
    35.           </ModalFooter>
    36.         </Modal>
    37.       </div>
    38.     );
    39.   }
    40. }
    42. export default ModalExample;

    Modals without Fade Effect

    1. /* eslint react/no-multi-comp: 0, react/prop-types: 0 */
    3. import React from 'react';
    4. import { Button, Modal, ModalHeader, ModalBody, ModalFooter } from 'reactstrap';
    6. class ModalExample extends React.Component {
    7.   constructor(props) {
    8.     super(props);
    9.     this.state = {
    10.       modal: false
    11.     };
    13.     this.toggle = this.toggle.bind(this);
    14.   }
    16.   toggle() {
    17.     this.setState(prevState => ({
    18.       modal: !prevState.modal
    19.     }));
    20.   }
    22.   render() {
    23.     return (
    24.       <div>
    25.         <Button color="danger" onClick={this.toggle}>{this.props.buttonLabel}</Button>
    26.         <Modal isOpen={this.state.modal} fade={false} toggle={this.toggle} className={this.props.className}>
    27.           <ModalHeader toggle={this.toggle}>Modal title</ModalHeader>
    28.           <ModalBody>
    29.             Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
    30.           </ModalBody>
    31.           <ModalFooter>
    32.             <Button color="primary" onClick={this.toggle}>Do Something</Button>{' '}
    33.             <Button color="secondary" onClick={this.toggle}>Cancel</Button>
    34.           </ModalFooter>
    35.         </Modal>
    36.       </div>
    37.     );
    38.   }
    39. }
    41. export default ModalExample;

    Modals with external button

    Modals - 图2

    Modals with custom close icon

    1. /* eslint react/no-multi-comp: 0, react/prop-types: 0 */
    3. import React from 'react';
    4. import { Button, Modal, ModalHeader, ModalBody, ModalFooter } from 'reactstrap';
    6. class ModalExample extends React.Component {
    7.   constructor(props) {
    8.     super(props);
    9.     this.state = {
    10.       modal: false
    11.     };
    13.     this.toggle = this.toggle.bind(this);
    14.   }
    16.   toggle() {
    17.     this.setState(prevState => ({
    18.       modal: !prevState.modal
    19.     }));
    20.   }
    22.   render() {
    23.       <div>
    24.         <Button color="danger" onClick={this.toggle}>{this.props.buttonLabel}</Button>
    26.           <ModalHeader toggle={this.toggle} charCode="Y">Modal title</ModalHeader>
    27.           <ModalBody>
    28.             Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
    29.           </ModalBody>
    30.           <ModalFooter>
    31.             <Button color="primary" onClick={this.toggle}>Do Something</Button>{' '}
    32.             <Button color="secondary" onClick={this.toggle}>Cancel</Button>
    33.           </ModalFooter>
    34.         </Modal>
    35.       </div>
    36.     );
    37.   }
    38. }
    40. export default ModalExample;

    Modals with custom close button

    1. /* eslint react/no-multi-comp: 0, react/prop-types: 0 */
    3. import React from 'react';
    4. import { Button, Modal, ModalHeader, ModalBody, ModalFooter } from 'reactstrap';
    6. class ModalExample extends React.Component {
    7.   constructor(props) {
    8.     super(props);
    9.     this.state = {
    10.       modal: false
    11.     };
    13.     this.toggle = this.toggle.bind(this);
    14.   }
    16.   toggle() {
    17.     this.setState(prevState => ({
    18.       modal: !prevState.modal
    19.     }));
    20.   }
    22.   render() {
    23.       const closeBtn = <button className="close" onClick={this.toggle}>&times;</button>;
    25.       return (
    26.       <div>
    27.         <Button color="danger" onClick={this.toggle}>{this.props.buttonLabel}</Button>
    28.         <Modal isOpen={this.state.modal} toggle={this.toggle} className={this.props.className}>
    29.           <ModalHeader toggle={this.toggle} close={closeBtn}>Modal title</ModalHeader>
    30.           <ModalBody>
    31.             Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et
    32.             dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip
    33.             ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu
    34.             fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt
    35.             mollit anim id est laborum.
    36.           </ModalBody>
    37.           <ModalFooter>
    38.             <Button color="primary" onClick={this.toggle}>Do Something</Button>{' '}
    39.             <Button color="secondary" onClick={this.toggle}>Cancel</Button>
    40.           </ModalFooter>
    41.         </Modal>
    42.       </div>
    43.     );
    44.   }
    45. }
    47. export default ModalExample;

    Destructuring

    Modals - 图3

    Focus after close

    1. /* eslint react/no-multi-comp: 0, react/prop-types: 0 */
    3. import React from 'react';
    4. import { Button, Modal, ModalBody, ModalFooter, Label, Input, FormGroup, Form } from 'reactstrap';
    6. class ModalFocusAfterClose extends React.Component {
    7.     constructor() {
    8.         super();
    9.         this.state = {
    10.             open: false,
    11.             focusAfterClose: true
    12.         };
    13.         this.toggle = this.toggle.bind(this);
    14.         this.handleSelectChange = this.handleSelectChange.bind(this);
    15.     }
    17.     toggle() {
    18.         this.setState(({ open }) => ({ open: !open }));
    19.     }
    21.     handleSelectChange({target: { value }}) {
    22.         this.setState({ focusAfterClose: JSON.parse(value) });
    23.     }
    25.     render() {
    26.         return (
    27.             <div>
    28.                 <Form inline onSubmit={(e) => e.preventDefault()}>
    29.                     <FormGroup>
    30.                         <Label for="focusAfterClose">Focus After Close</Label>
    31.                         <Input className="mx-2" type="select" id="focusAfterClose" onChange={this.handleSelectChange}>
    32.                             <option value="true">Yes</option>
    33.                             <option value="false">No</option>
    34.                         </Input>
    35.                     </FormGroup>
    36.                     <Button color="danger" onClick={this.toggle}>Open</Button>
    37.                 </Form>
    38.                 <Modal returnFocusAfterClose={this.state.focusAfterClose} isOpen={this.state.open}>
    39.                     <ModalBody>
    40.                         Observe the "Open" button. It will be focused after close when "returnFocusAfterClose" is true and will not be focused if "returnFocusAfterClose" is false.
    41.                     </ModalBody>
    42.                     <ModalFooter>
    43.                         <Button color="primary" onClick={this.toggle}>Close</Button>
    44.                     </ModalFooter>
    45.                 </Modal>
    46.             </div>
    47.         )
    48.     }
    49. }