Validation

React Bootstrap 5 Validation

Provide valuable, actionable feedback to your users with HTML5 form validation, via browser default behaviors or custom styles and JavaScript.

Note: We currently recommend using custom validation styles, as native browser default validation messages are not consistently exposed to assistive technologies in all browsers (most notably, Chrome on desktop and mobile).


Basic example

For custom MDB form validation messages, you’ll need to add the noValidate boolean prop to your <MDBValidation>. This disables the browser default feedback tooltips, but still provides access to the form validation APIs in JavaScript. Try to submit the form below; our JavaScript will intercept the submit button and relay feedback to you. When attempting to submit, you’ll see the :invalid and :valid styles applied to your form controls.

Custom feedback styles apply custom colors, borders, focus styles, and background icons to better communicate feedback.

Looks good!
Looks good!
@
Please choose a username.
Please provide a valid city.
Please provide a valid zip.
You must agree before submitting.

          import React, { useState } from 'react';
          import { 
            MDBValidation, 
            MDBInput, 
            MDBBtn, 
            MDBCheckbox 
          } from 'mdb-react-ui-kit';
  
          export default function App() {
            const [formValue, setFormValue] = useState({
              fname: 'Mark',
              lname: 'Otto',
              email: '',
              city: '',
              state: '',
              zip: '',
            });
          
            const onChange = (e: any) => {
              setFormValue({ ...formValue, [e.target.name]: e.target.value });
            };

            return (
              <MDBValidation className='row g-3' noValidate>
                <div className='col-md-4'>
                  <MDBInput
                    value={formValue.fname}
                    name='fname'
                    onChange={onChange}
                    id='validationCustom01'
                    required
                    label='First name'
                    validation='Looks good!'
                  />
                </div>
                <div className='col-md-4'>
                  <MDBInput
                    value={formValue.lname}
                    name='lname'
                    onChange={onChange}
                    id='validationCustom02'
                    required
                    label='Last name'
                    validation='Looks good!'
                  />
                </div>
                <div className='col-md-4'>
                  <div className='input-group has-validation'>
                    <span className='input-group-text' id='inputGroupPrepend'>
                      @
                    </span>
                    <input
                      type='text'
                      className='form-control'
                      id='validationCustomUsername'
                      placeholder='Username'
                      required
                    />
                    <div className='invalid-feedback'>Please choose a username.</div>
                  </div>
                </div>
                <div className='col-md-6'>
                  <MDBInput
                    value={formValue.city}
                    name='city'
                    onChange={onChange}
                    id='validationCustom03'
                    required
                    label='City'
                    validation='Please provide a valid city.'
                    invalid
                  />
                </div>
                <div className='col-md-6'>
                  <MDBInput
                    value={formValue.zip}
                    name='zip'
                    onChange={onChange}
                    id='validationCustom05'
                    required
                    label='Zip'
                    validation='Please provide a valid zip.'
                    invalid
                  />
                </div>
                <div className='col-12'>
                  <MDBCheckbox
                    label='Agree to terms and conditions'
                    id='invalidCheck'
                    validation='You must agree before submitting.'
                    invalid
                    required
                  />
                </div>
                <div className='col-12'>
                  <MDBBtn type='submit'>Submit form</MDBBtn>
                </div>
              </MDBValidation>
            );
          }
        

How it works

Here’s how form validation works with MDB:

  • HTML form validation is applied via CSS’s two pseudo-classes, :invalid and :valid. It applies to <input> and <textarea> elements.
  • MDB scopes the :invalid and :valid styles to parent .was-validated class, usually applied to the <form>. Otherwise, any required field without a value shows up as invalid on page load. This way, you may choose when to activate them (typically after form submission is attempted).
  • As a fallback, .is-invalid and .is-valid classes may be used instead of the pseudo-classes for server-side validation. They do not require a .was-validated parent class.
  • Due to constraints in how CSS works, we cannot (at present) apply styles to a <label> that comes before a form control in the DOM without the help of custom JavaScript.
  • All modern browsers support the constraint validation API, a series of JavaScript methods for validating form controls.
  • Feedback messages may utilize the browser defaults (different for each browser, and unstylable via CSS) or our custom feedback styles with additional HTML and CSS.
  • You may provide custom validity messages with setCustomValidity in JavaScript.

With that in mind, consider the following demos for our custom form validation styles, optional server-side classes, and browser defaults.


Browser defaults

Not interested in custom validation feedback messages or writing JavaScript to change form behaviors? All good, you can use the browser defaults. Try submitting the form below. Depending on your browser and OS, you’ll see a slightly different style of feedback.

While these feedback styles cannot be styled with CSS, you can still customize the feedback text through JavaScript.

