Forms

Form control styles, layout options, and custom components.

React Bootstrap docs

Supported input types

import From from 'react-bootstrap/Form'

{/* Text input */}
<Form.Group controlId='text-input' className='mb-3'>
  <Form.Label>Text</Form.Label>
  <Form.Control defaultValue='Artisanal kale' />
</Form.Group>

{/* Search input */}
<Form.Group controlId='search-input' className='mb-3'>
  <Form.Label>Search</Form.Label>
  <Form.Control type='search' defaultValue='How do I shoot web' />
</Form.Group>

{/* Email input */}
<Form.Group controlId='email-input' className='mb-3'>
  <Form.Label>Email</Form.Label>
  <Form.Control type='email' defaultValue='email@example.com' />
</Form.Group>

{/* URL input */}
<Form.Group controlId='url-input' className='mb-3'>
  <Form.Label>URL</Form.Label>
  <Form.Control type='url' defaultValue='https://getbootstrap.com' />
</Form.Group>

{/* Tel input */}
<Form.Group controlId='tel-input' className='mb-3'>
  <Form.Label>Phone</Form.Label>
  <Form.Control type='tel' defaultValue='1-(770)-334-2518' />
</Form.Group>

{/* Password input */}
<Form.Group controlId='password-input' className='mb-3'>
  <Form.Label>Password</Form.Label>
  <Form.Control type='password' defaultValue='mypasswordexample' />
</Form.Group>

{/* Textarea */}
<Form.Group controlId='textarea-input' className='mb-3'>
  <Form.Label>Textarea</Form.Label>
  <Form.Control as='textarea' rows={5} defaultValue='Hello World!' />
</Form.Group>

{/* Select */}
<Form.Group controlId='select-input' className='mb-3'>
  <Form.Label>Select</Form.Label>
  <Form.Select defaultValue='default'>
    <option value='default' disabled>Choose option...</option>
    <option value='1'>Option item 1</option>
    <option value='2'>Option item 2</option>
    <option value='3'>Option item 3</option>
  </Form.Select>
</Form.Group>

{/* Multiselect */}
<Form.Group controlId='multiselect-input' className='mb-3'>
  <Form.Label>Multiselect</Form.Label>
  <Form.Select multiple htmlSize='3'>
    <option value='1'>Option item 1</option>
    <option value='2'>Option item 2</option>
    <option value='3'>Option item 3</option>
    <option value='4'>Option item 4</option>
    <option value='5'>Option item 5</option>
    <option value='6'>Option item 6</option>
  </Form.Select>
</Form.Group>

{/* File input */}
<Form.Group controlId='file-input' className='mb-3'>
  <Form.Label>File</Form.Label>
  <Form.Control type='file' />
</Form.Group>

{/* Number input */}
<Form.Group controlId='number-input' className='mb-3'>
  <Form.Label>Number</Form.Label>
  <Form.Control type='number' defaultValue='37' />
</Form.Group>

{/* Datalist */}
<Form.Group controlId='datalist-input' className='mb-3'>
  <Form.Label>Datalist</Form.Label>
  <Form.Control list='datalist-options' placeholder='Type to search...' />
  <datalist id='datalist-options'>
    <option value='San Francisco' />
    <option value='New York' />
    <option value='Seattle' />
    <option value='Los Angeles' />
    <option value='Chicago' />
  </datalist>
</Form.Group>

{/* Range input */}
<Form.Group controlId='range-input' className='mb-3 align-items-center'>
  <Form.Label>Range</Form.Label>
  <Form.Range />
</Form.Group>

{/* Color input */}
<Form.Group controlId='color-input' className='mb-3'>
  <Form.Label>Color</Form.Label>
  <Form.Control type='color' className='form-control-color' defaultValue='#5d3cf2' />
</Form.Group>

Floating labels

import From from 'react-bootstrap/Form'
import FloatingLabel from 'react-bootstrap/FloatingLabel'

{/* Floating label input */}
<FloatingLabel
  controlId='floating-text-input'
  label='Your name'
  className='mb-3'
  >
  <Form.Control placeholder='Your name' />
