--- layout: default title: Components slug: components lead: "Dozens of reusable components built to provide iconography, dropdowns, navigation, alerts, popovers, and much more." ---

Icons font by Glyphicons

Included glyphs

Bootstrap comes with all 160 of Glyphicons Halflings set, all available in font formats for easy coloring, sizing, and placement.

Glyphicons attribution

Glyphicons Halflings are normally not available for free, but an arrangement between Bootstrap and the Glyphicons creator have made this possible at no cost to you as developers. As a thank you, we ask you to include an optional link back to Glyphicons whenever practical.

How to use

Add the appropriate class to any inline element. All icon classes are prefixed with glyphicon- for easy styling. To use, place the following code just about anywhere:

{% highlight html %} {% endhighlight %}

Want to change the icon color? Just change the color of the parent element.

When using beside strings of text, as in buttons or nav links, be sure to leave a space after the icon for proper spacing.

Icon examples

Use them in buttons, button groups for a toolbar, navigation, or prepended form inputs.

Buttons

Button group in a button toolbar
{% highlight html %}
{% endhighlight %}

Accessibility

Keep in mind that using icons without any additional content means the icons are not represented to screen reader users.

Dropdown in a button group
User
{% highlight html %}
User
{% endhighlight %}
Large button
Star
{% highlight html %} Star {% endhighlight %}
Small button
{% highlight html %} {% endhighlight %}

Navigation

{% highlight html %} {% endhighlight %}

Form fields

{% highlight html %}
{% endhighlight %}

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.

Basic button group

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

{% highlight html %}
{% endhighlight %}

Multiple button groups

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

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

Nested button groups

Place buttons groups within button groups when you want dropdown menus mixed with a series of buttons.

Vertical button groups

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

{% highlight html %}
...
{% 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 %}
...
{% 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.

Plugin dependency

Button dropdowns require the dropdown plugin to be included in your version of Bootstrap.

Single button dropdowns

Turn a button into dropdown toggle with some basic markup changes.

{% highlight html %}
{% endhighlight %}

Split button dropdowns

Similarly, create split button dropdowns with the same markup changes, only with a separate button.

{% highlight html %}
{% endhighlight %}

Works with all button sizes

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

{% highlight html %}
{% endhighlight %}

Dropup buttons

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

{% highlight html %}
{% endhighlight %}

Labels

Example

Example heading New

Example heading New

Example heading New

Example heading New

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

Example heading New

{% endhighlight %}

Available variations

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

Default Success Warning Danger Info
{% highlight html %} Default Success Warning Danger Info {% endhighlight %}

Badges

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

Inbox 42
{% highlight html %} 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.

Cross-browser compatibility

Badges won't self collapse in Internet Explorer 8 because it lacks support for the :empty selector.

Adapts to active nav states

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


{% highlight html %} {% 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 %}

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 as most other components (with additional styles).

Example page header Subtext for header

{% highlight html %}

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 %}
...
{% 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 %}

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 %}
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 %}

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 %}
...
...
...
{% endhighlight %}

Progress bars

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

Cross-browser compatibility

Progress bars use CSS3 transitions and animations to achieve some of their effects. These features are not supported in Internet Explorer 9 and below or older versions of Firefox. Opera 12 does not support animations.

Basic

Default progress bar with a vertical gradient.

{% highlight html %}
{% endhighlight %}

Contextual alternatives

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

{% highlight html %}
{% endhighlight %}

Striped

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

{% highlight html %}
{% endhighlight %}

Animated

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

{% highlight html %}
{% endhighlight %}

Stacked

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

{% highlight html %}
{% 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 %}

Media heading

...
{% endhighlight %}

Media list

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

{% highlight html %} {% endhighlight %}

List group

List groups are a flexible and powerful component for displaying not only simple lists of elements, but complex ones with custom content.

Basic list group

The most basic list group is simply an unordered list with list items, and the proper classes. Build upon it with the options that follow, or your own CSS as needed.

{% highlight html %} {% endhighlight %}

With chevrons

Add Glyphicon chevrons that are automatically moved to the right.

{% highlight html %} {% endhighlight %}

With badges

Add the badges component to any list group item and it will automatically be positioned on the right.

{% highlight html %} {% endhighlight %}

With badges and chevrons

Why not both?

{% highlight html %} {% endhighlight %}

Linked list group

Linkify list group items by using anchor tags instead of list items (that also means a parent <div> instead of an <ul>). No need for individual parents around each element.

Cras justo odio Dapibus ac facilisis in Morbi leo risus Porta ac consectetur ac Vestibulum at eros
{% highlight html %}
Cras justo odio Dapibus ac facilisis in Morbi leo risus Porta ac consectetur ac Vestibulum at eros
{% endhighlight %}

Custom content

Add nearly any HTML within, even for linked list groups like the one below.

List group item heading

Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.

List group item heading

Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.

List group item heading

Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.
{% highlight html %}

List group item heading

...
{% endhighlight %}

Panels

While not always necessary, sometimes you need to put your DOM in a box. For those situations, try the panel component.

Basic panel

By default, all the .panel does is apply some basic border and padding to contain some content.

Basic panel example
{% highlight html %}
Basic panel example
{% endhighlight %}

Panel with heading

Easily add a heading to your panel with .panel-heading. Use it on a <div> or any heading element (e.g., <h3>).

Panel heading
Panel content
{% highlight html %}
Panel heading
Panel content
{% endhighlight %}

Contextual alternatives

Like other components, easily make a panel more meaningful to a particular context by adding any of the contextual state classes.

Panel heading
Panel content
Panel heading
Panel content
Panel heading
Panel content
Panel heading
Panel content
Panel heading
Panel content
{% highlight html %}
...
...
...
...
...
{% endhighlight %}

With list groups

Easily include full-width list groups within any panel.

Panel heading

Some default panel content here. Nulla vitae elit libero, a pharetra augue. Aenean lacinia bibendum nulla sed consectetur. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum. Nullam id dolor id nibh ultricies vehicula ut id elit.

  • Cras justo odio
  • Dapibus ac facilisis in
  • Morbi leo risus
  • Porta ac consectetur ac
  • Vestibulum at eros
{% highlight html %}
Panel heading

...

{% endhighlight %}

Wells

Default well

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

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

Optional classes

Control padding and rounded corners with two optional modifier classes.

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