@

          import React, { useState } from 'react';
          import { 
            MDBInput, 
            MDBBtn, 
            MDBCheckbox 
          } from 'mdb-react-ui-kit';
  
          export default function App() {
            const [formValue, setFormValue] = useState({
              fname: 'Mark',
              lname: 'Otto',
              email: '',
              city: '',
              state: '',
              zip: '',
            });
          
            const onChange = (e: any) => {
              setFormValue({ ...formValue, [e.target.name]: e.target.value });
            };

            return (
              <form className='row g-3'>
                <div className='col-md-4'>
                  <MDBInput
                    value={formValue.fname}
                    name='fname'
                    onChange={onChange}
                    id='validationCustom01'
                    required
                    label='First name'
                  />
                </div>
                <div className='col-md-4'>
                  <MDBInput
                    value={formValue.lname}
                    name='lname'
                    onChange={onChange}
                    id='validationCustom02'
                    required
                    label='Last name'
                  />
                </div>
                <div className='col-md-4'>
                  <div className='input-group has-validation'>
                    <span className='input-group-text' id='inputGroupPrepend'>
                      @
                    </span>
                    <input
                      type='text'
                      className='form-control'
                      id='validationCustomUsername'
                      placeholder='Username'
                      required
                    />
                    <div className='invalid-feedback'>Please choose a username.</div>
                  </div>
                </div>
                <div className='col-md-6'>
                  <MDBInput
                    value={formValue.city}
                    name='city'
                    onChange={onChange}
                    id='validationCustom03'
                    required
                    label='City'
                  />
                </div>
                <div className='col-md-6'>
                  <MDBInput
                    value={formValue.zip}
                    name='zip'
                    onChange={onChange}
                    id='validationCustom05'
                    required
                    label='Zip'
                  />
                </div>
                <div className='col-12'>
                  <MDBCheckbox label='Agree to terms and conditions' id='invalidCheck2' required />
                </div>
                <div className='col-12'>
                  <MDBBtn type='submit'>Submit form</MDBBtn>
                </div>
              </form>
            );
          }
        

Server side

We recommend using client-side validation, but in case you require server-side validation, you can indicate invalid and valid form fields with .is-invalid and .is-valid. Note that .invalid-feedback is also supported with these classes.

Looks good!
Looks good!
@
Please choose a username.
Please provide a valid city.
Please provide a valid zip.
You must agree before submitting.

          import React, { useState } from 'react';
          import { 
            MDBInput, 
            MDBBtn, 
            MDBCheckbox ,
            MDBValidation
          } from 'mdb-react-ui-kit';
  
          export default function App() {
            const [formValue, setFormValue] = useState({
              fname: 'Mark',
              lname: 'Otto',
              email: '',
              city: '',
              state: '',
              zip: '',
            });
          
            const onChange = (e: any) => {
              setFormValue({ ...formValue, [e.target.name]: e.target.value });
            };

            return (
              <form className='row g-3'>
                <div className='col-md-4'>
                  <MDBInput
                    className='is-valid'
                    value={formValue.fname}
                    name='fname'
                    onChange={onChange}
                    id='validationCustom01'
                    required
                    label='First name'
                    validation='Looks good!'
                  />
                </div>
                <div className='col-md-4'>
                  <MDBInput
                    className='is-valid'
                    value={formValue.lname}
                    name='lname'
                    onChange={onChange}
                    id='validationCustom02'
                    required
                    label='Last name'
                    validation='Looks good!'
                  />
                </div>
                <div className='col-md-4'>
                  <div className='input-group has-validation'>
                    <span className='input-group-text' id='inputGroupPrepend'>
                      @
                    </span>
                    <input
                      type='text'
                      className='form-control is-invalid'
                      id='validationCustomUsername'
                      placeholder='Username'
                      required
                    />
                    <div className='invalid-feedback'>Please choose a username.</div>
                  </div>
                </div>
                <div className='col-md-6'>
                  <MDBInput
                    className='is-invalid'
                    value={formValue.city}
                    name='city'
                    onChange={onChange}
                    id='validationCustom03'
                    required
                    label='City'
                    validation='Please provide a valid city.'
                    invalid
                  />
                </div>
                <div className='col-md-6'>
                  <MDBInput
                    className='is-invalid'
                    value={formValue.zip}
                    name='zip'
                    onChange={onChange}
                    id='validationCustom05'
                    required
                    label='Zip'
                    validation='Please provide a valid zip.'
                    invalid
                  />
                </div>
                <div className='col-12'>
                  <MDBCheckbox
                    className='is-invalid'
                    label='Agree to terms and conditions'
                    id='invalidCheck3'
                    validation='You must agree before submitting.'
                    invalid
                    required
                  />
                </div>
                <div className='col-12'>
                  <MDBBtn type='submit'>Submit form</MDBBtn>
                </div>
              </form>
            );
          }
        

