react-bootstrap4-modal

react-bootstrap4-modal

A really simple implementation of Bootstrap 4 modal dialogs for React. Also works with Bootstrap 5!

Usage

import React from 'react';
import Modal from 'react-bootstrap4-modal';

class Spacecraft extends React.Component {
  // event handling methods go here

  render() {
    return (
      <Modal visible={true} onClickBackdrop={this.modalBackdropClicked}>
        <div className="modal-header">
          <h5 className="modal-title">Red Alert!</h5>
        </div>
        <div className="modal-body">
          <p>Enemy vessel approaching!</p>
        </div>
        <div className="modal-footer">
          <button type="button" className="btn btn-secondary" onClick={this.onPanic}>
            Panic
          </button>
          <button type="button" className="btn btn-primary" onClick={this.onFirePhasers}>
            Fire phasers
          </button>
        </div>
      </Modal>
    );
  }
}

With react-bootstrap4-modal, you're responsible for rendering all the inner content of the modal dialog. react-bootstrap4-modal simply provides the logic for rendering the modal itself and its backdrop. In addition, it emulates the browser shenanigans necessary to support Bootstrap 4's built-in CSS transitions (essentially, by delaying some of the effects of changing the visible prop for 150 milliseconds).

react-bootstrap4-modal also contains a ConfirmModal component, which is intended as an easy responsive replacement for the browser's confirm built-in function.

Modal Props

Prop name	Type	Description
visible	boolean (required)	Whether or not the modal is currently visible
className	string (optional)	If present, additional class names that will be added to the <div class="modal">.
dialogClassName	string (optional)	If present, additional class names that will be added to the <div class="modal-dialog"> (such as modal-lg or modal-sm).
onClickBackdrop	function (optional)	If present, a function that will be called when the user clicks on the backdrop behind the modal
wrapperProps	object (optional)	If present, additional props that will be added to the wrapper div around the modal and its backdrop.
fade	boolean (optional)	If true (default) will apply the fade class and some timeouts to fade the modal and backdrop in, if false the transition will be instant and the fade class will not be applied

Any other props besides these will be added to the <div class="modal">.

ConfirmModal Props

Prop name	Type	Description
visible	boolean (required)	Whether or not the modal is currently visible
onOK	function (required)	A function that will be called when the user clicks "OK"
okText	string (optional)	The text that is displayed on the OK button
onCancel	function (required)	A function that will be called when the user clicks "Cancel"
cancelText	string (optional)	The text that is displayed on the Cancel button
disableButtons	boolean (optional)	If true, the OK and Cancel buttons will be disabled

Any other props besides these will be passed to the Modal component this renders (so you can use any of the props from Modal here as well).

License

react-bootstrap4-modal is Copyright © 2017-2021 Nat Budin and released under the terms and conditions of the MIT License. See the COPYING file for more details.