</FloatingLabel>

{/* Floating label select */}
<FloatingLabel
controlId='floating-select'
label='Choose option'
className='mb-3'
>
  <Form.Select defaultValue='default' aria-label='Floating label select example'>
    <option value='default' disabled>Open this select menu</option>
    <option value='1'>One</option>
    <option value='2'>Two</option>
    <option value='3'>Three</option>
  </Form.Select>
</FloatingLabel>

Password visibility toggle

import From from 'react-bootstrap/Form'
import PasswordToggle from '../components/PasswordToggle'

{/* Password visibility toggle */}
<Form.Group className='mb-3'>
  <Form.Label htmlFor='password-toggle-example'>Password</Form.Label>
  <PasswordToggle id='password-toggle-example' defaultValue='hidden@password' />
</Form.Group>

Checkboxes

import From from 'react-bootstrap/Form'

{/* Stacked checkboxes */}
<Form.Check
  type='checkbox'
  id='check-1'
  label='Default checkbox'
/>
<Form.Check
  type='checkbox'
  id='check-2'
  label='Checked checkbox'
  defaultChecked
/>
<Form.Check
  type='checkbox'
  id='check-3'
  label='Disabled checkbox'
  disabled
/>

{/* Inline checkboxes */}
<Form.Check
  inline
  type='checkbox'
  id='check-4'
  label='Default checkbox'
/>
<Form.Check
  inline
  type='checkbox'
  id='check-5'
  label='Checked checkbox'
  defaultChecked
/>
<Form.Check
  inline
  type='checkbox'
  id='check-6'
  label='Disabled checkbox'
  disabled
/>

Radios

import From from 'react-bootstrap/Form'

{/* Stacked radio buttons */}
<Form.Check
  type='radio'
  id='radio-1'
  name='radio'
  label='Default radio'
/>
<Form.Check
  type='radio'
  id='radio-2'
  name='radio'
  label='Checked radio'
  defaultChecked
/>
<Form.Check
  type='radio'
  id='radio-3'
  name='radio'
  label='Disabled radio'
  disabled
/>

{/* Inline radio buttons */}
<Form.Check
  inline
  type='radio'
  id='radio-4'
  name='radio2'
  label='Default radio'
/>
<Form.Check
  inline
  type='radio'
  id='radio-5'
  name='radio2'
  label='Checked radio'
  defaultChecked
/>
<Form.Check
  inline
  type='radio'
  id='radio-6'
  name='radio2'
  label='Disabled radio'
  disabled
/>

Switches

import From from 'react-bootstrap/Form'

{/* Default switch */}
<Form.Check
  type='switch'
  id='switch-1'
  label='Default switch'
/>

{/* Checked switch */}
<Form.Check
  type='switch'
  id='switch-2'
  label='Checked switch'
  defaultChecked
/>

{/* Disabled switch */}
<Form.Check
  type='switch'
  id='switch-3'
  label='Disabled switch'
  disabled
/>

Range slider (noUISlider)

Two handles + inputs
$ 280
$ 720
$
$
One handle + no inputs
$ 450
{/* Example of Range slider with 2-way binded inputs */}

import { useState } from 'react'
import InputGroup from 'react-bootstrap/InputGroup'
import Form from 'react-bootstrap/Form'
import ReactSlider from 'react-slider'

