Skip to content

layout.mdx

Latest commit

 

History

History
339 lines (302 loc) · 15.1 KB

layout.mdx

File metadata and controls

339 lines (302 loc) · 15.1 KB
title Layout
description Give your forms some structure—from inline to horizontal to custom grid implementations—with our form layout options.
toc true

Forms

Every group of form fields should reside in a <form> element. Bootstrap provides no default styling for the <form> element, but there are some powerful browser features that are provided by default.

  • New to browser forms? Consider reviewing the MDN form docs for an overview and complete list of available attributes.
  • <button>s within a <form> default to type="submit", so strive to be specific and always include a type.

Since Bootstrap applies display: block and width: 100% to almost all our form controls, forms will by default stack vertically. Additional classes can be used to vary this layout on a per-form basis.

Utilities

Margin utilities are the easiest way to add some structure to forms. They provide basic grouping of labels, controls, optional form text, and form validation messaging. We recommend sticking to margin-bottom utilities, and using a single direction throughout the form for consistency.

Feel free to build your forms however you like, with <fieldset>s, <div>s, or nearly any other element.

<Example code={`

Example label

Another label
`} />

Form grid

More complex forms can be built using our grid classes. Use these for form layouts that require multiple columns, varied widths, and additional alignment options. Requires the $enable-grid-classes Sass variable to be enabled (on by default).

<Example code={`

`} />

Gutters

By adding gutter modifier classes, you can have control over the gutter width in as well the inline as block direction. Also requires the $enable-grid-classes Sass variable to be enabled (on by default).

<Example code={`

`} />

More complex layouts can also be created with the grid system.

<Example code={`

Email
Password
Address
Address 2
City
State Choose... ...
Zip
Check me out
Sign in

`} />

Horizontal form

Create horizontal forms with the grid by adding the .row class to form groups and using .{breakpoint}:col-* classes (e.g. .sm:col-2) to specify the width of your labels and controls. Be sure to add .col-form-label to your <label>s as well so they’re vertically centered with their associated form controls.

At times, you maybe need to use margin or padding utilities to create that perfect alignment you need. For example, we’ve removed the padding-top on our stacked radio inputs label to better align the text baseline.

<Example code={`

Email
Password
Radios
First radio
Second radio
Third disabled radio
Example checkbox
Sign in

`} />

Horizontal form label sizing

Be sure to use .col-form-label-sm or .col-form-label-lg to your <label>s or <legend>s to correctly follow the size of .form-control-lg and .form-control-sm.

<Example code={`

Email

Email
Email
`} />

Column sizing

As shown in the previous examples, our grid system allows you to place any number of .cols within a .row. They’ll split the available width equally between them. You may also pick a subset of your columns to take up more or less space, while the remaining .cols equally split the rest, with specific column classes like .sm:col-7.

<Example code={`

`} />

Auto-sizing

The example below uses a flexbox utility to vertically center the contents and changes .col to .col-auto so that your columns only take up as much space as needed. Put another way, the column sizes itself based on the contents.

<Example code={`

Name
Username
@
Preference Choose... One Two Three
Remember me
Submit

`} />

You can then remix that once again with size-specific column classes.

<Example code={`

Name
Username
@
Preference Choose... One Two Three
Remember me
Submit

`} />

Inline forms

Use the .row-cols-* classes to create responsive horizontal layouts. By adding gutter modifier classes, we’ll have gutters in horizontal and vertical directions. On narrow mobile viewports, the .col-12 helps stack the form controls and more. The .align-items-center aligns the form elements to the middle, making checkboxes and labels align properly.

<Example code={`

Username
@

<div class="col-12">
  <label class="visually-hidden" for="inlineFormSelectPref">Preference</label>
  <select class="form-control" id="inlineFormSelectPref">
    <option selected>Choose...</option>
    <option value="1">One</option>
    <option value="2">Two</option>
    <option value="3">Three</option>
  </select>
</div>

<div class="col-12">
  <div class="form-field">
    <div class="check">
      <input type="checkbox" id="inlineFormCheck">
      <svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16'>
        <path class="checked" fill='none' stroke='currentcolor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='m4 8 3 3 5-5'/>
        <path class="indeterminate" fill='none' stroke='currentcolor' stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M4.5 8.5h6'/>
      </svg>
    </div>
    <label for="inlineFormCheck">
      Remember me
    </label>
  </div>
</div>

<div class="col-12">
  <button type="submit" class="btn-solid theme-primary">Submit</button>
</div>
`} />