Supported elements

Please enter a message in the textarea.
Example invalid feedback text
More example invalid feedback text
Example invalid form file feedback

          import React from 'react';
          import { 
            MDBInput, 
            MDBBtn, 
            MDBCheckbox,
            MDBValidation
          } from 'mdb-react-ui-kit';
  
          export default function App() {
            return (
              <MDBValidation isValidated>
                <div className='mb-3 pb-1'>
                  <MDBInput
                    label='Textarea'
                    id='validationTextarea'
                    textarea
                    placeholder='Required example textarea'
                    required
                    validation='Please enter a message in the textarea.'
                    invalid
                  />
                </div>
                <div className='mb-2 pb-1'>
                  <MDBCheckbox
                    invalid
                    validation='Example invalid feedback text'
                    label='Check this checkbox'
                    id='validationFormCheck1'
                    required
                  />
                </div>
                <MDBRadio label='Toggle this radio' required id='validationFormCheck2' name='radio-stacked' />
                <MDBRadio
                  validation='More example invalid feedback text'
                  invalid
                  label='Or toggle this other radio'
                  required
                  id='validationFormCheck3'
                  name='radio-stacked'
                />

                <div className='mt-3 mb-5'>
                  <input type='file' className='form-control' aria-label='file example' required />
                  <div className='invalid-feedback'>Example invalid form file feedback</div>
                </div>
                <div>
                  <MDBBtn type='submit' disabled>
                    Submit form
                  </MDBBtn>
                </div>
              </MDBValidation>
            );
          }
        

Tooltips

Add validationTooltip prop to display validation feedback in a styled tooltip. Be sure to have a parent with position: relative on it for tooltip positioning. In the example below, our column classes have this already, but your project may require an alternative setup.

Looks good!
Looks good!
@
Please choose a unique and valid username.
Please provide a valid city.
Please provide a valid zip.

          import React, { useState } from 'react';
          import { 
            MDBInput, 
            MDBBtn, 
            MDBCheckbox,
            MDBValidation
          } from 'mdb-react-ui-kit';
  
          export default function App() {
            const [formValue, setFormValue] = useState({
              fname: 'Mark',
              lname: 'Otto',
              email: '',
              city: '',
              state: '',
              zip: '',
            });
          
            const onChange = (e: any) => {
              setFormValue({ ...formValue, [e.target.name]: e.target.value });
            };
            
            return (
              <MDBValidation className='row g-3' noValidate>
                <div className='col-md-4 position-relative'>
                  <MDBInput
                    validation='Looks good!'
                    validationTooltip
                    label='First name'
                    id='validationTooltip01'
                    name='fname'
                    value={formValue.fname}
                    onChange={onChange}
                    required
                  />
                </div>
                <div className='col-md-4 position-relative'>
                  <MDBInput
                    validation='Looks good!'
                    validationTooltip
                    label='Last name'
                    id='validationTooltip02'
                    name='lname'
                    value={formValue.lname}
                    onChange={onChange}
                    required
                  />
                </div>
                <div className='col-md-4 position-relative'>
                  <div className='input-group has-validation'>
                    <span className='input-group-text' id='inputGroupPrepend'>
                      @
                    </span>
                    <input
                      type='text'
                      className='form-control'
                      id='validationCustomUsername'
                      placeholder='Username'
                      required
                    />
                    <div className='invalid-tooltip'>Please choose a username.</div>
                  </div>
                </div>

                <div className='col-md-6 position-relative'>
                  <MDBInput
                    validation='Please provide a valid city.'
                    validationTooltip
                    label='City'
                    id='validationTooltip02'
                    name='city'
                    value={formValue.city}
                    onChange={onChange}
                    required
                    invalid
                  />
                </div>
                <div className='col-md-6 position-relative'>
                  <MDBInput
                    validation='Please provide a valid zip.'
                    validationTooltip
                    label='Zip'
                    id='validationTooltip05'
                    name='zip'
                    value={formValue.zip}
                    onChange={onChange}
                    required
                    invalid
                  />
                </div>
                <div className='col-12 pt-2'>
                  <MDBBtn type='submit'>Submit form</MDBBtn>
                </div>
              </MDBValidation>
            );
          }
        

Validation - API


Import


        import { MDBValidation } from 'mdb-react-ui-kit';
      

Properties

MDBValidation

Name Type Default Description Example
className String '' Add custom class to the MDBValidation <MDBValidation className="class" />
isValidated Boolean false Set MDBValidation form validated <MDBValidation isValidated />
noValidate Boolean false Set noValidate attribute for true <MDBValidation noValidate />