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.
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.
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.
<div class="alert alert-success" role="alert">...</div>
<div class="alert alert-info" role="alert">...</div>
<div class="alert alert-warning" role="alert">...</div>
<div class="alert alert-danger" role="alert">...</div>
Place the <i class="icon icon-warning" aria-hidden="true"></i>
before the strong tag, switching out .icon-warning
to match the correct icon to alert.
<div class="alert alert-success" role="alert">
<i class="icon icon-valid" aria-hidden="true"></i> <strong>...</strong>...
</div>
<div class="alert alert-info" role="alert">
<i class="icon icon-notify_alert" aria-hidden="true"></i> <strong>...</strong>...
</div>
<div class="alert alert-warning" role="alert">
<i class="icon icon-warning" aria-hidden="true"></i> <strong>...</strong>...
</div>
<div class="alert alert-danger" role="alert">
<i class="icon icon-error" aria-hidden="true"></i> <strong>...</strong>...
</div>
Build on any alert by adding an optional .alert-dismissible
and close button.
For fully functioning, dismissible alerts, you must use the alerts JavaScript plugin.
<div class="alert alert-warning alert-dismissible" role="alert">
<button type="button" class="close" data-dismiss="alert" aria-label="Close"><span aria-hidden="true">×</span></button>
<strong>Warning!</strong> Better check yourself, you're not looking too good.
</div>
Be sure to use the <button>
element with the data-dismiss="alert"
data attribute.
Use the .alert-link
utility class to quickly provide matching colored links within any alert.
<div class="alert alert-success" role="alert">
<a href="#" class="alert-link">...</a>
</div>
<div class="alert alert-info" role="alert">
<a href="#" class="alert-link">...</a>
</div>
<div class="alert alert-warning" role="alert">
<a href="#" class="alert-link">...</a>
</div>
<div class="alert alert-danger" role="alert">
<a href="#" class="alert-link">...</a>
</div>
Easily highlight new or unread items by adding a <span class="badge">
to links, Bootstrap navs, and more.
<a href="#">Inbox <span class="badge">42</span></a>
<button class="btn btn-primary" type="button">
Messages <span class="badge">4</span>
</button>
When there are no new or unread items, badges will simply collapse (via CSS's :empty
selector) provided no content exists within.
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.
<ul class="nav nav-pills" role="tablist">
<li role="presentation" class="active"><a href="#">Home <span class="badge">42</span></a></li>
<li role="presentation"><a href="#">Profile</a></li>
<li role="presentation"><a href="#">Messages <span class="badge">3</span></a></li>
</ul>
Add any of the below mentioned modifier classes to change the appearance of a badge.
<span class="badge badge-default">4</span>
<span class="badge badge-primary">4</span>
<span class="badge badge-success">4</span>
<span class="badge badge-important">4</span>
<span class="badge badge-info">4</span>
<span class="badge badge-warning">4</span>
<span class="badge badge-inverse">4</span>
Indicate the current page's location within a navigational hierarchy.
Separators are automatically added in CSS through :before
and content
.
<ol class="breadcrumb">
<li><a href="#">Home</a></li>
<li><a href="#">Library</a></li>
<li class="active">Data</li>
</ol>
Use any button to trigger a dropdown menu by placing it within a .btn-group
and providing the proper menu markup.
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.
<!-- Single button -->
<div class="btn-group">
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
Action <span class="caret"></span>
</button>
<ul class="dropdown-menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li role="separator" class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
Similarly, create split button dropdowns with the same markup changes, only with a separate button.
<!-- Split button -->
<div class="btn-group">
<button type="button" class="btn btn-danger">Action</button>
<button type="button" class="btn btn-danger dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
<span class="caret"></span>
<span class="sr-only">Toggle Dropdown</span>
</button>
<ul class="dropdown-menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li role="separator" class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
Button dropdowns work with buttons of all sizes.
<!-- Large button group -->
<div class="btn-group">
<button class="btn btn-default btn-lg dropdown-toggle" type="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
Large button <span class="caret"></span>
</button>
<ul class="dropdown-menu">
...
</ul>
</div>
<!-- Small button group -->
<div class="btn-group">
<button class="btn btn-default btn-sm dropdown-toggle" type="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
Small button <span class="caret"></span>
</button>
<ul class="dropdown-menu">
...
</ul>
</div>
<!-- Extra small button group -->
<div class="btn-group">
<button class="btn btn-default btn-xs dropdown-toggle" type="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
Extra small button <span class="caret"></span>
</button>
<ul class="dropdown-menu">
...
</ul>
</div>
Trigger dropdown menus above elements by adding .dropup
to the parent.
<div class="btn-group dropup">
<button type="button" class="btn btn-default">Dropup</button>
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
<span class="caret"></span>
<span class="sr-only">Toggle Dropdown</span>
</button>
<ul class="dropdown-menu">
<!-- Dropdown menu links -->
</ul>
</div>
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.
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).
role
and provide a labelIn order for assistive technologies – such as screen readers – to convey that a series of buttons is grouped, an appropriate role
attribute needs to be provided. For button groups, this would be role="group"
, while toolbars should have a role="toolbar"
.
One exception are groups which only contain a single control (for instance the justified button groups with <button>
elements) or a dropdown.
In addition, groups and toolbars should be given an explicit label, as most assistive technologies will otherwise not announce them, despite the presence of the correct role
attribute. In the examples provided here, we use aria-label
, but alternatives such as aria-labelledby
can also be used.
Wrap a series of buttons with .btn
in .btn-group
.
<div class="btn-group" role="group" aria-label="...">
<button type="button" class="btn btn-default">Left</button>
<button type="button" class="btn btn-default">Middle</button>
<button type="button" class="btn btn-default">Right</button>
</div>
Combine sets of <div class="btn-group">
into a <div class="btn-toolbar">
for more complex components.
<div class="btn-toolbar" role="toolbar" aria-label="...">
<div class="btn-group" role="group" aria-label="...">...</div>
<div class="btn-group" role="group" aria-label="...">...</div>
<div class="btn-group" role="group" aria-label="...">...</div>
</div>
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.
<div class="btn-group btn-group-lg" role="group" aria-label="...">...</div>
<div class="btn-group" role="group" aria-label="...">...</div>
<div class="btn-group btn-group-sm" role="group" aria-label="...">...</div>
<div class="btn-group btn-group-xs" role="group" aria-label="...">...</div>
Place a .btn-group
within another .btn-group
when you want dropdown menus mixed with a series of buttons.
<div class="btn-group" role="group" aria-label="...">
<button type="button" class="btn btn-default">1</button>
<button type="button" class="btn btn-default">2</button>
<div class="btn-group" role="group">
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
Dropdown
<span class="caret"></span>
</button>
<ul class="dropdown-menu">
<li><a href="#">Dropdown link</a></li>
<li><a href="#">Dropdown link</a></li>
</ul>
</div>
</div>
Make a set of buttons appear vertically stacked rather than horizontally. Split button dropdowns are not supported here.
<div class="btn-group-vertical" role="group" aria-label="...">
...
</div>
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.
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.
Internet Explorer 8 doesn't render borders on buttons in a justified button group, whether it's on <a>
or <button>
elements. To get around that, wrap each button in another .btn-group
.
See #12476 for more information.
<a>
elementsJust wrap a series of .btn
s in .btn-group.btn-group-justified
.
<div class="btn-group btn-group-justified" role="group" aria-label="...">
...
</div>
If the <a>
elements are used to act as buttons – triggering in-page functionality, rather than navigating to another document or section within the current page – they should also be given an appropriate role="button"
.
<button>
elementsTo use justified button groups with <button>
elements, you must wrap each button in a button group. Most browsers don't properly apply our CSS for justification to <button>
elements, but since we support button dropdowns, we can work around that.
<div class="btn-group btn-group-justified" role="group" aria-label="...">
<div class="btn-group" role="group">
<button type="button" class="btn btn-default">Left</button>
</div>
<div class="btn-group" role="group">
<button type="button" class="btn btn-default">Middle</button>
</div>
<div class="btn-group" role="group">
<button type="button" class="btn btn-default">Right</button>
</div>
</div>
Default call out boxes have both top and bottom shadows. To make a call out box add the base class
.call-out-box
to any block level element.
Call outs can be positioned using grids, and can contain other components.
<div class="call-out-box">
<div class="call-out-body">
...
</div>
</div>
You can remove the top shadow by adding the modifier class Deprecated: .call-out-box--no-top
Expected: .call-out-box .no-top
New: .call-out-body
this
class helps give a starting baseline for an inner contents of the call-out.
Look, I'm in a call-out!
<div class="call-out-box no-top">
<div class="call-out-body">
...
</div>
</div>
You can remove the bottom shadow by adding the modifier class Deprecated: .call-out-box--no-bottom
Expected: .call-out-box .no-bottom
Look, I'm in a call-out!
<div class="call-out-box no-bottom">
<div class="call-out-body">
...
</div>
</div>
For a quicker load time, use the CSS styles instead of image files when showing cartridge colors.
<div class="cartridge cartridge-black"></div>
<div class="cartridge cartridge-cyan"></div>
<div class="cartridge cartridge-magenta"></div>
<div class="cartridge cartridge-yellow"></div>
Place .cartridge-cmyk
after each color class to arrange the colors inline with one another. The colors must be written in the order shown below for the layering to work.
<div class="cartridge-cmyk"></div>
Place .cartridge-mono
after each color class to arrange the colors inline with one another. The colors must be written in the order shown below for the layering to work.
<div class="cartridge-mono"></div>
Use .cartridge-dot-matrix
to create this symbol.
<div class="cartridge-dot-matrix"></div>
The default alignment is left-aligned. You can change the alignment by wrapping the group of colors in a div with the following class options: .cartridge-center
, .cartridge-right
and .cartridge-left
. If it's a color, mono or dot-matrix printer symbol, you will need to add .cartridge-cmyk
, .cartridge-mono
or .cartridge-dot-matrix
after the alignment class for correct spacing. If you need to create a block element, change the .cartridge
to .cartridge-block
. You can also make the color dots smaller by changing the .cartridge
to .cartridge-sm
.
<div class="cartridge-left cartridge-cmyk"></div>
<div class="cartridge-left cartridge-mono"></div>
<div class="cartridge-left cartridge-dot-matrix"></div>
<div class="cartridge cartridge-black cartridge-left"></div>
<div class="cartridge-sm cartridge-cmyk"></div>
<div class="cartridge-sm cartridge-dot-matrix"></div>
<div class="cartridge cartridge-block cartridge-cyan"></div>
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.
<div class="dropdown">
<button class="btn btn-default dropdown-toggle" type="button" id="dropdownMenu1" data-toggle="dropdown" aria-haspopup="true" aria-expanded="true">
Dropdown
<span class="caret"></span>
</button>
<ul class="dropdown-menu" aria-labelledby="dropdownMenu1">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li role="separator" class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
Dropdown menus can be changed to expand upwards (instead of downwards) by adding .dropup
to the parent.
<div class="dropup">
<button class="btn btn-default dropdown-toggle" type="button" id="dropdownMenu2" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">
Dropup
<span class="caret"></span>
</button>
<ul class="dropdown-menu" aria-labelledby="dropdownMenu2">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li role="separator" class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
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.
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.
.pull-right
alignmentAs of v3.1.0, we've deprecated .pull-right
on dropdown menus. To right-align a menu, use .dropdown-menu-right
. Right-aligned nav components in the navbar use a mixin version of this class to automatically align the menu. To override it, use .dropdown-menu-left
.
<ul class="dropdown-menu dropdown-menu-right" aria-labelledby="dLabel">
...
</ul>
Add a header to label sections of actions in any dropdown menu.
<ul class="dropdown-menu" aria-labelledby="dropdownMenu3">
...
<li class="dropdown-header">Dropdown header</li>
...
</ul>
Add a divider to separate series of links in a dropdown menu.
<ul class="dropdown-menu" aria-labelledby="dropdownMenuDivider">
...
<li role="separator" class="divider"></li>
...
</ul>
Add .disabled
to a <li>
in the dropdown to disable the link.
<ul class="dropdown-menu" aria-labelledby="dropdownMenu4">
<li><a href="#">Regular link</a></li>
<li class="disabled"><a href="#">Disabled link</a></li>
<li><a href="#">Another link</a></li>
</ul>
Combining a caption with an image.
The default text color is n6 on a white background. For light backgrounds (recommended brand colors: n1-n4, b8), text should be black. For dark backgrounds (recommended brand colors: n6-n9, b7, black), text should be white.
Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod. Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod.
<figure>
<img src="..." class="img-responsive">
<figcaption>Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod.</figcaption>
<p>Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod. Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod.</p>
</figure>
Optional rule can be used when additional visual separation is need from content blocks. Same color recommendations apply as the basic figure caption.
Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod. Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod.
<figure>
<img src="..." class="img-responsive">>
<figcaption>Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod.</figcaption>
<hr>
<p>...</p>
</figure>
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
.
<input>
s onlyAvoid 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.
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).
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.
Screen readers will have trouble with your forms if you don't include a label for every input. For these input groups, ensure that any additional label or functionality is conveyed to assistive technologies.
The exact technique to be used (visible <label>
elements, <label>
elements hidden using the .sr-only
class, or use of the aria-label
, aria-labelledby
, aria-describedby
, title
or placeholder
attribute) and what additional information will need to be conveyed will vary depending on the exact type of interface widget you're implementing. The examples in this section provide a few suggested, case-specific approaches.
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.
<div class="input-group">
<span class="input-group-addon" id="basic-addon1">@</span>
<input type="text" class="form-control" placeholder="Username" aria-describedby="basic-addon1">
</div>
<div class="input-group">
<input type="text" class="form-control" placeholder="Recipient's username" aria-describedby="basic-addon2">
<span class="input-group-addon" id="basic-addon2">@example.com</span>
</div>
<div class="input-group">
<span class="input-group-addon">$</span>
<input type="text" class="form-control" aria-label="Amount (to the nearest dollar)">
<span class="input-group-addon">.00</span>
</div>
<label for="basic-url">Your vanity URL</label>
<div class="input-group">
<span class="input-group-addon" id="basic-addon3">https://example.com/users/</span>
<input type="text" class="form-control" id="basic-url" aria-describedby="basic-addon3">
</div>
Using a combination of border helper classes, the .bg-transparent
class, and the .input-group-focus
class, one can create a search bar. The .input-group-focus
class removes the border of all interior child elements, removes the :hover and :focus styling for any child input tags, and resets the :hover and :focus to occur on the element with the .input-group-focus
.
Also, styling the anchor tag with the same styles as those normally given to the span tag allows links to be made around icons, such as those in the examples below.
<div class="input-group input-group-focus">
<a class="input-group-addon border-none bg-transparent">
<span class="icon icon-search" aria-hidden="true"></span>
</a>
<input type="text" class="form-control border-none padding-before-none" placeholder="Search" aria-label="search">
</div>
<div class="input-group input-group-focus">
<input type="text" class="form-control border-none" placeholder="Search" aria-label="search">
<a class="input-group-addon border-none bg-transparent">
<span class="icon icon-search" aria-hidden="true"></span>
</a>
</div>
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.
<div class="input-group input-group-lg">
<span class="input-group-addon" id="sizing-addon1">@</span>
<input type="text" class="form-control" placeholder="Username" aria-describedby="sizing-addon1">
</div>
<div class="input-group">
<span class="input-group-addon" id="sizing-addon2">@</span>
<input type="text" class="form-control" placeholder="Username" aria-describedby="sizing-addon2">
</div>
<div class="input-group input-group-sm">
<span class="input-group-addon" id="sizing-addon3">@</span>
<input type="text" class="form-control" placeholder="Username" aria-describedby="sizing-addon3">
</div>
Place any checkbox or radio option within an input group's addon instead of text.
<div class="row">
<div class="col-lg-6">
<div class="input-group">
<span class="input-group-addon">
<label>
<input type="checkbox" aria-label="...">
<span></span>
</label>
</span>
<input type="text" class="form-control" aria-label="...">
</div><!-- /input-group -->
</div><!-- /.col-lg-6 -->
<div class="col-lg-6">
<div class="input-group">
<span class="input-group-addon">
<label>
<input type="radio" aria-label="...">
<span></span>
</label>
</span>
<input type="text" class="form-control" aria-label="...">
</div><!-- /input-group -->
</div><!-- /.col-lg-6 -->
</div><!-- /.row -->
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.
<div class="row">
<div class="col-lg-6">
<div class="input-group">
<span class="input-group-btn">
<button class="btn btn-default" type="button">Go!</button>
</span>
<input type="text" class="form-control" placeholder="Search for...">
</div><!-- /input-group -->
</div><!-- /.col-lg-6 -->
<div class="col-lg-6">
<div class="input-group">
<input type="text" class="form-control" placeholder="Search for...">
<span class="input-group-btn">
<button class="btn btn-default" type="button">Go!</button>
</span>
</div><!-- /input-group -->
</div><!-- /.col-lg-6 -->
</div><!-- /.row -->
<div class="row">
<div class="col-lg-6">
<div class="input-group">
<div class="input-group-btn">
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Action <span class="caret"></span></button>
<ul class="dropdown-menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li role="separator" class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div><!-- /btn-group -->
<input type="text" class="form-control" aria-label="...">
</div><!-- /input-group -->
</div><!-- /.col-lg-6 -->
<div class="col-lg-6">
<div class="input-group">
<input type="text" class="form-control" aria-label="...">
<div class="input-group-btn">
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false">Action <span class="caret"></span></button>
<ul class="dropdown-menu dropdown-menu-right">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li role="separator" class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div><!-- /btn-group -->
</div><!-- /input-group -->
</div><!-- /.col-lg-6 -->
</div><!-- /.row -->
<div class="input-group">
<div class="input-group-btn">
<!-- Button and dropdown menu -->
</div>
<input type="text" class="form-control" aria-label="...">
</div>
<div class="input-group">
<input type="text" class="form-control" aria-label="...">
<div class="input-group-btn">
<!-- Button and dropdown menu -->
</div>
</div>
While you can only have one add-on per side, you can have multiple buttons inside a single .input-group-btn
.
<div class="input-group">
<div class="input-group-btn">
<!-- Buttons -->
</div>
<input type="text" class="form-control" aria-label="...">
</div>
<div class="input-group">
<input type="text" class="form-control" aria-label="...">
<div class="input-group-btn">
<!-- Buttons -->
</div>
</div>
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.
<div class="jumbotron jumbo-style">
<h1>Hello, world!</h1>
<p>...</p>
<p><a class="btn btn-ghost btn-lg" href="#" role="button">Learn more</a></p>
</div>
The jumbotron has a unique styling that is not found elsewhere in the framework. This is applied by using the .jumbo-style
class.
Remove the class to allow the default framework styling to take effect.
This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
<div class="jumbotron">
<h1>Hello, world!</h1>
<p>...</p>
<p><a class="btn btn-ghost btn-lg" href="#" role="button">Learn more</a></p>
</div>
If you need to duplicate the styling of the jumbotron header, you can do so by adding class .jumbo
to any <h1>
tag.
<h1 class="jumbo">Jumbotron H1</h1>
<h1>Regular H1</h1>
To change the width and/or height of the Jumbotron, use the following approaches.
To make the jumbotron full width, place it outside all .container
classes and instead add a .container
class within.
<div class="jumbotron jumbo-style">
<div class="container">
...
</div>
</div>
This is a simple hero unit.
<div class="jumbotron jumbo-style jumbotron-small">
<h1>Hello, world!</h1>
<p>This is a simple hero unit.</p>
</div>
This is a simple hero unit.
<div class="jumbotron jumbo-style jumbotron-medium">
<h1>Hello, world!</h1>
<p>This is a simple hero unit.</p>
</div>
This is a simple hero unit.
<div class="jumbotron jumbo-style jumbotron-large">
<h1>Hello, world!</h1>
<p>This is a simple hero unit.</p>
</div>
This is a simple hero unit.
<div class="jumbotron jumbo-style jumbotron-extra-large">
<h1>Hello, world!</h1>
<p>This is a simple hero unit.</p>
</div>
The content within the jumbotron can be positioned in the following nine positions. The content must be wrapped within a div with the appropriate alignment class as shown in the examples below. To retain the padding from the jumbotron, add the .align-container
class to the same container.
Top Left
Center Left
Bottom Left
Top Center
Center Center
Bottom Center
Top Right
Center Right
Bottom Right
<div class="jumbotron jumbo-style jumbotron-large">
<div class="align-container align-top-left">
<p>Top Left</p>
</div>
<div class="align-container align-center-left">
<p>Center Left</p>
</div>
<div class="align-container align-bottom-left">
<p>Bottom Left</p>
</div>
<div class="align-container align-top-center">
<p>Top Center</p>
</div>
<div class="align-container align-center-center">
<p>Center Center</p>
</div>
<div class="align-container align-bottom-center">
<p>Bottom Center</p>
</div>
<div class="align-container align-top-right">
<p>Top Right</p>
</div>
<div class="align-container align-center-right">
<p>Center Right</p>
</div>
<div class="align-container align-bottom-right">
<p>Bottom Right</p>
</div>
</div>
Top Left
Center Left
Bottom Left
Top Center
Center Center
Bottom Center
Top Right
Center Right
Bottom Right
<div class="jumbotron jumbo-style jumbotron-large">
<div class="align-top-left">
<p>Top Left</p>
</div>
<div class="align-center-left">
<p>Center Left</p>
</div>
<div class="align-bottom-left">
<p>Bottom Left</p>
</div>
<div class="align-top-center">
<p>Top Center</p>
</div>
<div class="align-center-center">
<p>Center Center</p>
</div>
<div class="align-bottom-center">
<p>Bottom Center</p>
</div>
<div class="align-top-right">
<p>Top Right</p>
</div>
<div class="align-center-right">
<p>Center Right</p>
</div>
<div class="align-bottom-right">
<p>Bottom Right</p>
</div>
</div>
This is a simple hero unit.
<div class="jumbotron jumbo-style jumbotron-large">
<div class="align-container align-top-left">
<h1>Hello, world!</h1>
<p>This is a simple hero unit.</p>
</div>
</div>
This is a simple hero unit.
<div class="jumbotron jumbo-style jumbotron-large">
<div class="align-container align-center-left">
<h1>Hello, world!</h1>
<p>This is a simple hero unit.</p>
</div>
</div>
This is a simple hero unit.
<div class="jumbotron jumbo-style jumbotron-large">
<div class="align-container align-bottom-left">
<h1>Hello, world!</h1>
<p>This is a simple hero unit.</p>
</div>
</div>
This is a simple hero unit.
<div class="jumbotron jumbo-style jumbotron-large">
<div class="align-container align-top-center">
<h1>Hello, world!</h1>
<p>This is a simple hero unit.</p>
</div>
</div>
This is a simple hero unit.
<div class="jumbotron jumbo-style jumbotron-large">
<div class="align-container align-center-center">
<h1>Hello, world!</h1>
<p>This is a simple hero unit.</p>
</div>
</div>
This is a simple hero unit.
<div class="jumbotron jumbo-style jumbotron-large">
<div class="align-container align-bottom-center">
<h1>Hello, world!</h1>
<p>This is a simple hero unit.</p>
</div>
</div>
This is a simple hero unit.
<div class="jumbotron jumbo-style jumbotron-large">
<div class="align-container align-top-right">
<h1>Hello, world!</h1>
<p>This is a simple hero unit.</p>
</div>
</div>
This is a simple hero unit.
<div class="jumbotron jumbo-style jumbotron-large">
<div class="align-container align-center-right">
<h1>Hello, world!</h1>
<p>This is a simple hero unit.</p>
</div>
</div>
This is a simple hero unit.
<div class="jumbotron jumbo-style jumbotron-large">
<div class="align-container align-bottom-right">
<h1>Hello, world!</h1>
<p>This is a simple hero unit.</p>
</div>
</div>
Extend Jumbotron with the grid system by applying appropriate classes as seen below. This allows for different widths of text for different designs and layouts.
This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
<div class="jumbotron jumbo-style">
<div class="row">
<div class="col-md-6">
<h1>...</h1>
<p>...</p>
</div>
</div>
</div>
Apply the bootstrap offset column classes to position the text within the jumbotron as you would regular columns.
This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
<div class="jumbotron jumbo-style">
<div class="row">
<div class="col-md-6 col-md-offset-3">
<h1>...</h1>
<p>...</p>
</div>
</div>
</div>
When using images in the jumbotron, there are three rules to remember:
In the example below, the 400 x 400 background image is shown behind the grid (which also contains a 100 x 100 image) because the 400 x 400 image markup is placed above the grid markup.
This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
<div class="jumbotron jumbo-style">
<img src="https://fakeimg.pl/400x400" alt="" title="" width="400" height="400">
<div class="row">
<div class="col-xs-12">
<h1>Hello, world!</h1>
<img src="https://placeimg.com/100/100/tech" class="pull-right">
<p>This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.</p>
<p><a class="btn btn-ghost btn-lg" href="#" role="button">Learn more</a></p>
</div>
</div>
</div>
In the example below, the 400 x 400 background image is shown on top of the grid (which also contains a 100 x 100 image) because the 400 x 400 image markup is placed after the grid markup.
This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
<div class="jumbotron jumbo-style">
<div class="row">
<div class="col-xs-12">
<h1>Hello, world!</h1>
<img src="https://placeimg.com/100/100/tech" class="pull-right">
<p>This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.</p>
<p><a class="btn btn-ghost btn-lg" href="#" role="button">Learn more</a></p>
</div>
</div>
<img src="https://fakeimg.pl/400x400" alt="" title="" width="400" height="400">
</div>
The third party Picturefill plugin is implemented with a few markup updates. The last image specified in the markup is for mobile devices and the min-width
breakpoints specified align with Bootstrap's breakpoints.
This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
<div class="jumbotron jumbo-style">
<picture>
<!--[if IE 9]><video style="display: none;"><![endif]-->
<source srcset="https://fakeimg.pl/1200x800" media="(min-width: 1200px)">
<source srcset="https://fakeimg.pl/900x600" media="(min-width: 992px)">
<source srcset="https://fakeimg.pl/600x400" media="(min-width: 768px)">
<!--[if IE 9]></video><![endif]-->
<img srcset="https://fakeimg.pl/300x200" alt="…">
</picture>
<div class="row">
<div class="col-xs-12">
<h1>Hello, world!</h1>
<img src="https://placeimg.com/100/100/tech" class="pull-right">
<p>This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.</p>
<p><a class="btn btn-ghost btn-lg" href="#" role="button">Learn more</a></p>
</div>
</div>
</div>
Using the class .transition-image
for an <img>
tag enables it to be positioned lower than the container by setting a negative bottom margin with an inline style or through a JS DOM manipulation.
This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
<div class="jumbotron jumbo-style">
<h1>Hello, world!</h1>
<p>This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.</p>
<p><a class="btn btn-ghost btn-lg" href="#" role="button">Learn more</a></p>
<img class="transition-image" style="margin-bottom: -100px;" src="https://fakeimg.pl/100x100" alt="" title="">
</div>
<h3>Example heading <span class="label label-default">New</span></h3>
Add any of the below mentioned modifier classes to change the appearance of a label.
<span class="label label-default">Default</span>
<span class="label label-inverse">Inverse</span>
<span class="label label-important">Important</span>
<span class="label label-info">Info</span>
<span class="label label-success">Success</span>
<span class="label label-warning">Warning</span>
Rendering problems can arise when you have dozens of inline labels within a narrow container, each containing its own inline-block
element (like an icon). The way around this is setting display: inline-block;
. For context and an example, see #13219.
Includes 413 icons in font format from the LXCore custom "Lexicons" set. The icons are vector based, which allows them to be scaled to any size without image pixelation. Any color may also be applied through with .text--{color}
classes.
<i class="icon icon-flag-us" aria-hidden="true"></i>
Icon classes cannot be directly combined with other components. They should not be used along with other classes on the same element. Instead, add a nested <span>
and apply the icon classes to the <span>
.
Icon classes should only be used on elements that contain no text content and have no child elements.
Modern versions of assistive technologies will announce CSS generated content, as well as specific Unicode characters. To avoid unintended and confusing output in screen readers (particularly when icons are used purely for decoration), we hide them with the aria-hidden="true"
attribute.
If you're using an icon to convey meaning (rather than only as a decorative element), ensure that this meaning is also conveyed to assistive technologies – for instance, include additional content, visually hidden with the .sr-only
class.
If you're creating controls with no other text (such as a <button>>
that only contains an icon), you should always provide alternative content to identify the purpose of the control, so that it will make sense to users of assistive technologies. In this case, you could add an aria-label
attribute on the control itself.
<i class="icon icon-search" aria-hidden="true"></i>
Use icons in buttons, button groups for a toolbar, navigation, or prepended form inputs.
<button type="button" class="btn btn-default" aria-label="Rewind">
<i class="icon icon-triangle_left" aria-hidden="true"></i>
</button>
<button type="button" class="btn btn-default btn-lg">
<i class="icon icon-message_bubble" aria-hidden="true"></i> Chat
</button>
An icon used in an alert to convey that it's an error message should use additional .sr-only
text to convey this hint to users of assistive technologies.
<div class="alert alert-danger" role="alert">
<i class="icon icon-error" aria-hidden="true"></i>
<span class="sr-only">Error:</span>
Enter a valid email address
</div>
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.
<ul class="list-group">
<li class="list-group-item">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
<li class="list-group-item">Porta ac consectetur ac</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>
Add the badges component to any list group item and it will automatically be positioned on the right.
<ul class="list-group">
<li class="list-group-item">
<span class="badge">14</span>
Cras justo odio
</li>
</ul>
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.
<div class="list-group">
<a href="#" class="list-group-item active">
Cras justo odio
</a>
<a href="#" class="list-group-item">Dapibus ac facilisis in</a>
<a href="#" class="list-group-item">Morbi leo risus</a>
<a href="#" class="list-group-item">Porta ac consectetur ac</a>
<a href="#" class="list-group-item">Vestibulum at eros</a>
</div>
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.
<div class="list-group">
<button type="button" class="list-group-item">Cras justo odio</button>
<button type="button" class="list-group-item">Dapibus ac facilisis in</button>
<button type="button" class="list-group-item">Morbi leo risus</button>
<button type="button" class="list-group-item">Porta ac consectetur ac</button>
<button type="button" class="list-group-item">Vestibulum at eros</button>
</div>
Add .disabled
to a .list-group-item
to gray it out to appear disabled.
<div class="list-group">
<a href="#" class="list-group-item disabled">
Cras justo odio
</a>
<a href="#" class="list-group-item">Dapibus ac facilisis in</a>
<a href="#" class="list-group-item">Morbi leo risus</a>
<a href="#" class="list-group-item">Porta ac consectetur ac</a>
<a href="#" class="list-group-item">Vestibulum at eros</a>
</div>
Use contextual classes to style list items, default or linked. Also includes .active
state.
<ul class="list-group">
<li class="list-group-item list-group-item-success">Dapibus ac facilisis in</li>
<li class="list-group-item list-group-item-info">Cras sit amet nibh libero</li>
<li class="list-group-item list-group-item-warning">Porta ac consectetur ac</li>
<li class="list-group-item list-group-item-danger">Vestibulum at eros</li>
</ul>
<div class="list-group">
<a href="#" class="list-group-item list-group-item-success">Dapibus ac facilisis in</a>
<a href="#" class="list-group-item list-group-item-info">Cras sit amet nibh libero</a>
<a href="#" class="list-group-item list-group-item-warning">Porta ac consectetur ac</a>
<a href="#" class="list-group-item list-group-item-danger">Vestibulum at eros</a>
</div>
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.
<div class="list-group">
<a href="#" class="list-group-item active">
<h4 class="list-group-item-heading">List group item heading</h4>
<p class="list-group-item-text">...</p>
</a>
</div>
We are currently using multiple loading images across lexmark.com. Going forward we should use a standard loading image and its variations below.
These gifs were generated from https://icons8.com/preloaders/en/rectangular/squared-fading-blocks/ and use the following colors for each image:
Make sure to add the .hidden
class, so it only shows when triggered. If you wish to center the loading image, you must also include .center-block
.
<div class="loading-img-square hidden"></div>
Loading images are available in 3 sizes: small (24px), default (36px), and large (48px). To use the small size, add .loading-img-sm
to the div. To use the large size, add .loading-img-lg
to the div.
<div class="loading-img-square loading-img-lg center-block hidden"></div>
<div class="loading-img-square center-block hidden"></div>
<div class="loading-img-square loading-img-sm center-block hidden"></div>
The loading image will switch out automatically based on the background color it's displayed against.
If you need messaging for a whole page, use this loading modal.
<div class="wait-background-overlay hidden">
<div class="wait-window">
<div class="wait-image-section">
<div class="loading-img-square loading-img-lg center-block"></div>
</div>
<div class="wait-title-section">Loading</div>
<div class="wait-message-section"></div>
</div>
</div>
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.
<div class="media">
<div class="media-left">
<a href="#">
<img class="media-object" src="..." alt="...">
</a>
</div>
<div class="media-body">
<h4 class="media-heading">Media heading</h4>
...
</div>
</div>
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.
<div class="media">
<div class="media-left media-middle">
<a href="#">
<img class="media-object" src="..." alt="...">
</a>
</div>
<div class="media-body">
<h4 class="media-heading">Middle aligned media</h4>
...
</div>
</div>
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.
<ul class="media-list">
<li class="media">
<div class="media-left">
<a href="#">
<img class="media-object" src="..." alt="...">
</a>
</div>
<div class="media-body">
<h4 class="media-heading">Media heading</h4>
...
</div>
</li>
</ul>
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.
<nav class="navbar navbar-default">
<div class="container-fluid">
<!-- Brand and toggle get grouped for better mobile display -->
<div class="navbar-header">
<button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1" aria-expanded="false">
<span class="sr-only">Toggle navigation</span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="navbar-brand" href="#">Brand</a>
</div>
<!-- Collect the nav links, forms, and other content for toggling -->
<div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
<ul class="nav navbar-nav">
<li class="active"><a href="#">Link <span class="sr-only">(current)</span></a></li>
<li><a href="#">Link</a></li>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Dropdown <span class="caret"></span></a>
<ul class="dropdown-menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li role="separator" class="divider"></li>
<li><a href="#">Separated link</a></li>
<li role="separator" class="divider"></li>
<li><a href="#">One more separated link</a></li>
</ul>
</li>
</ul>
<form class="navbar-form navbar-left">
<div class="form-group">
<input type="text" class="form-control" placeholder="Search">
</div>
<button type="submit" class="btn btn-default">Submit</button>
</form>
<ul class="nav navbar-nav navbar-right">
<li><a href="#">Link</a></li>
<li class="dropdown">
<a href="#" class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Dropdown <span class="caret"></span></a>
<ul class="dropdown-menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li role="separator" class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</li>
</ul>
</div><!-- /.navbar-collapse -->
</div><!-- /.container-fluid -->
</nav>
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.
<nav class="navbar navbar-default">
<div class="container-fluid">
<div class="navbar-header">
<a class="navbar-brand" href="#">
<img alt="Brand" src="...">
</a>
</div>
</div>
</nav>
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.
<form class="navbar-form navbar-left" role="search">
<div class="form-group">
<input type="text" class="form-control" placeholder="Search">
</div>
<button type="submit" class="btn btn-default">Submit</button>
</form>
Add the .navbar-btn
class to <button>
elements not residing in a <form>
to vertically center them in the navbar.
<button type="button" class="btn btn-default navbar-btn">Sign in</button>
Wrap strings of text in an element with .navbar-text
, usually on a <p>
tag for proper leading and color.
<p class="navbar-text">Signed in as Mark Otto</p>
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.
<p class="navbar-text navbar-right">Signed in as <a href="#" class="navbar-link">Mark Otto</a></p>
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.
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>
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>
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
.
<nav class="navbar navbar-default navbar-static-top">
<div class="container">
...
</div>
</nav>
Modify the look of the navbar by adding .navbar-inverse
.
<nav class="navbar navbar-inverse">
...
</nav>
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.
To make tabs more accessible, the aria labels are important. Reference https://www.w3.org/TR/wai-aria-practices/examples/tabs/tabs-1/tabs.html for more information and best practice examples.
Note the .nav-tabs
class requires the .nav
base class.
<ul class="nav nav-tabs" role="tablist" aria-label="how to use tabs">
<li role="presentation" class="active">
<a href="#tabsexample1" role="tab" aria-selected="true" aria-controls="open example 1 tab" data-toggle="tab">Example 1</a>
</li>
<li role="presentation">
<a href="#tabsexample2" role="tab" aria-selected="false" aria-controls="open example 2 tab" data-toggle="tab">Example 2</a>
</li>
<li role="presentation">
<a href="#tabsexample3" role="tab" aria-selected="false" aria-controls="open example 3 tab" data-toggle="tab">Example 3</a>
</li>
<li role="presentation">
<a href="http://www.bobrosslipsum.com/" role="tab" aria-selected="false" aria-controls="external link: open Wikipedia page" target="_blank" rel="noopener">External link <i class="icon icon-send_to" aria-hidden="true"></i></a>
</li>
</ul>
<div class="tab-content">
<div id="tabsexample1" class="tab-pane active" role="tabpanel" aria-selected="true" aria-labelledby="example 1 content">
...
</div>
<div id="tabsexample2" class="tab-pane" role="tabpanel" aria-labelledby="example 2 content">
...
</div>
<div id="tabsexample3" class="tab-pane" role="tabpanel" aria-labelledby="example 3 content">
...
</div>
</div>
Take that same HTML structure, but use .nav-pills
instead. This example also shows how to change the markup when tabs are treated as navigational links.
<div role="navigation" aria-label="how to use navigation pills">
<ul class="nav nav-pills">
...
</ul>
</div>
Pills can also be vertically stacked. Just add .nav-stacked
.
<div role="navigation" aria-label="how to use vertically stacked navigation pills">
<ul class="nav nav-pills nav-stacked">
...
</ul>
</div>
Justified navbar nav links are currently not supported.
For any nav component (tabs or pills), add .disabled
for gray links and no hover effects.
<ul class="nav nav-pills">
...
<li role="presentation" class="disabled"><a href="#">Disabled link</a></li>
...
</ul>
Add dropdown menus with a little extra HTML and the dropdowns JavaScript plugin.
<ul class="nav nav-tabs" role="tablist" aria-label="how to use tabs with dropdowns">
...
<li role="presentation" class="dropdown">
<a href="#moredevicestabdrop" role="button" class="dropdown-toggle" aria-haspopup="true" aria-selected="false" aria-expanded="false" data-toggle="dropdown" aria-label="expand similar device options">Locations <span class="caret"></span>
</a>
<ul class="dropdown-menu">
...
</ul>
</li>
...
</ul>
<div role="navigation" aria-label="how to use pills with dropdowns">
<ul class="nav nav-pills">
...
<li role="presentation" class="dropdown">
<a href="#locationspilldrop" role="button" class="dropdown-toggle" aria-haspopup="true" aria-expanded="false" aria-expanded="false" data-toggle="dropdown" aria-label="expand location options">Locations <span class="caret"></span>
</a>
<ul class="dropdown-menu">
...
</ul>
</li>
...
</ul>
</div>
These navs can be placed in either the right or left rail and have a base class of .nav
with an extra class of .nav-rail
for necessary styling. The nav should also always be wrapped in a nav
html element.
The affixed nav uses the bootstrap scrollspy and affix plugins to work properly. It needs the class .nav-affix
applied to the nav
element for ready-made javascript and it is then styled with the class .nav-rail
class on the ul
element.
For more uses of the affix plugin, see the affix javascript page
<nav>
<ul class="nav nav-rail">
<li class="nav-title"><span>Project Name</span>
<div class="railnav-trigger">Navigate Section</div>
<ul class="nav">
<li class="active"><a href="#">Current active page</a>
<ul class="nav">
<li><a href="#">Child Link</a></li>
<li><a href="#">Child Link</a></li>
<li><a href="#">Child Link</a></li>
<li><a href="#">Child Link</a></li>
</ul>
</li>
<li><a href="#">Sibling</a></li>
<li><a href="#">Sibling</a></li>
<li><a href="#">Sibling</a></li>
<li><a href="#">Sibling</a></li>
<li><a href="#">Sibling</a></li>
</ul>
</li>
</ul>
</nav>
$("#navigation-frame").html('...');
$("#affix-nav-example").addClass("nav-affix");
$(document).lxk_navigation();
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).
<div class="page-header">
<h1>Example page header <small>Subtext for header</small></h1>
</div>
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).
<div class="page-header">
<h1>Example page header <small>Subtext for header</small></h1>
</div>
Design patterns for pagination should be chosen based on the specific environment it will be used. We do not have a one-pagination-fits-all. Refer to the sections below to help you determine the best pagination pattern to use for your specific UX/UI needs. Our design was inspired by Rdio. It features large blocks to accommodate ideal click/touch areas.
This pagination is our most used design pattern. Best for search results where only a small number of returned results are expected (5 pages or less). If this pattern is used with more than 5 pages, the placeholder ellipsis would be used to keep the pagination from breaking on small mobile phones, which is not the most ideal experience. In that case, it would be better to use the page number input design.
<nav aria-label="Search results navigation">
<ul class="pagination">
<li>
<a href="#" aria-label="Previous">
<span aria-hidden="true">‹</span>
</a>
</li>
<li><a href="#">1</a></li>
<li><a href="#">2</a></li>
<li><a href="#">3</a></li>
<li><a href="#">4</a></li>
<li><a href="#">5</a></li>
<li>
<a href="#" aria-label="Next">
<span aria-hidden="true">›</span>
</a>
</li>
</ul>
</nav>
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 navigation"
.
Links are customizable for different circumstances. Use .disabled
for unclickable links and .active
to indicate the current page.
<nav aria-label="...">
<ul class="pagination">
<li class="disabled"><a href="#" aria-label="Previous"><span aria-hidden="true">‹</span></a></li>
<li class="active"><a href="#">1 <span class="sr-only">(current)</span></a></li>
...
</ul>
</nav>
You can optionally 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.
<nav aria-label="...">
<ul class="pagination">
<li class="disabled">
<i class="icon icon-caret_left_thin" aria-hidden="true"></i>
</li>
<li class="active">
<span>1 <span class="sr-only">(current)</span></span>
</li>
...
</ul>
</nav>
Add .pagination-lg
or .pagination-sm
for additional sizes.
<nav aria-label="..."><ul class="pagination pagination-lg">...</ul></nav>
<nav aria-label="..."><ul class="pagination">...</ul></nav>
<nav aria-label="..."><ul class="pagination pagination-sm">...</ul></nav>
This pagination is based on our default design, but is tailored for searches that will return a large number of results (6 pages or more). The input box allows users to manually type in a specific page number. Users can advance to the first or last page, in addition to one page prior or next. Links can also use the general .disabled
utility class from the default pagination design. The additional sizing options are not availabe for this layout, because it has built-in resizing for touch devices. Add .pull-right
to the ul
tag to right-align pagination.
<nav aria-label="Search results navigation">
<ul class="pagination page-number-input">
<li class="disabled">
<a href="#" aria-label="First">
<span aria-hidden="true">«</span>
</a>
</li>
<li class="disabled">
<a href="#" aria-label="Previous">
<span aria-hidden="true">‹</span>
</a>
</li>
<li>
<form class="form-inline no-labels">
<div class="form-group">
<label class="sr-only" for="currentPageNumber">Current Page</label>
<div class="input-group">
<input type="number" class="form-control" name="currentPageNumber" id="currentPageNumber" value="1">
<div class="input-group-addon">of 845</div>
</div>
</div>
</form>
</li>
<li>
<a href="#" aria-label="Next">
<span aria-hidden="true">›</span>
</a>
</li>
<li>
<a href="#" aria-label="Last">
<span aria-hidden="true">»</span>
</a>
</li>
</ul>
</nav>
This design pattern is best used for navigating from page to page within a blog, magazine, PDF, etc. Links can also use the general .disabled
utility class from the default pagination design.
When using pagination designs containing words in addition to icons, translations need to be considered, especially when used outside of english-speaking locales.
By default, the buttons are centered within the div. The words and arrow styles are interchangable.
<nav aria-label="...">
<ul class="pager">
<li><a href="#"><span aria-hidden="true">‹</span> Previous</a></li>
<li><a href="#">Next <span aria-hidden="true">›</span></a></li>
</ul>
</nav>
Alternatively, you can align each button to their respective sides. Add class="previous"
and class="next"
to the li
tags.
<nav aria-label="...">
<ul class="pager">
<li class="previous"><a href="#"><span aria-hidden="true">←</span> Older</a></li>
<li class="next"><a href="#">Newer <span aria-hidden="true">→</span></a></li>
</ul>
</nav>
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.
<div class="panel panel-default">
<div class="panel-body">
Basic panel example
</div>
</div>
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
.
<div class="panel panel-default">
<div class="panel-heading">Panel heading without title</div>
<div class="panel-body">
Panel content
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading">
<h3 class="panel-title">Panel title</h3>
</div>
<div class="panel-body">
Panel content
</div>
</div>
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.
<div class="panel panel-default">
<div class="panel-body">
Panel content
</div>
<div class="panel-footer">Panel footer</div>
</div>
Like other components, easily make a panel more meaningful to a particular context by adding any of the contextual state classes.
<div class="panel panel-primary">...</div>
<div class="panel panel-success">...</div>
<div class="panel panel-info">...</div>
<div class="panel panel-warning">...</div>
<div class="panel panel-danger">...</div>
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 |
<div class="panel panel-default">
<!-- Default panel contents -->
<div class="panel-heading">Panel heading</div>
<div class="panel-body">
<p>...</p>
</div>
<!-- Table -->
<table class="table">
...
</table>
</div>
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 |
<div class="panel panel-default">
<!-- Default panel contents -->
<div class="panel-heading">Panel heading</div>
<!-- Table -->
<table class="table">
...
</table>
</div>
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.
<div class="panel panel-default">
<!-- Default panel contents -->
<div class="panel-heading">Panel heading</div>
<div class="panel-body">
<p>...</p>
</div>
<!-- List group -->
<ul class="list-group">
<li class="list-group-item">Cras justo odio</li>
<li class="list-group-item">Dapibus ac facilisis in</li>
<li class="list-group-item">Morbi leo risus</li>
<li class="list-group-item">Porta ac consectetur ac</li>
<li class="list-group-item">Vestibulum at eros</li>
</ul>
</div>
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 Internet Explorer 9 and below or older versions of Firefox. Opera 12 does not support animations.
If your website has a Content Security Policy (CSP) which doesn't allow style-src 'unsafe-inline'
, then you won't be able to use inline style
attributes to set progress bar widths as shown in our examples below. Alternative methods for setting the widths that are compatible with strict CSPs include using a little custom JavaScript (that sets element.style.width
) or using custom CSS classes.
Default progress bar.
<div class="progress">
<div class="progress-bar" role="progressbar" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100" style="width: 60%;">
<span class="sr-only">60% Complete</span>
</div>
</div>
Remove the <span>
with .sr-only
class from within the progress bar to show a visible percentage.
<div class="progress">
<div class="progress-bar" role="progressbar" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100" style="width: 60%;">
60%
</div>
</div>
To ensure that the label text remains legible even for low percentages, consider adding a min-width
to the progress bar.
<div class="progress">
<div class="progress-bar" role="progressbar" aria-valuenow="0" aria-valuemin="0" aria-valuemax="100" style="min-width: 2em;">
0%
</div>
</div>
<div class="progress">
<div class="progress-bar" role="progressbar" aria-valuenow="2" aria-valuemin="0" aria-valuemax="100" style="min-width: 2em; width: 2%;">
2%
</div>
</div>
Progress bars use some of the same button and alert classes for consistent styles.
<div class="progress">
<div class="progress-bar progress-bar-success" role="progressbar" aria-valuenow="40" aria-valuemin="0" aria-valuemax="100" style="width: 40%">
<span class="sr-only">40% Complete (success)</span>
</div>
</div>
<div class="progress">
<div class="progress-bar progress-bar-important" role="progressbar" aria-valuenow="40" aria-valuemin="0" aria-valuemax="100" style="width: 70%">
<span class="sr-only">70% Complete (important)</span>
</div>
</div>
<div class="progress">
<div class="progress-bar progress-bar-info" role="progressbar" aria-valuenow="20" aria-valuemin="0" aria-valuemax="100" style="width: 20%">
<span class="sr-only">20% Complete (information)</span>
</div>
</div>
<div class="progress">
<div class="progress-bar progress-bar-warning" role="progressbar" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100" style="width: 60%">
<span class="sr-only">60% Complete (warning)</span>
</div>
</div>
Uses a gradient to create a striped effect. Not available in IE9 and below.
<div class="progress">
<div class="progress-bar progress-bar-success progress-bar-striped" role="progressbar" aria-valuenow="40" aria-valuemin="0" aria-valuemax="100" style="width: 40%">
<span class="sr-only">40% Complete (success)</span>
</div>
</div>
<div class="progress">
<div class="progress-bar progress-bar-important progress-bar-striped" role="progressbar" aria-valuenow="40" aria-valuemin="0" aria-valuemax="100" style="width: 70%">
<span class="sr-only">70% Complete (important)</span>
</div>
</div>
<div class="progress">
<div class="progress-bar progress-bar-info progress-bar-striped" role="progressbar" aria-valuenow="20" aria-valuemin="0" aria-valuemax="100" style="width: 20%">
<span class="sr-only">20% Complete (information</span>
</div>
</div>
<div class="progress">
<div class="progress-bar progress-bar-warning progress-bar-striped" role="progressbar" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100" style="width: 60%">
<span class="sr-only">60% Complete (warning)</span>
</div>
</div>
Add .active
to .progress-bar-striped
to animate the stripes right to left. Not available in IE9 and below.
<div class="progress">
<div class="progress-bar progress-bar-striped active" role="progressbar" aria-valuenow="45" aria-valuemin="0" aria-valuemax="100" style="width: 45%">
<span class="sr-only">45% Complete</span>
</div>
</div>
Place multiple bars into the same .progress
to stack them.
<div class="progress">
<div class="progress-bar progress-bar-success" style="width: 35%">
<span class="sr-only">35% Complete (success)</span>
</div>
<div class="progress-bar progress-bar-warning progress-bar-striped" style="width: 20%">
<span class="sr-only">20% Complete (warning)</span>
</div>
<div class="progress-bar progress-bar-danger" style="width: 10%">
<span class="sr-only">10% Complete (danger)</span>
</div>
</div>
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.
<!-- 16:9 aspect ratio -->
<div class="embed-responsive embed-responsive-16by9">
<iframe class="embed-responsive-item" src="..."></iframe>
</div>
<!-- 4:3 aspect ratio -->
<div class="embed-responsive embed-responsive-4by3">
<iframe class="embed-responsive-item" src="..."></iframe>
</div>
Add any of the alignment helper classes to the <div>
container with the .social
class to align the area to center (.text-left
) or right(.text-right
). Left alignment is the default; therefore, no additional class is needed.
<div class="social">
<div class="social-heading">Share this page</div>
<div class="social-btns">
<a href="#facebook" target="_blank" rel="noopener" title="Share this page on Facebook" class="social-btn social-btn-facebook"></a>
<a href="#twitter" target="_blank" rel="noopener" title="Share this page on Twitter" class="social-btn social-btn-twitter"></a>
<a href="#linkedin" target="_blank" rel="noopener" title="Share this page on LinkedIn" class="social-btn social-btn-linkedin"></a>
</div>
</div>
<div class="social text-center">
<div class="social-heading">Share this page</div>
<div class="social-btns">
<a href="#facebook" target="_blank" rel="noopener" title="Share this page on Facebook" class="social-btn social-btn-facebook"></a>
<a href="#twitter" target="_blank" rel="noopener" title="Share this page on Twitter" class="social-btn social-btn-twitter"></a>
<a href="#linkedin" target="_blank" rel="noopener" title="Share this page on LinkedIn" class="social-btn social-btn-linkedin"></a>
</div>
</div>
<div class="social text-right">
<div class="social-heading">Share this page</div>
<div class="social-btns">
<a href="#facebook" target="_blank" rel="noopener" title="Share this page on Facebook" class="social-btn social-btn-facebook"></a>
<a href="#twitter" target="_blank" rel="noopener" title="Share this page on Twitter" class="social-btn social-btn-twitter"></a>
<a href="#linkedin" target="_blank" rel="noopener" title="Share this page on LinkedIn" class="social-btn social-btn-linkedin"></a>
</div>
</div>
<div class="social text-center">
<div class="social-heading">Share this page</div>
<div class="social-btns">
<a href="#facebook" target="_blank" rel="noopener" title="Share this page on Facebook" class="social-btn social-btn-facebook"></a>
<a href="#twitter" target="_blank" rel="noopener" title="Share this page on Twitter" class="social-btn social-btn-twitter"></a>
<a href="#linkedin" target="_blank" rel="noopener" title="Share this page on LinkedIn" class="social-btn social-btn-linkedin"></a>
</div>
</div>
<div class="social social-inline text-center">
<div class="social-heading">Share this page</div>
<div class="social-btns">
<a href="#facebook" target="_blank" rel="noopener" title="Share this page on Facebook" class="social-btn social-btn-facebook"></a>
<a href="#twitter" target="_blank" rel="noopener" title="Share this page on Twitter" class="social-btn social-btn-twitter"></a>
<a href="#linkedin" target="_blank" rel="noopener" title="Share this page on LinkedIn" class="social-btn social-btn-linkedin"></a>
</div>
</div>
<div class="social social-dark text-center">
<div class="social-heading">Share this page</div>
<div class="social-btns">
<a href="#facebook" target="_blank" rel="noopener" title="Share this page on Facebook" class="social-btn social-btn-facebook"></a>
<a href="#twitter" target="_blank" rel="noopener" title="Share this page on Twitter" class="social-btn social-btn-twitter"></a>
<a href="#linkedin" target="_blank" rel="noopener" title="Share this page on LinkedIn" class="social-btn social-btn-linkedin"></a>
</div>
</div>
<div class="social social-inline social-dark text-center">
<div class="social-heading">Share this page</div>
<div class="social-btns">
<a href="#facebook" target="_blank" rel="noopener" title="Share this page on Facebook" class="social-btn social-btn-facebook"></a>
<a href="#twitter" target="_blank" rel="noopener" title="Share this page on Twitter" class="social-btn social-btn-twitter"></a>
<a href="#linkedin" target="_blank" rel="noopener" title="Share this page on LinkedIn" class="social-btn social-btn-linkedin"></a>
</div>
</div>
<div class="social social-light text-center">
<div class="social-heading">Share this page</div>
<div class="social-btns">
<a href="#facebook" target="_blank" rel="noopener" title="Share this page on Facebook" class="social-btn social-btn-facebook"></a>
<a href="#twitter" target="_blank" rel="noopener" title="Share this page on Twitter" class="social-btn social-btn-twitter"></a>
<a href="#linkedin" target="_blank" rel="noopener" title="Share this page on LinkedIn" class="social-btn social-btn-linkedin"></a>
</div>
</div>
<div class="social social-inline social-light text-center">
<div class="social-heading">Share this page</div>
<div class="social-btns">
<a href="#facebook" target="_blank" rel="noopener" title="Share this page on Facebook" class="social-btn social-btn-facebook"></a>
<a href="#twitter" target="_blank" rel="noopener" title="Share this page on Twitter" class="social-btn social-btn-twitter"></a>
<a href="#linkedin" target="_blank" rel="noopener" title="Share this page on LinkedIn" class="social-btn social-btn-linkedin"></a>
</div>
</div>
<div class="social text-center">
<div class="social-heading">Share this page</div>
<div class="social-btns">
<a href="#facebook" target="_blank" rel="noopener" title="Share this page on Facebook" class="social-btn social-btn-facebook"></a>
<a href="#twitter" target="_blank" rel="noopener" title="Share this page on Twitter" class="social-btn social-btn-twitter"></a>
<a href="#linkedin" target="_blank" rel="noopener" title="Share this page on LinkedIn" class="social-btn social-btn-linkedin"></a>
</div>
</div>
<div class="social social-inline text-center">
<div class="social-heading">Share this page</div>
<div class="social-btns">
<a href="#facebook" target="_blank" rel="noopener" title="Share this page on Facebook" class="social-btn social-btn-facebook"></a>
<a href="#twitter" target="_blank" rel="noopener" title="Share this page on Twitter" class="social-btn social-btn-twitter"></a>
<a href="#linkedin" target="_blank" rel="noopener" title="Share this page on LinkedIn" class="social-btn social-btn-linkedin"></a>
</div>
</div>
Tag your categories with a bit of style.
The following examples provide a way to style tags for use in displaying keywords or terms within search filters and other related uses. Interaction functionality must be developed separately.
The styles tag
, tag-active
, tag-not-active
, and tag-close-btn
may be used on either <a>
or <div>
tags.
<div class="tag-group">
<div class="tag tag-active">Active</div>
<div class="tag tag-not-active">Inactive</div>
</div>
<div class="tag-group">
<a class="tag tag-active">Active</a>
<a class="tag tag-not-active">Inactive</a>
</div>
<div class="tag-group">
<div class="tag tag-close-btn tag-active">Category 1</div>
<div class="tag tag-close-btn tag-active">Category 2</div>
<div class="tag tag-close-btn tag-active">Category 3</div>
</div>
<div class="tag-group">
<a class="tag tag-close-btn tag-active">Category 1</a>
<a class="tag tag-close-btn tag-active">Category 2</a>
<a class="tag tag-close-btn tag-active">Category 3</a>
</div>
<div class="tag-group">
<div class="tag tag-add-btn tag-active">Category 1</div>
<div class="tag tag-add-btn tag-active">Category 2</div>
<div class="tag tag-add-btn tag-active">Category 3</div>
</div>
<div class="tag-group">
<a class="tag tag-add-btn tag-active">Category 1</a>
<a class="tag tag-add-btn tag-active">Category 2</a>
<a class="tag tag-add-btn tag-active">Category 3</a>
</div>
<div class="tag-group">
<div class="tag tag-checkmark-btn tag-active">Category 1</div>
<div class="tag tag-checkmark-btn tag-active">Category 2</div>
<div class="tag tag-checkmark-btn tag-active">Category 3</div>
</div>
<div class="tag-group">
<a class="tag tag-checkmark-btn tag-active">Category 1</a>
<a class="tag tag-checkmark-btn tag-active">Category 2</a>
<a class="tag tag-checkmark-btn tag-active">Category 3</a>
</div>
<div class="tag-group">
<div class="tag">Category 1</div>
<div class="tag">Category 2</div>
<div class="tag">Category 3</div>
<div class="tag">Category 4</div>
<div class="tag">Category 5</div>
<div class="tag">Category 6</div>
<div class="tag">Category 7</div>
<div class="tag">Category 8</div>
<div class="tag">Category 9</div>
<div class="tag">Category 10</div>
<div class="tag">Category 11</div>
<div class="tag">Category 12</div>
<div class="tag">Category 13</div>
<div class="tag">Category 14</div>
<div class="tag">Category 15</div>
<div class="tag">Category 16</div>
<div class="tag">Category 17</div>
<div class="tag">Category 18</div>
<div class="tag">Category 19</div>
<div class="tag">Category 20</div>
<div class="tag">Category 21</div>
<div class="tag">Category 22</div>
<div class="tag">Category 23</div>
<div class="tag">Category 24</div>
</div>
The examples shown below use the following additional tag color classes based upon our site's color classes.
<div class="tag-group">
<div class="tag tag-add-btn tag-active tag-border-b1">tag-border-b1</div>
<div class="tag tag-close-btn tag-active tag-border-b2">tag-border-b2</div>
<div class="tag tag-checkmark-btn tag-active tag-border-b3">tag-border-b3</div>
<div class="tag tag-add-btn tag-active tag-border-b4">tag-border-b4</div>
<div class="tag tag-close-btn tag-active tag-border-b5">tag-border-b5</div>
<div class="tag tag-checkmark-btn tag-active tag-border-b6">tag-border-b6</div>
<div class="tag tag-add-btn tag-active tag-border-b7">tag-border-b7</div>
<div class="tag tag-close-btn tag-active tag-border-b8">tag-border-b8</div>
<div class="tag tag-checkmark-btn tag-active tag-border-b9">tag-border-b9</div>
<div class="tag tag-add-btn tag-active tag-border-b10">tag-border-b10</div>
</div>
<div class="tag-group">
<div class="tag tag-close-btn tag-active tag-border-n1">tag-border-n1</div>
<div class="tag tag-checkmark-btn tag-active tag-border-n2">tag-border-n2</div>
<div class="tag tag-add-btn tag-active tag-border-n3">tag-border-n3</div>
<div class="tag tag-close-btn tag-active tag-border-n4">tag-border-n4</div>
<div class="tag tag-checkmark-btn tag-active tag-border-n5">tag-border-n5</div>
<div class="tag tag-add-btn tag-active tag-border-n6">tag-border-n6</div>
</div>
<div class="tag-group">
<div class="tag tag-close-btn tag-active tag-border-black">tag-border-black</div>
<div class="tag tag-checkmark-btn tag-active tag-border-white">tag-border-white</div>
</div>
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.
<div class="row">
<div class="col-xs-6 col-md-3">
<a href="#" class="thumbnail">
<img src="..." alt="...">
</a>
</div>
...
</div>
With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.
<div class="row">
<div class="col-sm-6 col-md-4">
<div class="thumbnail">
<img src="..." alt="...">
<div class="caption">
<h3>Thumbnail label</h3>
<p>...</p>
<p><a href="#" class="btn btn-primary" role="button">Button</a> <a href="#" class="btn btn-default" role="button">Button</a></p>
</div>
</div>
</div>
</div>
Instead of using a <div>
for the thumbnail
wrapper element, instead use an <a>
tag with the class of thumbnail
. Then add a <p>
tag with a class of call-to-action
to meet usability requirements.
<a href="..." class="thumbnail">
<img src="..." alt="...">
<div class="caption">
<h3>Thumbnail label</h3>
<p>...</p>
<p class="call-to-action">Call to Action</p>
</div>
</a>
Apply a class of thumbnail-text
to the thumbnail outer <div>
and wrap the thumbnail content with a <div>
and color class of .bg-**
to style a text-only thumbnail properly.
<a href="..." class="thumbnail thumbnail-text">
<div class="bg-n2">
<div class="caption">
<h3>Thumbnail label</h3>
<p>...</p>
</div>
</div>
</a>
For horizontally placed thumbnails with custom content use the grid system to properly place image and text for all screen sizes. The <img>
will need a class of img-responsive
applied to it for proper sizing.
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.
<div class="thumbnail">
<div class="row">
<div class="col-sm-4">
<img class="img-responsive" src="..." alt="...">
</div>
<div class="col-sm-8">
<div class="caption">
...
</div>
</div>
</div> <!-- /.row -->
</div> <!-- /.thumbnail -->
Use the well as a simple effect on an element to give it an inset effect.
<div class="well">...</div>
Control padding and rounded corners with two optional modifier classes.
<div class="well well-lg">...</div>
<div class="well well-sm">...</div>
Control shadow one optional modifier classes.
<div class="well no-shadow">...</div>
Control borders two optional modifier classes.
<div class="well no-shadow border-top">...</div>
<div class="well no-shadow border-bottom">...</div>
<div class="well no-shadow border-bottom border-top border--b6">...</div>