const RangeSliderExample = () => {

  const [minPrice, setMinPrice] = useState(280)
  const [maxPrice, setMaxPrice] = useState(720)

  const handleInputChange = e => {
    if (e.target.name === 'minPrice') {
      setMinPrice(e.target.value)
    } else {
      setMaxPrice(e.target.value)
    }
  }

  const handleSliderChange = sliderVal => {
    let sliderMinVal = sliderVal[0]
    let sliderMaxVal = sliderVal[1]
    setMinPrice(sliderMinVal)
    setMaxPrice(sliderMaxVal)
  }

  retun (
    <Form.Group className='mb-3'>
      <h6 className='fs-base'>Two handles + inputs</h6>
      <ReactSlider
        className='range-slider'
        thumbClassName='range-slider-handle'
        trackClassName='range-slider-track'
        min={0}
        max={1000}
        value={[minPrice, maxPrice]}
        ariaLabel={['Lower handle', 'Upper handle']}
        ariaValuetext={state => `Handle value ${state.valueNow}`}
        step={1}
        renderThumb={(props, state) => (<div {...props}>
          <div className='range-slider-tooltip'>$ {state.valueNow}</div>
        </div>)}
        pearling
        minDistance={50}
        onChange={handleSliderChange}
      />
      <div className='d-flex align-items-center'>
        <div className='w-100 pe-2'>
          <InputGroup>
            <InputGroup.Text className='fs-base'>$</InputGroup.Text>
            <Form.Control
              name='minPrice'
              value={minPrice}
              onChange={handleInputChange}
            />
          </InputGroup>
        </div>
        <div className='text-muted'>—</div>
        <div className='w-100 ps-2'>
          <InputGroup>
            <InputGroup.Text className='fs-base'>$</InputGroup.Text>
            <Form.Control
              name='maxPrice'
              value={maxPrice}
              onChange={handleInputChange}
            />
          </InputGroup>
        </div>
      </div>
    </Form.Group>
  )
}

render(<RangeSliderExample />)


{/* Example of Range slider with single handle */}

import Form from 'react-bootstrap/Form'
import ReactSlider from 'react-slider'

<Form.Group className='py-2' style={{maxWidth: '20rem'}}>
  <h6 className='fs-base'>One handle + no inputs</h6>
  <ReactSlider
    className='range-slider range-slider-single'
    thumbClassName='range-slider-handle'
    trackClassName='range-slider-track'
    min={0}
    max={1000}
    defaultValue={450}
    ariaLabel={['Handle']}
    ariaValuetext={state => `Handle value ${state.valueNow}`}
    step={1}
    renderThumb={(props, state) => (<div {...props}>
      <div className='range-slider-tooltip'>$ {state.valueNow}</div>
    </div>)}
  />
</Form.Group>

Sizing

import Form from 'react-bootstrap/Form'
          
{/* Large input */}
<Form.Group controlId='input-lg' className='mb-3'>
  <Form.Label>Large input</Form.Label>
  <Form.Control size='lg' placeholder='Large input placeholder' />
</Form.Group>

{/* Normal input */}
<Form.Group controlId='input-normal' className='mb-3'>
  <Form.Label>Normal input</Form.Label>
  <Form.Control placeholder='Normal input placeholder' />
</Form.Group>

{/* Small input */}
<Form.Group controlId='input-small' className='mb-3'>
  <Form.Label className='fs-sm'>Small input</Form.Label>
  <Form.Control size='sm' placeholder='Small input placeholder' />
</Form.Group>

{/* Large select */}
<Form.Group controlId='select-lg' className='mb-3'>
  <Form.Label>Large select</Form.Label>
  <Form.Select size='lg' defaultValue='default'>
    <option value='default' disabled>Large select option</option>
    <option value='1'>Option item 1</option>
    <option value='2'>Option item 2</option>
    <option value='3'>Option item 3</option>
  </Form.Select>
</Form.Group>

{/* Normal select */}
<Form.Group controlId='select-normal' className='mb-3'>
  <Form.Label>Normal select</Form.Label>
  <Form.Select defaultValue='default'>
    <option value='default' disabled>Normal select option</option>
    <option value='1'>Option item 1</option>
    <option value='2'>Option item 2</option>
    <option value='3'>Option item 3</option>
  </Form.Select>
</Form.Group>

{/* Small select */}
<Form.Group controlId='select-sm' className='mb-3'>
  <Form.Label className='fs-sm'>Small select</Form.Label>
  <Form.Select size='sm' defaultValue='default'>
    <option value='default' disabled>Small select option</option>
    <option value='1'>Option item 1</option>
    <option value='2'>Option item 2</option>
    <option value='3'>Option item 3</option>
  </Form.Select>
</Form.Group>

Readonly & disabled

