Grid System

The default USF Applications grid system utilizes 12 columns, making for a non-responsive 1000px wide container.

Grid example

Basic grid HTML

For a simple two column layout, create a .grid-row and add the appropriate number of .grid-* columns. As this is a 12-column grid, each .grid-* spans a number of those 12 columns, and should always add up to 12 for each row (or the number of columns in the parent).

<div class="grid-row">
    <div class="grid-4">...</div>
    <div class="grid-8">...</div>
</div>

Offsetting columns

Increase a column's left padding using .prefix-* classes. Increase a column's right padding using .suffix-* classes. For example, .prefix-4 increases a column's left padding by four columns.

<div class="grid-row">
    <div class="grid-2">...</div>
    <div class="grid-2 prefix-4">...</div>
</div>

Rearranging columns

Move columns to the right using .push-* classes. Move columns to the left using .pull-* classes. For example, .push-4 moves a column four columns to the right.

<div class="grid-row">
    <div class="grid-2">...</div>
    <div class="grid-2 push-4">...</div>
</div>

Typography

Emphasis classes

Convey meaning through color with a handful of emphasis utility classes.

<p class="text-muted">Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>
<p class="text-info">Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>
<p class="text-success">Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>
<p class="text-warning">Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>
<p class="text-danger">Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>

Tables

Default styles

For basic styling—light padding and only horizontal dividers—add the base class .table to any <table>.

<table class="table">
    ...
</table>

Optional classes

Add any of the following classes to the .table base class:

.zebra-striped

Adds zebra-striping to any table row within the <tbody> via the :nth-child CSS selector (not available in IE7-8).

<table class="table table-striped">
    ...
</table>

.table-bordered

Add borders and rounded corners to the table.

<table class="table table-bordered">
    ...
</table>

.table-hover

Enable a hover state on table rows within a <tbody>.

<table class="table table-hover">
    ...
</table>

.table-condensed

Makes tables more compact by cutting cell padding in half.

<table class="table table-condensed">
    ...
</table>

Optional row classes

Use contextual classes to color table rows.

Class	Description
.success	Indicates a successful or positive action.
.danger	Indicates a dangerous or potentially negative action.
.warning	Indicates a warning that might need attention.
.info	Used as an alternative to the default styles.

...
    <tr class="success">
        <td>1</td>
        <td>TB - Monthly</td>
        <td>01/04/2012</td>
        <td>Approved</td>
    </tr>
...

Supported table markup

List of supported table HTML elements and how they should be used.

Tag	Description
<table>	Wrapping element for displaying data in a tabular format
<thead>	Container element for table header rows (<tr>) to label table columns
<tbody>	Container element for table rows (<tr>) in the body of the table
<tr>	Container element for a set of table cells (<td> or <th>) that appears on a single row
<td>	Default table cell
<th>	Special table cell for column (or row, depending on scope and placement) labels
<caption>	Description or summary of what the table holds, especially useful for screen readers

<table>
    <caption>...</caption>
    <thead>
        <tr>
            <th>...</th>
            <th>...</th>
        </tr>
    </thead>
    <tbody>
        <tr>
            <td>...</td>
            <td>...</td>
        </tr>
    </tbody>
</table>

Default Form Styles

Individual form controls receive styling, but without any required base class on the <form> or large changes in markup. Results in stacked, left-aligned labels on top of form controls.

Legend

Label name Example block-level help text here. 1 2 3 4 5 Check me out Submit

<form>
    <fieldset>
        <legend>Legend</legend>
        <label>Label name</label>
        <input type="text" placeholder="Type something…">
        <span class="help-block">Example block-level help text here.</span>
        <select>
            <option>1</option>
            <option>2</option>
            <option>3</option>
            <option>4</option>
            <option>5</option>
        </select>
        <label class="checkbox">
            <input type="checkbox"> Check me out
        </label>
        <button type="submit" class="btn">Submit</button>
    </fieldset>
</form>

Optional Form Layouts

Included with the USF Application Styles are three optional form layouts for common use cases.

Search form

Add .form-search to the <form> and .search-query to the <input> for an extra-rounded text input.

Search

<form class="form-search">
    <input type="text" class="grid-2 search-query">
    <button type="submit" class="btn">Search</button>
</form>

Inline form

Add .form-inline for left-aligned labels and inline-block controls for a compact layout.

Remember me Sign in

<form class="form-inline">
    <input type="text" class="grid-2" placeholder="Email">
    <input type="password" class="grid-2" placeholder="Password">
    <label class="checkbox">
        <input type="checkbox"> Remember me
    </label>
    <button type="submit" class="btn">Sign in</button>
