--- layout: default title: Components ---

Components

Dozens of reusable components built to provide navigation, alerts, popovers, and more.

Button groups

Group a series of buttons together on a single line with the button group. Add on optional JavaScript radio and checkbox style behavior with our buttons plugin.

Single button group

Wrap a series of buttons with .btn in .btn-group.

{% highlight html linenos %}
{% endhighlight %}

Multiple button groups

Combine sets of <div class="btn-group"> into a <div class="btn-toolbar"> for more complex components.

{% highlight html linenos %}
...
...
...
{% endhighlight %}

Vertical button groups

Make a set of buttons appear vertically stacked rather than horizontally.

{% highlight html linenos %}
...
{% endhighlight %}

Justified button groups

Make a group of buttons stretch at the same size to span the entire width of its parent. This only works with <a> elements as the <button> doesn't pick up these styles.

Left Right Middle
{% highlight html linenos %}
...
{% endhighlight %}

Button dropdown menus

Use any button to trigger a dropdown menu by placing it within a .btn-group and providing the proper menu markup. Requires the Bootstrap dropdown plugin.

Single or split button

Turn a button into dropdown toggle, or add a second button to toggle the dropdown while retaining the primary button action.

{% highlight html linenos %}
{% endhighlight %}

Works with all button sizes

Button dropdowns work at any size: .btn-large, .btn-small, or .btn-mini.

{% highlight html linenos %}
    ...
    ...
    ...
{% endhighlight %}

Dropup buttons

Trigger dropdown menus above elements by adding .dropup to the parent.

{% highlight html linenos %}
{% endhighlight %}

Pagination

Provide pagination links for your site or app with the multi-page pagination component, or the simpler pager alternative.

Standard pagination

Simple pagination inspired by Rdio, great for apps and search results. The large block is hard to miss, easily scalable, and provides large click areas.

{% highlight html linenos %} {% endhighlight %}

Disabled and active states

Links are customizable for different circumstances. Use .disabled for unclickable links and .active to indicate the current page.

{% highlight html linenos %} {% endhighlight %}

You can optionally swap out active or disabled anchors for <span> to remove click functionality while retaining intended styles.

{% highlight html linenos %}
  • «
  • 1
    • ...
{% endhighlight %}

Sizes

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

{% highlight html linenos %}
    ...
    ...
    ...
    ...
{% endhighlight %}

Pager

Quick previous and next links for simple pagination implementations with light markup and styles. It's great for simple sites like blogs or magazines.

Default example

By default, the pager centers links.

{% highlight html linenos %} {% endhighlight %}

Aligned links

Alternatively, you can align each link to the sides:

{% highlight html linenos %} {% endhighlight %}

Optional disabled state

Pager links also use the general .disabled utility class from the pagination.

{% highlight html linenos %} {% endhighlight %}

Labels

Example

Example heading New

Example heading New

Example heading New

Example heading New

Example heading New
Example heading New
{% highlight html linenos %}

Example heading New

{% endhighlight %}

Available variations

Add any of the below mentioned modifier classes to change the appearance of a label.

Labels Markup
Default <span class="label">Default</span>
Success <span class="label label-success">Success</span>
Warning <span class="label label-warning">Warning</span>
Danger <span class="label label-danger">Danger</span>
Info <span class="label label-info">Info</span>

Badges

Easily highlight new or unread items by adding a <span class="badge"> to links, Bootstrap navs, and more.

Inbox 42
{% highlight html linenos %} Inbox 42 {% endhighlight %}

Self collapsing