import Form from 'react-bootstrap/Form'
          
{/* Readonly input */}
<Form.Control readOnly placeholder='Readonly input placeholder' />

{/* Disabled input */}
<Form.Control disabled placeholder='Disabled input placeholder' />

{/* Disabled select */}
<Form.Select defaultValue='default' disabled>
  <option value='default' disabled>Disabled select</option>
  <option value='1'>Option item 1</option>
  <option value='2'>Option item 2</option>
  <option value='3'>Option item 3</option>
</Form.Select>

Inline form

import Form from 'react-bootstrap/Form'
import Button from 'react-bootstrap/Button'
import Row from 'react-bootstrap/Row'
import Col from 'react-bootstrap/Col'
          
{/* Build inline forms with Row and Col */}
<Row as='form' className='row-cols-sm-auto g-3 align-items-center'>
  <Col xs={12}>
    <Form.Control placeholder='Username' />
  </Col>
  <Col xs={12}>
    <Form.Select defaultValue='default'>
      <option value='default' disabled>Choose...</option>
      <option value='1'>Option item 1</option>
      <option value='2'>Option item 2</option>
      <option value='3'>Option item 3</option>
    </Form.Select>
  </Col>
  <Col xs={12}>
    <Form.Check
      type='checkbox'
      id='inline-checkbox'
      label='Remember me'
    />
  </Col>
  <Col xs={12}>
    <Button type='submit'>Submit</Button>
  </Col>
</Row>

Help text

Your password must be 8-20 characters long, contain letters and numbers, and must not contain spaces, special characters, or emoji.
import Form from 'react-bootstrap/Form'
          
{/* Form help text example */}
<Form.Group controlId='input-password'>
  <Form.Label>Password</Form.Label>
  <Form.Control type='password' aria-describedby='passwordHelpBlock' />
  <Form.Text id='passwordHelpBlock'>Your password must be 8-20 characters long, contain letters and numbers, and must not contain spaces, special characters, or emoji.</Form.Text>
</Form.Group>

Validation: status text

Looks good!
Looks good!
@
Please choose a username.
Please provide a valid city.
Please provide a valid state.
Please provide a valid zip.
You must agree before submitting.
import { useState } from 'react'
import Form from 'react-bootstrap/Form'
import Button from 'react-bootstrap/Button'

{/* Form validation status text example */}
const FormExample = () => {
  const [validated, setValidated] = useState(false)
  const handleSubmit = (event) => {
    const form = event.currentTarget
    if (form.checkValidity() === false) {
      event.preventDefault()
      event.stopPropagation()
    }

    setValidated(true);
  }

  return (
    <Form noValidate validated={validated} onSubmit={handleSubmit}>
      <Row>
        <Form.Group as={Col} md='4' className='mb-3' controlId='validationCustom01'>
          <Form.Label>First name</Form.Label>
          <Form.Control
            required
            type='text'
            placeholder='First name'
            defaultValue='John'
          />
          <Form.Control.Feedback>Looks good!</Form.Control.Feedback>
        </Form.Group>
        <Form.Group as={Col} md='4' className='mb-3' controlId='validationCustom02'>
          <Form.Label>Last name</Form.Label>
          <Form.Control
            required
            type='text'
            placeholder='Last name'
            defaultValue='Doe'
          />
          <Form.Control.Feedback>Looks good!</Form.Control.Feedback>
        </Form.Group>
        <Form.Group as={Col} md='4' className='mb-3' controlId='validationCustomUsername'>
          <Form.Label>Username</Form.Label>
          <InputGroup hasValidation>
            <InputGroup.Text id='inputGroupPrepend'>@</InputGroup.Text>
            <Form.Control
              type='text'
              placeholder='Username'
              aria-describedby='inputGroupPrepend'
              required
            />
            <Form.Control.Feedback type='invalid'>
              Please choose a username.
            </Form.Control.Feedback>
          </InputGroup>
        </Form.Group>
      </Row>
      <Row>
        <Form.Group as={Col} md='6' className='mb-3' controlId='validationCustom03'>
          <Form.Label>City</Form.Label>
          <Form.Control type='text' placeholder='City' required />
          <Form.Control.Feedback type='invalid'>
            Please provide a valid city.
          </Form.Control.Feedback>
        </Form.Group>
        <Form.Group as={Col} md='3' className='mb-3' controlId='validationCustom04'>
          <Form.Label>State</Form.Label>
          <Form.Control type='text' placeholder='State' required />
          <Form.Control.Feedback type='invalid'>
            Please provide a valid state.
          </Form.Control.Feedback>
        </Form.Group>
        <Form.Group as={Col} md='3' className='mb-3' controlId='validationCustom05'>
          <Form.Label>Zip</Form.Label>
          <Form.Control type='text' placeholder='Zip' required />
          <Form.Control.Feedback type='invalid'>
            Please provide a valid zip.
          </Form.Control.Feedback>
        </Form.Group>
      </Row>
      <Form.Group className='mb-3'>
        <Form.Check
          required
          id='validationCheck'
          label='Agree to terms and conditions'
          feedback='You must agree before submitting.'
          feedbackType='invalid'
        />
      </Form.Group>
      <Button type='submit'>Submit form</Button>
    </Form>
  )
}