</form>

Horizontal form

Right align labels and float them to the left to make them appear on the same line as controls. Requires the most markup changes from a default form:

• Add .form-horizontal to the form
• Wrap labels and controls in .control-group
• Add .control-label to the label
• Wrap any associated controls in .controls for proper alignment

Email

Password

Remember me Sign in

<form class="form-horizontal form-inline">
    <div class="control-group">
        <label class="control-label" for="inputEmail">Email</label>
        <div class="controls">
             <input class="grid-3" type="text" id="inputEmail" placeholder="Email">
        </div>
    </div>
    <div class="control-group">
        <label class="control-label" for="inputPassword">Password</label>
        <div class="controls">
            <input class="grid-3" type="password" id="inputPassword" placeholder="Password">
        </div>
    </div>
    <div class="control-group">
        <div class="controls">
            <label class="checkbox">
                <input type="checkbox"> Remember me
            </label>
            <button type="submit" class="btn">Sign in</button>
        </div>
    </div>
</form>

Supported Form Controls

Examples of standard form controls supported in an example form layout.

Inputs

Most common form control, text-based input fields. Includes support for all HTML5 types: text, password, datetime, datetime-local, date, month, time, week, number, email, url, search, tel, and color.

Requires the use of a specified type at all times.

<input type="text" placeholder="Text input">

Textarea

Form control which supports multiple lines of text. Change rows attribute as necessary.

<textarea rows="3"></textarea>

Checkboxes and radios

Checkboxes are for selecting one or several options in a list while radios are for selecting one option from many.

Default (stacked)

Option one is this and that—be sure to include why it's great
Option one is this and that—be sure to include why it's great Option two can be something else and selecting it will deselect option one

<label class="checkbox">
    <input type="checkbox" value="">
    Option one is this and that—be sure to include why it's great
</label>

<label class="radio">
    <input type="radio" name="optionsRadios" id="optionsRadios1" value="option1" checked>
    Option one is this and that—be sure to include why it's great
</label>
<label class="radio">
    <input type="radio" name="optionsRadios" id="optionsRadios2" value="option2">
    Option two can be something else and selecting it will deselect option one
</label>

Inline checkboxes

Add the .inline class to a series of checkboxes or radios for controls appear on the same line.

1 2 3

<label class="checkbox inline">
    <input type="checkbox" id="inlineCheckbox1" value="option1"> 1
</label>
<label class="checkbox inline">
    <input type="checkbox" id="inlineCheckbox2" value="option2"> 2
</label>
<label class="checkbox inline">
    <input type="checkbox" id="inlineCheckbox3" value="option3"> 3
</label>

Selects

Use the default option or specify a multiple="multiple" to show multiple options at once.

1 2 3 4 5
1 2 3 4 5

<select>
    <option>1</option>
    <option>2</option>
    <option>3</option>
    <option>4</option>
    <option>5</option>
</select>
     
<select multiple="multiple">
    <option>1</option>
    <option>2</option>
    <option>3</option>
    <option>4</option>
    <option>5</option>
</select>

Extending Form Controls

Adding on top of existing browser controls, Bootstrap includes other useful form components.

Prepended and appended inputs

Add text or buttons before or after any text-based input. Do note that select elements are not supported here.

Default options

Wrap an .add-on and an input with one of two classes to prepend or append text to an input.

@

.00

<div class="input-prepend">
    <span class="add-on">@</span>
    <input class="grid-2" id="prependedInput" type="text" placeholder="Username">
</div>
<div class="input-append">
    <input class="grid-2" id="appendedInput" type="text">
    <span class="add-on">.00</span>
</div>

Combined

Use both classes and two instances of .add-on to prepend and append an input.

$ .00

<div class="input-prepend input-append">
    <span class="add-on">$</span>
    <input class="grid-2" id="appendedPrependedInput" type="text">
    <span class="add-on">.00</span>
</div>

Buttons instead of text

Instead of a <span> with text, use a .btn to attach a button (or two) to an input.

Go!

<div class="input-append">
    <input class="grid-2" id="appendedInputButton" type="text">
    <button class="btn" type="button">Go!</button>
</div>

Search Options

<div class="input-append">
    <input class="grid-2" id="appendedInputButtons" type="text">
    <button class="btn" type="button">Search</button>
    <button class="btn" type="button">Options</button>
</div>

Button dropdowns

Action

• Action
• Another action
• Something else here
• Separated link

