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.