render(<FormExample />)

Validation: status tooltips

Looks good!
Looks good!
@
Please choose a username.
Please provide a valid city.
Please provide a valid state.
Please provide a valid zip.
You must agree before submitting.
import { useState } from 'react'
import Form from 'react-bootstrap/Form'
import Button from 'react-bootstrap/Button'

{/* Form validation status tooltips example */}
const FormExample = () => {
  const [validated, setValidated] = useState(false)
  const handleSubmit = (event) => {
    const form = event.currentTarget
    if (form.checkValidity() === false) {
      event.preventDefault()
      event.stopPropagation()
    }

    setValidated(true);
  }

  return (
    <Form noValidate validated={validated} onSubmit={handleSubmit}>
      <Row>
        <Form.Group as={Col} md='4' className='mb-3' controlId='validationCustom01'>
          <Form.Label>First name</Form.Label>
          <Form.Control
            required
            type='text'
            placeholder='First name'
            defaultValue='John'
          />
          <Form.Control.Feedback tooltip>Looks good!</Form.Control.Feedback>
        </Form.Group>
        <Form.Group as={Col} md='4' className='mb-3' controlId='validationCustom02'>
          <Form.Label>Last name</Form.Label>
          <Form.Control
            required
            type='text'
            placeholder='Last name'
            defaultValue='Doe'
          />
          <Form.Control.Feedback tooltip>Looks good!</Form.Control.Feedback>
        </Form.Group>
        <Form.Group as={Col} md='4' className='mb-3' controlId='validationCustomUsername'>
          <Form.Label>Username</Form.Label>
          <InputGroup hasValidation>
            <InputGroup.Text id='inputGroupPrepend'>@</InputGroup.Text>
            <Form.Control
              type='text'
              placeholder='Username'
              aria-describedby='inputGroupPrepend'
              required
            />
            <Form.Control.Feedback type='invalid' tooltip>
              Please choose a username.
            </Form.Control.Feedback>
          </InputGroup>
        </Form.Group>
      </Row>
      <Row>
        <Form.Group as={Col} md='6' className='mb-3' controlId='validationCustom03'>
          <Form.Label>City</Form.Label>
          <Form.Control type='text' placeholder='City' required />
          <Form.Control.Feedback type='invalid' tooltip>
            Please provide a valid city.
          </Form.Control.Feedback>
        </Form.Group>
        <Form.Group as={Col} md='3' className='mb-3' controlId='validationCustom04'>
          <Form.Label>State</Form.Label>
          <Form.Control type='text' placeholder='State' required />
          <Form.Control.Feedback type='invalid' tooltip>
            Please provide a valid state.
          </Form.Control.Feedback>
        </Form.Group>
        <Form.Group as={Col} md='3' className='mb-3' controlId='validationCustom05'>
          <Form.Label>Zip</Form.Label>
          <Form.Control type='text' placeholder='Zip' required />
          <Form.Control.Feedback type='invalid' tooltip>
            Please provide a valid zip.
          </Form.Control.Feedback>
        </Form.Group>
      </Row>
      <Form.Group className='mb-3'>
        <Form.Check
          required
          id='validationCheck'
          label='Agree to terms and conditions'
          feedback='You must agree before submitting.'
          feedbackType='invalid'
          feedbackTooltip
        />
      </Form.Group>
      <Button type='submit'>Submit form</Button>
    </Form>
  )
}