When there are no new or unread items, badges will simply collapse (via CSS's :empty selector) provided no content exists within.

Adapts to active nav states

Built-in styles are included for placing badges in active states in pill and list navigations.


{% highlight html linenos %} {% endhighlight %}

Typographic components

Jumbotron

A lightweight, flexible component to showcase key content on your site. It works well on marketing and content-heavy sites.

Hello, world!

This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.

Learn more

{% highlight html linenos %}

Hello, world!

...

Learn more

{% endhighlight %}

Page header

A simple shell for an h1 to appropriately space out and segment sections of content on a page. It can utilize the h1's default small, element as well most other components (with additional styles).

Example page header Subtext for header

{% highlight html linenos %}

Example page header Subtext for header

{% endhighlight %}

Thumbnails

Extend Bootstrap's grid system with the thumbnail component to easily display grids of images, videos, text, and more.

Default thumbnails

By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.

{% highlight html linenos %}
...
{% endhighlight %}

Custom content thumbnails

With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.

Thumbnail label

Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

Action Action

Thumbnail label

Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

Action Action

Thumbnail label

Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

Action Action

{% highlight html linenos %}

Thumbnail label

...

Action Action

{% endhighlight %}

Alerts

Provide contextual feedback messages for typical user actions with the handful of available and flexible alert messages. For inline dismissal, use the alerts jQuery plugin.

Default alert

Wrap any text and an optional dismiss button in .alert for a basic warning alert message. To ensure proper behavior across all devices, be sure to use <button> element with the data-dismiss="alert" data attribute.

Warning! Best check yo self, you're not looking too good.
{% highlight html linenos %}
Warning! Best check yo self, you're not looking too good.
{% endhighlight %}

Block alerts

For longer messages, increase the padding on the top and bottom of the alert wrapper by adding .alert-block.

Warning!

Best check yo self, you're not looking too good. Nulla vitae elit libero, a pharetra augue. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.

{% highlight html linenos %}

Warning!

...

{% endhighlight %}

Contextual alternatives

Add optional classes to change an alert's connotation.

Oh snap! Change a few things up and try submitting again.
Well done! You successfully read this important alert message.
Heads up! This alert needs your attention, but it's not super important.
{% highlight html linenos %}
...
...
...
{% endhighlight %}

Progress bars

Provide up-to-date feedback on the progress of a workflow or action with simple yet flexible progress bars.

Progress bars use CSS3 transitions and animations to achieve some of their effects. These features are not supported in IE8-9 or older versions of Firefox. Internet Explorer 10 and below, as well as Opera 12, do not support animations.

Basic

Default progress bar with a vertical gradient.

{% highlight html linenos %}
{% endhighlight %}

Additional colors

Progress bars use some of the same button and alert classes for consistent styles.

{% highlight html linenos %}
{% endhighlight %}

Striped

Uses a gradient to create a striped effect. Not available in IE8.

{% highlight html linenos %}
{% endhighlight %}

Animated

Add .active to .progress-striped to animate the stripes right to left. Not available in all versions of IE.

{% highlight html linenos %}
{% endhighlight %}

Stacked

Place multiple bars into the same .progress to stack them.

{% highlight html linenos %}
{% endhighlight %}

Media object

Abstract object styles for building various types of components (like blog comments, Tweets, etc) that feature a left- or right-aligned image alongside textual content.

Default example

The default media allow to float a media object (images, video, audio) to the left or right of a content block.

Media heading

Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.

Media heading

Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.

Media heading

Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus.
{% highlight html linenos %}

Media heading

...
{% endhighlight %}

Media list

With a bit of extra markup, you can use media inside list (useful for comment threads or articles lists).

  • Media heading

    Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.

    Nested media heading

    Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.

    Nested media heading

    Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.

    Nested media heading

    Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.

  • Media heading

    Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.
{% highlight html linenos %}

  • Media heading

    ...
{% endhighlight %}

Miscellaneous Lightweight utility components

Wells

Use the well as a simple effect on an element to give it an inset effect.

Look, I'm in a well!
{% highlight html linenos %}
...
{% endhighlight %}

Optional classes

Control padding and rounded corners with two optional modifier classes.

Look, I'm in a well!
{% highlight html linenos %}
...
{% endhighlight %}
Look, I'm in a well!
{% highlight html linenos %}
...
{% endhighlight %}

Close icon

Use the generic close icon for dismissing content like modals and alerts.

{% highlight html linenos %} {% endhighlight %}

Helper classes

Simple, focused classes for small display or behavior tweaks.

.pull-left

Float an element left

{% highlight html linenos %}
...
{% endhighlight %} {% highlight css linenos %} .pull-left { float: left; } {% endhighlight %}

.pull-right

Float an element right

{% highlight html linenos %}
...
{% endhighlight %} {% highlight css linenos %} .pull-right { float: right; } {% endhighlight %}

.muted

Change an element's color to #999

{% highlight html linenos %}

...

{% endhighlight %} {% highlight css linenos %} .muted { color: #999; } {% endhighlight %}

.clearfix

Clear the float on any element. Utilizes the micro clearfix as popularized by Nicolas Gallagher.

{% highlight html linenos %}
...
{% endhighlight %} {% highlight css linenos %} .clearfix { &:before, &:after { content: " "; display: table; } &:after { clear: both; } } {% endhighlight %}