Components
Over a dozen reusable components built to provide iconography, dropdowns, input groups, navigation, alerts, and much more.
Over a dozen reusable components built to provide iconography, dropdowns, input groups, navigation, alerts, and much more.
Toggleable, contextual menu for displaying lists of links. Made interactive with the dropdown JavaScript plugin.
Wrap the dropdown's trigger and the dropdown menu within
.dropdown, or another element that declares
position: relative;. Then add the menu's
HTML.
Dropdown menus can be changed to expand upwards (instead
of downwards) by adding
.dropup to the parent.
By default, a dropdown menu is automatically positioned
100% from the top and along the left side of its parent.
Add
.dropdown-menu-right to a
.dropdown-menu to right align the dropdown
menu.
May require additional positioning
Dropdowns are
automatically positioned via CSS within the normal flow
of the document. This means dropdowns may be cropped by
parents with certain overflow properties or
appear out of bounds of the viewport. Address these
issues on your own as they arise.
Add a header to label sections of actions in any dropdown menu.
Add a divider to separate series of links in a dropdown menu.
Add .disabled to a
<li> in the dropdown to disable the
link.
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.
Tooltips &
popovers in button groups require special
setting
When using tooltips or popovers on elements
within a .btn-group, you'll have to specify
the option container: 'body' to avoid
unwanted side effects (such as the element growing wider
and/or losing its rounded corners when the tooltip or
popover is triggered).
Wrap a series of buttons with .btn in
.btn-group.
Combine sets of
<div class="btn-group"> into a
<div class="btn-toolbar"> for more
complex components.
Instead of applying button sizing classes to every
button in a group, just add
.btn-group-* to each
.btn-group, including when nesting multiple
groups.
Place a .btn-group within another
.btn-group when you want dropdown menus
mixed with a series of buttons.
Make a set of buttons appear vertically stacked rather than horizontally. Split button dropdowns are not supported here.
Make a group of buttons stretch at equal sizes to span the entire width of its parent. Also works with button dropdowns within the button group.
Handling
borders
Due to the specific HTML and CSS used to justify
buttons (namely display: table-cell), the
borders between them are doubled. In regular button
groups, margin-left: -1px is used to stack
the borders instead of removing them. However,
margin doesn't work with
display: table-cell. As a result, depending
on your customizations to Bootstrap, you may wish to
remove or re-color the borders.
<a> elements
Just wrap a series of .btns in
.btn-group.btn-group-justified.
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.
Turn a button into a dropdown toggle with some basic markup changes.
Similarly, create split button dropdowns with the same markup changes, only with a separate button.
Button dropdowns work with buttons of all sizes.
Trigger dropdown menus above elements by adding
.dropup to the parent.
Extend form controls by adding text or buttons before,
after, or on both sides of any text-based
<input>. Use
.input-group with an
.input-group-addon or
.input-group-btn to prepend or append
elements to a single .form-control.
Textual
<input>s only
Avoid using <select> elements
here as they cannot be fully styled in WebKit
browsers.
Avoid using
<textarea> elements here as their
rows attribute will not be respected in
some cases.
Tooltips &
popovers in input groups require special
setting
When using tooltips or popovers on elements
within an .input-group, you'll have to
specify the option container: 'body' to
avoid unwanted side effects (such as the element growing
wider and/or losing its rounded corners when the tooltip
or popover is triggered).
Don't mix
with other components
Do not mix form groups or grid column classes
directly with input groups. Instead, nest the input
group inside of the form group or grid-related element.
Place one add-on or button on either side of an input. You may also place one on both sides of an input.
We do not support multiple add-ons (.input-group-addon
or .input-group-btn) on a single
side.
We do not support multiple form-controls in a single input group.
Add the relative form sizing classes to the
.input-group itself and contents within
will automatically resize—no need for repeating the form
control size classes on each element.
Place any checkbox or radio option within an input group's addon instead of text.
Buttons in input groups are a bit different and require
one extra level of nesting. Instead of
.input-group-addon, you'll need to use
.input-group-btn to wrap the buttons. This
is required due to default browser styles that cannot be
overridden.
While you can only have one add-on per side, you can
have multiple buttons inside a single
.input-group-btn.
Navs available in Bootstrap have shared markup, starting
with the base .nav class, as well as shared
states. Swap modifier classes to switch between each
style.
Using navs for
tab panels requires JavaScript tabs plugin
For tabs with tabbable areas, you must use the
tabs JavaScript plugin. The markup will also require additional
role and ARIA attributes – see the plugin's
example markup
for further details.
Make navs
used as navigation accessible
If you are using navs to provide a navigation
bar, be sure to add a role="navigation" to
the most logical parent container of the
<ul>, or wrap a
<nav> element around the whole
navigation. Do not add the role to the
<ul> itself, as this would prevent it
from being announced as an actual list by assistive
technologies.
Note the .nav-tabs class requires the
.nav base class.
Take that same HTML, but use
.nav-pills instead:
Pills are also vertically stackable. Just add
.nav-stacked.
Easily make tabs or pills equal widths of their parent
at screens wider than 768px with
.nav-justified. On smaller screens, the nav
links are stacked.
Justified navbar nav links are currently not supported.
Safari and responsive justified navs
As of v9.1.2, Safari exhibits a bug in which resizing
your browser horizontally causes rendering errors in the
justified nav that are cleared upon refreshing. This bug
is also shown in the
justified nav example.
For any nav component (tabs or pills), add
.disabled for
gray links and no hover effects.
Link functionality not impacted
This class will only change the
<a>'s appearance, not its
functionality. Use custom JavaScript to disable links
here.
Add dropdown menus with a little extra HTML and the dropdowns JavaScript plugin.
Navbars are responsive meta components that serve as navigation headers for your application or site. They begin collapsed (and are toggleable) in mobile views and become horizontal as the available viewport width increases.
Justified navbar nav links are currently not supported.
Overflowing content
Since Bootstrap doesn't know how much space the
content in your navbar needs, you might run into issues
with content wrapping into a second row. To resolve
this, you can:
Reduce the amount or width of navbar items.
Hide certain navbar items at certain screen sizes using
responsive utility classes.
Change the point at which your navbar switches between
collapsed and horizontal mode. Customize the
@grid-float-breakpoint variable or add your
own media query.
Requires JavaScript plugin
If JavaScript is disabled and the viewport is
narrow enough that the navbar collapses, it will be
impossible to expand the navbar and view the content
within the .navbar-collapse
The
responsive navbar requires the collapse plugin to be
included in your version of Bootstrap.
Changing the collapsed mobile navbar
breakpoint
The navbar collapses into its vertical mobile view
when the viewport is narrower than
@grid-float-breakpoint, and expands into
its horizontal non-mobile view when the viewport is at
least @grid-float-breakpoint in width.
Adjust this variable in the Less source to control when
the navbar collapses/expands. The default value is
768px (the smallest "small" or "tablet"
screen).
Make navbars accessible
Be sure to use a <nav> element
or, if using a more generic element such as a
<div>, add a
role="navigation" to every navbar to
explicitly identify it as a landmark region for users of
assistive technologies.
Replace the navbar brand with your own image by swapping
the text for an <img>. Since the
.navbar-brand has its own padding and
height, you may need to override some CSS depending on
your image.
Place form content within
.navbar-form for proper vertical alignment
and collapsed behavior in narrow viewports. Use the
alignment options to decide where it resides within the
navbar content.
As a heads up, .navbar-form shares much of
its code with .form-inline via mixin.
Some form controls, like input groups, may require
fixed widths to be show up properly within a
navbar.
Mobile device caveats
There are some caveats regarding using form
controls within fixed elements on mobile devices.
See our browser support docs
for details.
Always add labels
Screen readers will have trouble with your forms
if you don't include a label for every input. For these
inline forms, you can hide the labels using the
.sr-only class. There are further
alternative methods of providing a label for assistive
technologies, such as the aria-label,
aria-labelledby or
title attribute. If none of these is
present, screen readers may resort to using the
placeholder attribute, if present, but note
that use of placeholder as a replacement
for other labelling methods is not advised.
Add the .navbar-btn class to
<button> elements not residing in a
<form> to vertically center them in
the navbar.
Wrap strings of text in an element with
.navbar-text, usually on a
<p> tag for proper leading and color.
For folks using standard links that are not within the
regular navbar navigation component, use the
.navbar-link class to add the proper colors
for the default and inverse navbar options.
Align nav links, forms, buttons, or text, using the
.navbar-left or
.navbar-right utility classes. Both classes
will add a CSS float in the specified direction. For
example, to align nav links, put them in a separate
<ul> with the respective utility
class applied.
These classes are mixin-ed versions of
.pull-left and .pull-right,
but they're scoped to media queries for easier handling
of navbar components across device sizes.
Right aligning multiple components
Navbars currently have a limitation with multiple
.navbar-right classes. To properly space
content, we use negative margin on the last
.navbar-right element. When there are
multiple elements using that class, these margins don't
work as intended.
Add .navbar-fixed-top and include a
.container or
.container-fluid to center and pad navbar
content.
<nav class="navbar navbar-default navbar-fixed-top">
<div class="container">
...
</div>
</nav>
Body padding required
The fixed navbar will overlay your other content, unless
you add padding to the top of the
<body>. Try out your own values or
use our snippet below.
Tip: By default, the navbar is 50px high.
Make sure to include this after the core Bootstrap CSS.
Add .navbar-fixed-bottom and include a
.container or
.container-fluid to center and pad navbar
content.
<nav class="navbar navbar-default navbar-fixed-bottom">
<div class="container">
...
</div>
</nav>
Body padding required
The fixed navbar will overlay your other content, unless
you add padding to the bottom of the
<body>. Try out your own values or
use our snippet below. Tip: By default, the navbar is
50px high.
Create a full-width navbar that scrolls away with the
page by adding .navbar-static-top and
include a .container or
.container-fluid to center and pad navbar
content.
Unlike the .navbar-fixed-* classes, you do
not need to change any padding on the body.
Modify the look of the navbar by adding
.navbar-inverse.
Indicate the current page's location within a navigational hierarchy.
Separators are automatically added in CSS through
:before and content.
Provide pagination links for your site or app with the multi-page pagination component, or the simpler pager alternative.
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.
Labelling the pagination component
The pagination component should be wrapped in a
<nav> element to identify it as a
navigation section to screen readers and other assistive
technologies. In addition, as a page is likely to have
more than one such navigation section already (such as
the primary navigation in the header, or a sidebar
navigation), it is advisable to provide a descriptive
aria-label for the
<nav> which reflects its purpose. For
example, if the pagination component is used to navigate
between a set of search results, an appropriate label
could be aria-label="Search results pages".
Float behavior needs clearfix
The pagination components inherits float:left; from the template.css file. You need to add
.clearfix after the pagination component to fix any display issues.
Links are customizable for different circumstances. Use
.disabled for unclickable links and
.active to indicate the current page.
We recommend that you swap out active or disabled
anchors for <span>, or omit the
anchor in the case of the previous/next arrows, to
remove click functionality while retaining intended
styles.
Fancy larger or smaller pagination? Add
.pagination-lg or
.pagination-sm for additional sizes.
Quick previous and next links for simple pagination implementations with light markup and styles. It's great for simple sites like blogs or magazines.
By default, the pager centers links.
Alternatively, you can align each link to the sides:
Pager links also use the general
.disabled utility class from the
pagination.
Add any of the below mentioned modifier classes to change the appearance of a label.
Easily highlight new or unread items by adding a
<span class="badge"> to links,
Bootstrap navs, and more.
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.
Built-in styles are included for placing badges in active states in pill navigations.
A lightweight, flexible component that can optionally extend the entire viewport to showcase key content on your site.
This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
You can also leverage .primary to apply the
base color swatch for that class. Other classes work
too!
This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
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).
Extend Bootstrap's grid system with the thumbnail component to easily display grids of images, videos, text, and more.
If you're looking for Pinterest-like presentation of thumbnails of varying heights and/or widths, you'll need to use a third-party plugin such as Masonry, Isotope, or Salvattore.
By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.
With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.
Provide contextual feedback messages for typical user actions with the handful of available and flexible alert messages.
Wrap any text and an optional dismiss button in
.alert and one of the four contextual
classes (e.g., .alert-success) for basic
alert messages.
No default class
Alerts don't have default classes, only base and
modifier classes. A default gray alert doesn't make too
much sense, so you're required to specify a type via
contextual class. Choose from success, info, warning, or
danger.
Build on any alert by adding an optional
.alert-dismissible and close button.
Requires JavaScript alert plugin
For fully functioning, dismissible alerts, you must use
the alerts JavaScript plugin.
Use the .alert-link utility class to
quickly provide matching colored links within any alert.
Provide up-to-date feedback on the progress of a workflow or action with simple yet flexible progress bars.
Default progress bar.
Remove the <span> with
.sr-only class from within the progress bar
to show a visible percentage.
To ensure that the label text remains legible even for
low percentages, consider adding a
min-width to the progress bar.
Progress bars use some of the same button and alert classes for consistent styles.
Uses a gradient to create a striped effect. Not available in IE9 and below.
Add .active to .progress-bar-striped to animate the stripes right to left. Not available in
IE9 and below.
Place multiple bars into the same .progress to stack them.
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.
The default media displays a media object (images, video, audio) to the left or right of a content block.
The classes .pull-left and .pull-right also exist and were previously used as part of the
media component, but are deprecated for that use as of v3.3.0. They are approximately equivalent to
.media-left and .media-right, except that .media-right should be placed after
the .media-body in the html.
The images or other media can be aligned top, middle, or bottom. The default is top aligned.
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.
Donec sed odio dui. Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.
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.
Donec sed odio dui. Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.
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.
Donec sed odio dui. Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.
With a bit of extra markup, you can use media inside list (useful for comment threads or articles lists).
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.
List groups are a flexible and powerful component for displaying not only simple lists of elements, but complex ones with custom content.
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.
Add the badges component to any list group item and it will automatically be positioned on the right.
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.
List group items may be buttons instead of list items (that also means a parent <div> instead of
an <ul>). No need for individual parents around each element. Don't
use the standard .btn classes here.
Add .disabled to a .list-group-item to gray it out to appear disabled.
Use contextual classes to style list items, default or linked. Also includes .active state.
Add nearly any HTML within, even for linked list groups like the one below.
Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.
Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.
Donec id elit non mi porta gravida at eget metus. Maecenas sed diam eget risus varius blandit.
While not always necessary, sometimes you need to put your DOM in a box. For those situations, try the panel component.
By default, all the .panel does is apply some basic border and padding to contain some content.
Easily add a heading container to your panel with .panel-heading. You may also include any
<h1>-<h6> with a .panel-title class to add a pre-styled heading.
However, the font sizes of <h1>-<h6> are overridden by
.panel-heading.
For proper link coloring, be sure to place links in headings within .panel-title.
Wrap buttons or secondary text in .panel-footer. Note that panel footers do not inherit
colors and borders when using contextual variations as they are not meant to be in the foreground.
Like other components, easily make a panel more meaningful to a particular context by adding any of the contextual state classes.
Add any non-bordered .table within a panel for a seamless design. If there is a
.panel-body, we add an extra border to the top of the table for separation.
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.
| # | First Name | Last Name | Username |
|---|---|---|---|
| 1 | Mark | Otto | @mdo |
| 2 | Jacob | Thornton | @fat |
| 3 | Larry | the Bird |
If there is no panel body, the component moves from panel header to table without interruption.
| # | First Name | Last Name | Username |
|---|---|---|---|
| 1 | Mark | Otto | @mdo |
| 2 | Jacob | Thornton | @fat |
| 3 | Larry | the Bird |
Easily include full-width list groups within any panel.
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.
Allow browsers to determine video or slideshow dimensions based on the width of their containing block by creating an intrinsic ratio that will properly scale on any device.
Rules are directly applied to <iframe>, <embed>, <video>,
and <object> elements; optionally use an explicit descendant class
.embed-responsive-item when you want to match the styling for other attributes.
Pro-Tip! You don't need to include frameborder="0" in your <iframe>s
as we override that for you.
Use the well as a simple effect on an element to give it an inset effect.
Control padding and rounded corners with two optional modifier classes.