render(<FormExample />)

Format input value

import Form from 'react-bootstrap/Form'
import NumberFormat from 'react-number-format'

{/* Card number format example */}
<Form.Group controlId='card-number' className='mb-3'>
  <Form.Label>Card number</Form.Label>
  <Form.Control
    as={NumberFormat}
    format='#### #### #### ####'
    placeholder='0000 0000 0000 0000'
  />
</Form.Group>

{/* Card CVC format example */}
<Form.Group controlId='card-cvc' className='mb-3'>
  <Form.Label>Card CVC</Form.Label>
  <Form.Control
    as={NumberFormat}
    format='###'
    placeholder='000'
  />
</Form.Group>

{/* Date format example */}
<Form.Group controlId='date' className='mb-3'>
  <Form.Label>Date</Form.Label>
  <Form.Control
    as={NumberFormat}
    format='##/##'
    placeholder='mm/yy'
  />
</Form.Group>

{/* Date long format example */}
<Form.Group controlId='date-long' className='mb-3'>
  <Form.Label>Date</Form.Label>
  <Form.Control
    as={NumberFormat}
    format='####-##-##'
    placeholder='yyyy-mm-dd'
  />
</Form.Group>

{/* Time format example */}
<Form.Group controlId='time' className='mb-3'>
  <Form.Label>Time</Form.Label>
  <Form.Control
    as={NumberFormat}
    format='##:##:##'
    placeholder='hh:mm:ss'
  />
</Form.Group>

{/* Phone format example */}
<Form.Group controlId='phone' className='mb-3'>
  <Form.Label>Phone</Form.Label>
  <Form.Control
    as={NumberFormat}
    format='+1(##) ###-####'
    placeholder='+1(00) 000-0000'
  />
</Form.Group>

Light version

import Form from 'react-bootstrap/Form'
import PasswordToggle from '../components/PasswordToggle'

{/* Light input */}
<Form.Group controlId='light-input' className='mb-3'>
  <Form.Label className='text-light'>Light input</Form.Label>
  <Form.Control className='form-control-light' defaultValue='Artisanal kale' />
</Form.Group>

{/* Light select */}
<Form.Group controlId='light-select' className='mb-3'>
  <Form.Label className='text-light'>Light select</Form.Label>
  <Form.Select className='form-select-light' defaultValue='default'>
    <option value='default' disabled>Choose option...</option>
    <option value='1'>Option item 1</option>
    <option value='2'>Option item 2</option>
    <option value='3'>Option item 3</option>
  </Form.Select>
</Form.Group>

{/* Light password visibility toggle */}
<Form.Group className='mb-3'>
  <Form.Label htmlFor='light-password' className='text-light'>Password</Form.Label>
  <PasswordToggle light id='light-password' defaultValue='hidden@password' />
</Form.Group>

{/* Light textarea */}
<Form.Group controlId='light-textarea' className='mb-3'>
  <Form.Label className='text-light'>Light textarea</Form.Label>
  <Form.Control as='textarea' rows={5} className='form-control-light' defaultValue='Hello World!' />
</Form.Group>

{/* Light checkbox */}
<Form.Check
  type='checkbox'
  id='light-check-1'
  label='Light checkbox'
  className='form-check-light'
/>

{/* Light radio */}
<Form.Check
  type='radio'
  id='light-radio-1'
  name='light-radio'
  label='Light radio'
  className='form-check-light'
/>

{/* Light switch */}
<Form.Check
  type='switch'
  id='light-switch-1'
  label='Light switch'
  className='form-switch-light'
/>