<div class="input-append">
    <input class="grid-2" id="appendedDropdownButton" type="text">
    <div class="btn-group">
        <button class="btn dropdown-toggle" data-toggle="dropdown">
            Action
            <span class="caret"></span>
        </button>
        <ul class="dropdown-menu">
            ...
        </ul>
    </div>
</div>

Action

• Action
• Another action
• Something else here
• Separated link

<div class="input-prepend">
    <div class="btn-group">
        <button class="btn dropdown-toggle" data-toggle="dropdown">
            Action
            <span class="caret"></span>
        </button>
        <ul class="dropdown-menu">
            ...
        </ul>
    </div>
    <input class="grid-2" id="prependedDropdownButton" type="text">
</div>

Action

• Action
• Another action
• Something else here
• Separated link

Action

• Action
• Another action
• Something else here
• Separated link

<div class="input-prepend input-append">
    <div class="btn-group">
        <button class="btn dropdown-toggle" data-toggle="dropdown">
            Action
            <span class="caret"></span>
        </button>
        <ul class="dropdown-menu">
            ...
        </ul>
    </div>
    <input class="grid-2" id="appendedPrependedDropdownButton" type="text">
     <div class="btn-group">
        <button class="btn dropdown-toggle" data-toggle="dropdown">
            Action
            <span class="caret"></span>
        </button>
        <ul class="dropdown-menu">
            ...
        </ul>
    </div>
</div>

Segmented dropdown groups

Action

• Action
• Another action
• Something else here
• Separated link

Action

• Action
• Another action
• Something else here
• Separated link

<form>
    <div class="input-prepend">
        <div class="btn-group">...</div>
        <input class="grid-3" type="text">
    </div>
    <div class="input-append">
        <input class="grid-3" type="text">
        <div class="btn-group">...</div>
    </div>
</form>

Search form

Search

Search

<form class="form-search">
    <div class="input-append">
        <input type="text" class="grid-2 search-query">
        <button type="submit" class="btn">Search</button>
    </div>
    <div class="input-prepend">
        <button type="submit" class="btn">Search</button>
        <input type="text" class="grid-2 search-query">
    </div>
</form>

Control sizing

Match your inputs to the grid column sizes using .grid-* classes.

Block level inputs

Make any <input> or <textarea> element behave like a block level element.

<input class="input-block-level" type="text" placeholder=".input-block-level">

Grid sizing

Use .grid-1 to .grid-12 for inputs that match the same sizes of the grid columns.

1 2 3 4 5 1 2 3 4 5 1 2 3 4 5

<input class="grid-1" type="text" placeholder=".grid-1">
<input class="grid-2" type="text" placeholder=".grid-2">
<input class="grid-3" type="text" placeholder=".grid-3">
<select class="grid-1">
    ...
</select>
<select class="grid-2">
    ...
</select>
<select class="grid-3">
    ...
</select>

For multiple grid inputs per line, use the .controls-row modifier class for proper spacing. It floats the inputs to collapse white-space, sets the proper margins, and clears the float.

<div class="controls">
    <input class="grid-5" type="text" placeholder=".grid-5">
</div>
<div class="controls grid-row">
    <input class="grid-4" type="text" placeholder=".grid-4">
    <input class="grid-1" type="text" placeholder=".grid-1">
</div>
...

Uneditable inputs

Present data in a form that's not editable without using actual form markup.

Some value here

<span class="grid-3 uneditable-input">Some value here</span>

Form actions

End a form with a group of actions (buttons). When placed within a .form-actions, the buttons will automatically indent to line up with the form controls.

Save changes Cancel

<div class="form-actions">
    <button type="submit" class="btn btn-primary">Save changes</button>
    <button type="button" class="btn">Cancel</button>
</div>

Help text

Inline and block level support for help text that appears around form controls.

Inline help

Inline help text

<input class="grid-3" type="text"><span class="help-inline">Inline help text</span>

Block help

A longer block of help text that breaks onto a new line and may extend beyond one line.

<input class="grid-3" type="text"><span class="help-block">A longer block of help text that breaks onto a new line and may extend beyond one line.</span>

Form Control States

Provide feedback to users or visitors with basic feedback states on form controls and labels.

Input focus

We remove the default outline styles on some form controls and apply a box-shadow in its place for :focus.

<input class="grid-3" id="focusedInput" type="text" value="This is focused...">

Invalid inputs

Style inputs via default browser functionality with :invalid. Specify a type, add the required attribute if the field is not optional, and (if applicable) specify a pattern.

This is not available in versions of Internet Explorer 7-9 due to lack of support for CSS pseudo selectors.

<input class="grid-3" type="email" required>

Disabled inputs

Add the disabled attribute on an input to prevent user input and trigger a slightly different look.

<input class="grid-3" id="disabledInput" type="text" placeholder="Disabled input here..." disabled>

Validation states

Bootstrap includes validation styles for danger, warning, info, and success messages. To use, add the appropriate class to the surrounding .control-group.

Input with warning

Something may have gone wrong

Input with danger

Please correct the error

Input with info

Username is already taken

Input with success

Woohoo!

<div class="control-group warning">
    <label class="control-label" for="inputWarning">Input with warning</label>
    <div class="controls">
        <input class="grid-3" type="text" id="inputWarning">
        <span class="help-inline">Something may have gone wrong</span>
    </div>
</div>
     
<div class="control-group danger">
    <label class="control-label" for="inputError">Input with danger</label>
    <div class="controls">
        <input class="grid-3" type="text" id="inputError">
        <span class="help-inline">Please correct the error</span>
    </div>
</div>
     
<div class="control-group info">
    <label class="control-label" for="inputInfo">Input with info</label>
    <div class="controls">
        <input class="grid-3" type="text" id="inputInfo">
        <span class="help-inline">Username is already taken</span>
    </div>
</div>
     
<div class="control-group success">
    <label class="control-label" for="inputSuccess">Input with success</label>
    <div class="controls">
        <input class="grid-3" type="text" id="inputSuccess">
        <span class="help-inline">Woohoo!</span>
    </div>
</div>

Buttons

Default buttons

Button styles can be applied to anything with the .btn class applied. However, typically you'll want to apply these to only <a> and <button> elements for the best rendering.

Button	class=""	Description
Default	btn	Standard gray button with gradiant
Primary	btn btn-primary	Provides extra visual weight and identifies the primary action in a set of buttons
Info	btn btn-info	Used as an alternative to the default styles
Success	btn btn-success	Indicates a successful or positive action
Warning	btn btn-warning	Indicates caution should be taken with this action
Danger	btn btn-danger	Indicates a dangerous or potentially negative action
Inverse	btn btn-inverse	Alternate dark gray button, not tied to a semantic action or use
Link	btn btn-link	Deemphasize a button by making it look like a link while maintaining button behavior

Cross browser compatibility

IE9 doesn't crop background gradients on rounded corners, so we remove it. Related, IE9 jankifies disabled button elements, rendering text gray with a nasty text-shadow that we cannot fix.

Button sizes

Fancy larger or smaller buttons? Add .btn-large, .btn-small, or .btn-mini for additional sizes.

<p>
    <button class="btn btn-large btn-primary" type="button">Large button</button>
    <button class="btn btn-large" type="button">Large button</button>
</p>
<p>
    <button class="btn btn-primary" type="button">Default button</button>
    <button class="btn" type="button">Default button</button>
</p>
<p>
    <button class="btn btn-small btn-primary" type="button">Small button</button>
    <button class="btn btn-small" type="button">Small button</button>
</p>
<p>
    <button class="btn btn-mini btn-primary" type="button">Mini button</button>
    <button class="btn btn-mini" type="button">Mini button</button>
</p>

Create block level buttons—those that span the full width of a parent— by adding .btn-block.

<button class="btn btn-large btn-block btn-primary" type="button">Block level button</button>
<button class="btn btn-large btn-block" type="button">Block level button</button>

Disabled state

Make buttons look unclickable by fading them back 50%.

Anchor element

Add the .disabled class to <a> buttons.

Primary link Link

<a href="#" class="btn btn-large btn-primary disabled">Primary link</a>
<a href="#" class="btn btn-large disabled">Link</a>

Heads up! We use .disabled as a utility class here, similar to the common .active class, so no prefix is required. Also, this class is only for aesthetic; you must use custom JavaScript to disable links here.

Button element

Add the disabled attribute to <button> buttons.

Primary button Button

<button type="button" class="btn btn-large btn-primary disabled" disabled="disabled">Primary button</button>
<button type="button" class="btn btn-large" disabled>Button</button>

One class, multiple tags

Use the .btn class on an <a>, <button>, or <input> element.

Link Button

<a class="btn" href="">Link</a>
<button class="btn" type="submit">Button</button>
<input class="btn" type="button" value="Input">
<input class="btn" type="submit" value="Submit">

As a best practice, try to match the element for your context to ensure matching cross-browser rendering. If you have an input, use an <input type="submit"> for your button.

Attribution

Originally designed and built with all the love in the world by @mdo and @fat.
Edited for University of South Florida by USF University Communications and Marketing.
Bootstrap code licensed under Apache License v2.0, documentation under CC BY 3.0.