-
Notifications
You must be signed in to change notification settings - Fork 0
Design Style Guide
<h1 id="grid">Grid system</h1>
<p class="lead">Bootstrap includes a responsive, mobile first fluid grid system that appropriately scales up to 12 columns as the device or viewport size increases.</p>
<h3 id="grid-intro">Introduction</h3>
<p>Grid systems are used for creating page layouts through a series of rows and columns that house your content. Here's how the Bootstrap grid system works:</p>
<ul>
<li>Rows must be placed within a <code>.container</code> for proper alignment and padding.</li>
<li>Use rows to create horizontal groups of columns.</li>
<li>Content should be placed within columns, and only columns may be immediate children of rows.</li>
<li>Predefined grid classes like <code>.row</code> and <code>.col-xs-4</code> are available for quickly making grid layouts.</li>
<li>Columns create gutters (gaps between column content) via <code>padding</code>. That padding is offset in rows for the first and last column via negative margin on <code>.row</code>s.</li>
<li>Grid columns are created by specifying the number of twelve available columns you wish to span. For example, three equal columns would use three <code>.col-xs-4</code>.</li>
</ul>
<p>Look to the examples for applying these principles to your code.</p>
<div class="bs-callout bs-callout-info">
<h4>Grids and full-width layouts</h4>
<p>Folks looking to create fully fluid layouts (meaning your site stretches the entire width of the viewport) must wrap their grid content in a containing element with <code>padding: 0 15px;</code> to offset the <code>margin: 0 -15px;</code> used on <code>.row</code>s.</p>
</div>
<h3 id="grid-options">Grid options</h3>
<p>See how aspects of the Bootstrap grid system work across multiple devices with a handy table.</p>
<div class="table-responsive">
<table class="table table-bordered table-striped">
<thead>
<tr>
<th></th>
<th> Extra small devices <small>Phones (<768px)</small> </th>
<th> Small devices <small>Tablets (≥768px)</small> </th>
<th> Medium devices <small>Desktops (≥992px)</small> </th>
<th> Large devices <small>Desktops (≥1200px)</small> </th>
</tr>
</thead>
<tbody>
<tr>
<th>Grid behavior</th>
<td>Horizontal at all times</td>
<td colspan="3">Collapsed to start, horizontal above breakpoints</td>
</tr>
<tr>
<th>Max container width</th>
<td>None (auto)</td>
<td>750px</td>
<td>970px</td>
<td>1170px</td>
</tr>
<tr>
<th>Class prefix</th>
<td><code>.col-xs-</code></td>
<td><code>.col-sm-</code></td>
<td><code>.col-md-</code></td>
<td><code>.col-lg-</code></td>
</tr>
<tr>
<th># of columns</th>
<td colspan="4">12</td>
</tr>
<tr>
<th>Max column width</th>
<td class="text-muted">Auto</td>
<td>60px</td>
<td>78px</td>
<td>95px</td>
</tr>
<tr>
<th>Gutter width</th>
<td colspan="4">30px (15px on each side of a column)</td>
</tr>
<tr>
<th>Nestable</th>
<td colspan="4">Yes</td>
</tr>
<tr>
<th>Offsets</th>
<td colspan="1" class="text-muted">N/A</td>
<td colspan="3">Yes</td>
</tr>
<tr>
<th>Column ordering</th>
<td class="text-muted">N/A</td>
<td colspan="3">Yes</td>
</tr>
</tbody>
</table>
</div>
<p>Grid classes apply to devices with screen widths greater than or equal to the breakpoint sizes, and override grid classes targeted at smaller devices. Therefore, applying any <code>.col-md-</code> class to an element will not only affect its styling on medium devices but also on large devices if a <code>.col-lg-</code> class is not present.</p>
<h3 id="grid-example-basic">Example: Stacked-to-horizontal</h3>
<p>Using a single set of <code>.col-md-*</code> grid classes, you can create a basic grid system that starts out stacked on mobile devices and tablet devices (the extra small to small range) before becoming horizontal on desktop (medium) devices. Place grid columns in any <code>.row</code>.</p>
<div class="bs-docs-grid">
<div class="row show-grid">
<div class="col-md-1">.col-md-1</div>
<div class="col-md-1">.col-md-1</div>
<div class="col-md-1">.col-md-1</div>
<div class="col-md-1">.col-md-1</div>
<div class="col-md-1">.col-md-1</div>
<div class="col-md-1">.col-md-1</div>
<div class="col-md-1">.col-md-1</div>
<div class="col-md-1">.col-md-1</div>
<div class="col-md-1">.col-md-1</div>
<div class="col-md-1">.col-md-1</div>
<div class="col-md-1">.col-md-1</div>
<div class="col-md-1">.col-md-1</div>
</div>
<div class="row show-grid">
<div class="col-md-8">.col-md-8</div>
<div class="col-md-4">.col-md-4</div>
</div>
<div class="row show-grid">
<div class="col-md-4">.col-md-4</div>
<div class="col-md-4">.col-md-4</div>
<div class="col-md-4">.col-md-4</div>
</div>
<div class="row show-grid">
<div class="col-md-6">.col-md-6</div>
<div class="col-md-6">.col-md-6</div>
</div>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"row"</span><span class="nt">></span>
<div class="col-md-1">.col-md-1</div> <div class="col-md-1">.col-md-1</div>
<div class="col-md-1">.col-md-1</div> <div class="col-md-1">.col-md-1</div> <div class="col-md-1">.col-md-1</div>
<div class="col-md-1">.col-md-1</div> <div class="col-md-1">.col-md-1</div> <div class="col-md-1">.col-md-1</div>
<div class="col-md-1">.col-md-1</div> <div class="col-md-1">.col-md-1</div> <div class="col-md-1">.col-md-1</div>
<div class="col-md-1">.col-md-1</div> </div> <div class="row"> <div class="col-md-8">.col-md-8</div>
<div class="col-md-4">.col-md-4</div> </div> <div class="row"> <div class="col-md-4">.col-md-4</div>
<div class="col-md-4">.col-md-4</div> <div class="col-md-4">.col-md-4</div> </div>
<div class="row"> <div class="col-md-6">.col-md-6</div> <div class="col-md-6">.col-md-6</div>
</div>
Don't want your columns to simply stack in smaller devices? Use the extra small and medium device grid classes by adding .col-xs-
.col-md-
to your columns. See the example below for a better idea of how it all works.
<!-- Stack the columns on mobile by making one full-width and the other half-width -->
<div class="row">
<div class="col-xs-12 col-md-8">.col-xs-12 .col-md-8</div>
<div class="col-xs-6 col-md-4">.col-xs-6 .col-md-4</div>
</div>
<!-- Columns start at 50% wide on mobile and bump up to 33.3% wide on desktop -->
<div class="row">
<div class="col-xs-6 col-md-4">.col-xs-6 .col-md-4</div>
<div class="col-xs-6 col-md-4">.col-xs-6 .col-md-4</div>
<div class="col-xs-6 col-md-4">.col-xs-6 .col-md-4</div>
</div>
<!-- Columns are always 50% wide, on mobile and desktop -->
<div class="row">
<div class="col-xs-6">.col-xs-6</div>
<div class="col-xs-6">.col-xs-6</div>
</div>
Build on the previous example by creating even more dynamic and powerful layouts with tablet .col-sm-*
classes.
<div class="row">
<div class="col-xs-12 col-sm-6 col-md-8">.col-xs-12 .col-sm-6 .col-md-8</div>
<div class="col-xs-6 col-md-4">.col-xs-6 .col-md-4</div>
</div>
<div class="row">
<div class="col-xs-6 col-sm-4">.col-xs-6 .col-sm-4</div>
<div class="col-xs-6 col-sm-4">.col-xs-6 .col-sm-4</div>
<!-- Optional: clear the XS cols if their content doesn't match in height -->
<div class="clearfix visible-xs"></div>
<div class="col-xs-6 col-sm-4">.col-xs-6 .col-sm-4</div>
</div>
With the four tiers of grids available you're bound to run into issues where, at certain breakpoints, your columns don't clear quite right as one is taller than the other. To fix that, use a combination of a .clearfix
and our responsive utility classes.
Resize your viewport or check it out on your phone for an example.
<div class="row">
<div class="col-xs-6 col-sm-3">.col-xs-6 .col-sm-3</div>
<div class="col-xs-6 col-sm-3">.col-xs-6 .col-sm-3</div>
<!-- Add the extra clearfix for only the required viewport -->
<div class="clearfix visible-xs"></div>
<div class="col-xs-6 col-sm-3">.col-xs-6 .col-sm-3</div>
<div class="col-xs-6 col-sm-3">.col-xs-6 .col-sm-3</div>
</div>
In addition to column clearing at responsive breakpoints, you may need to reset offsets, pushes, or pulls. Those resets are available for medium and large grid tiers only, since they start only at the (second) small grid tier. See this in action in the grid example.
<div class="row">
<div class="col-sm-5 col-md-6">.col-sm-5 .col-md-6</div>
<div class="col-sm-5 col-sm-offset-2 col-md-6 col-md-offset-0">.col-sm-5 .col-sm-offset-2 .col-md-6 .col-md-offset-0</div>
</div>
<div class="row">
<div class="col-sm-6 col-md-5 col-lg-6">.col-sm-6 .col-md-5 .col-lg-6</div>
<div class="col-sm-6 col-md-5 col-md-offset-2 col-lg-6 col-lg-offset-0">.col-sm-6 .col-md-5 .col-md-offset-2 .col-lg-6 .col-lg-offset-0</div>
</div>
Move columns to the right using .col-md-offset-
classes. These classes increase the left margin of a column by columns. For example,
.col-md-offset-4
moves .col-md-4
over four columns.
<div class="row">
<div class="col-md-4">.col-md-4</div>
<div class="col-md-4 col-md-offset-4">.col-md-4 .col-md-offset-4</div>
</div>
<div class="row">
<div class="col-md-3 col-md-offset-3">.col-md-3 .col-md-offset-3</div>
<div class="col-md-3 col-md-offset-3">.col-md-3 .col-md-offset-3</div>
</div>
<div class="row">
<div class="col-md-6 col-md-offset-3">.col-md-6 .col-md-offset-3</div>
</div>
To nest your content with the default grid, add a new .row
and set of .col-md-
columns within an existing .col-md-
column. Nested rows should include a set of columns that add up to 12.
<div class="row">
<div class="col-md-9">
Level 1: .col-md-9
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"row"</span><span class="nt">></span>
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"col-md-6"</span><span class="nt">></span>
Level 2: .col-md-6
<span class="nt"></div></span>
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"col-md-6"</span><span class="nt">></span>
Level 2: .col-md-6
<span class="nt"></div></span>
<span class="nt"></div></span>
</div>
</div>
Easily change the order of our built-in grid columns with .col-md-push-
and .col-md-pull-
modifier classes.
<div class="row">
<div class="col-md-9 col-md-push-3">.col-md-9 .col-md-push-3</div>
<div class="col-md-3 col-md-pull-9">.col-md-3 .col-md-pull-9</div>
</div>
<h1 id="type">Typography</h1>
<h2 id="type-headings">Headings</h2>
<p>All HTML headings, <code><h1></code> through <code><h6></code>, are available. <code>.h1</code> through <code>.h6</code> classes are also available, for when you want to match the font styling of a heading but still want your text to be displayed inline.</p>
<div class="bs-example bs-example-type">
<table class="table">
<tbody>
<tr>
<td><h1>h1. Bootstrap heading</h1></td>
<td class="info">Semibold 36px</td>
</tr>
<tr>
<td><h2>h2. Bootstrap heading</h2></td>
<td class="info">Semibold 30px</td>
</tr>
<tr>
<td><h3>h3. Bootstrap heading</h3></td>
<td class="info">Semibold 24px</td>
</tr>
<tr>
<td><h4>h4. Bootstrap heading</h4></td>
<td class="info">Semibold 18px</td>
</tr>
<tr>
<td><h5>h5. Bootstrap heading</h5></td>
<td class="info">Semibold 14px</td>
</tr>
<tr>
<td><h6>h6. Bootstrap heading</h6></td>
<td class="info">Semibold 12px</td>
</tr>
</tbody>
</table>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><h1></span>h1. Bootstrap heading<span class="nt"></h1></span>
<h2>h2. Bootstrap heading</h2> <h3>h3. Bootstrap heading</h3> <h4>h4. Bootstrap heading</h4> <h5>h5. Bootstrap heading</h5>
<h6>h6. Bootstrap heading</h6>
Create lighter, secondary text in any heading with a generic <small>
tag or the .small
class.
<h1>h1. Bootstrap heading <small>Secondary text</small></h1>
<h2>h2. Bootstrap heading <small>Secondary text</small></h2>
<h3>h3. Bootstrap heading <small>Secondary text</small></h3>
<h4>h4. Bootstrap heading <small>Secondary text</small></h4>
<h5>h5. Bootstrap heading <small>Secondary text</small></h5>
<h6>h6. Bootstrap heading <small>Secondary text</small></h6>
<h2 id="type-body-copy">Body copy</h2>
<p>Bootstrap's global default <code>font-size</code> is <strong>14px</strong>, with a <code>line-height</code> of <strong>1.428</strong>. This is applied to the <code><body></code> and all paragraphs. In addition, <code><p></code> (paragraphs) receive a bottom margin of half their computed line-height (10px by default).</p>
<div class="bs-example">
<p>Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Nullam id dolor id nibh ultricies vehicula.</p>
<p>Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec ullamcorper nulla non metus auctor fringilla. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Donec ullamcorper nulla non metus auctor fringilla.</p>
<p>Maecenas sed diam eget risus varius blandit sit amet non magna. Donec id elit non mi porta gravida at eget metus. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit.</p>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><p></span>...<span class="nt"></p></span>
<h3>Lead body copy</h3>
<p>Make a paragraph stand out by adding <code>.lead</code>.</p>
<div class="bs-example">
<p class="lead">Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus.</p>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><p</span> <span class="na">class=</span><span class="s">"lead"</span><span class="nt">></span>...<span class="nt"></p></span>
<h2 id="type-emphasis">Emphasis</h2>
<p>Make use of HTML's default emphasis tags with lightweight styles.</p>
<h3>Small text</h3>
<p>For de-emphasizing inline or blocks of text, use the <code><small></code> tag to set text at 85% the size of the parent. Heading elements receive their own <code>font-size</code> for nested <code><small></code> elements.</p>
<p>You may alternatively use an inline element with <code>.small</code> in place of any <code><small></code></p>
<div class="bs-example">
<p><small>This line of text is meant to be treated as fine print.</small></p>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><small></span>This line of text is meant to be treated as fine print.<span class="nt"></small></span>
For emphasizing a snippet of text with a heavier font-weight.
The following snippet of text is rendered as bold text.
<strong>rendered as bold text</strong>
For emphasizing a snippet of text with italics.
The following snippet of text is rendered as italicized text.
<em>rendered as italicized text</em>
Feel free to use <b>
and <i>
in HTML5. <b>
is meant to highlight words or phrases without conveying additional importance while <i>
is mostly for voice, technical terms, etc.
Easily realign text to components with text alignment classes.
Left aligned text.
Center aligned text.
Right aligned text.
<p class="text-left">Left aligned text.</p>
<p class="text-center">Center aligned text.</p>
<p class="text-right">Right aligned text.</p>
Convey meaning through color with a handful of emphasis utility classes. These may also be applied to links and will darken on hover just like our default link styles.
Fusce dapibus, tellus ac cursus commodo, tortor mauris nibh.
Nullam id dolor id nibh ultricies vehicula ut id elit.
Duis mollis, est non commodo luctus, nisi erat porttitor ligula.
Maecenas sed diam eget risus varius blandit sit amet non magna.
Etiam porta sem malesuada magna mollis euismod.
Donec ullamcorper nulla non metus auctor fringilla.
<p class="text-muted">...</p>
<p class="text-primary">...</p>
<p class="text-success">...</p>
<p class="text-info">...</p>
<p class="text-warning">...</p>
<p class="text-danger">...</p>
Sometimes emphasis classes cannot be applied due to the specificity of another selector. In most cases, a sufficient workaround is to wrap your text in a <span>
with the class.
<h2 id="type-abbreviations">Abbreviations</h2>
<p>Stylized implementation of HTML's <code><abbr></code> element for abbreviations and acronyms to show the expanded version on hover. Abbreviations with a <code>title</code> attribute have a light dotted bottom border and a help cursor on hover, providing additional context on hover.</p>
<h3>Basic abbreviation</h3>
<p>For expanded text on long hover of an abbreviation, include the <code>title</code> attribute with the <code><abbr></code> element.</p>
<div class="bs-example">
<p>An abbreviation of the word attribute is <abbr title="attribute">attr</abbr>.</p>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><abbr</span> <span class="na">title=</span><span class="s">"attribute"</span><span class="nt">></span>attr<span class="nt"></abbr></span>
Add .initialism
to an abbreviation for a slightly smaller font-size.
HTML is the best thing since sliced bread.
<abbr title="HyperText Markup Language" class="initialism">HTML</abbr>
<h2 id="type-addresses">Addresses</h2>
<p>Present contact information for the nearest ancestor or the entire body of work. Preserve formatting by ending all lines with <code><br></code>.</p>
<div class="bs-example">
<address>
<strong>Twitter, Inc.</strong><br>
795 Folsom Ave, Suite 600<br>
San Francisco, CA 94107<br>
<abbr title="Phone">P:</abbr> (123) 456-7890
</address>
<address>
<strong>Full Name</strong><br>
<a href="mailto:#">[email protected]</a>
</address>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><address></span>
<strong>Twitter, Inc.</strong><br> 795 Folsom Ave, Suite 600<br> San Francisco, CA 94107<br>
<abbr title="Phone">P:</abbr> (123) 456-7890 </address>
<address> <strong>Full Name</strong><br>
<a href="mailto:#">[email protected]</a> </address>
<h2 id="type-blockquotes">Blockquotes</h2>
<p>For quoting blocks of content from another source within your document.</p>
<h3>Default blockquote</h3>
<p>Wrap <code><blockquote></code> around any <abbr title="HyperText Markup Language">HTML</abbr> as the quote. For straight quotes, we recommend a <code><p></code>.</p>
<div class="bs-example">
<blockquote>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
</blockquote>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><blockquote></span>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
</blockquote>
Style and content changes for simple variations on a standard <blockquote>
.
Add <small>
tag for identifying the source. Wrap the name of the source work in <cite>
.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
Someone famous in Source Title
<blockquote>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
<small>Someone famous in <cite title="Source Title">Source Title</cite></small>
</blockquote>
Use .pull-right
for a floated, right-aligned blockquote.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
Someone famous in Source Title
<blockquote class="pull-right">
...
</blockquote>
<h2 id="type-lists">Lists</h2>
<h3>Unordered</h3>
<p>A list of items in which the order does <em>not</em> explicitly matter.</p>
<div class="bs-example">
<ul>
<li>Lorem ipsum dolor sit amet</li>
<li>Consectetur adipiscing elit</li>
<li>Integer molestie lorem at massa</li>
<li>Facilisis in pretium nisl aliquet</li>
<li>Nulla volutpat aliquam velit
<ul>
<li>Phasellus iaculis neque</li>
<li>Purus sodales ultricies</li>
<li>Vestibulum laoreet porttitor sem</li>
<li>Ac tristique libero volutpat at</li>
</ul>
</li>
<li>Faucibus porta lacus fringilla vel</li>
<li>Aenean sit amet erat nunc</li>
<li>Eget porttitor lorem</li>
</ul>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><ul></span>
<li>...</li>
</ul>
A list of items in which the order does explicitly matter.
- Lorem ipsum dolor sit amet
- Consectetur adipiscing elit
- Integer molestie lorem at massa
- Facilisis in pretium nisl aliquet
- Nulla volutpat aliquam velit
- Faucibus porta lacus fringilla vel
- Aenean sit amet erat nunc
- Eget porttitor lorem
<ol>
<li>...</li>
</ol>
Remove the default list-style
and left margin on list items (immediate children only). This only applies to immediate children list items, meaning you will need to add the class for any nested lists as well.
- Lorem ipsum dolor sit amet
- Consectetur adipiscing elit
- Integer molestie lorem at massa
- Facilisis in pretium nisl aliquet
- Nulla volutpat aliquam velit
- Phasellus iaculis neque
- Purus sodales ultricies
- Vestibulum laoreet porttitor sem
- Ac tristique libero volutpat at
- Faucibus porta lacus fringilla vel
- Aenean sit amet erat nunc
- Eget porttitor lorem
<ul class="list-unstyled">
<li>...</li>
</ul>
Place all list items on a single line with display: inline-block;
and some light padding.
- Lorem ipsum
- Phasellus iaculis
- Nulla volutpat
<ul class="list-inline">
<li>...</li>
</ul>
A list of terms with their associated descriptions.
- Description lists
- A description list is perfect for defining terms.
- Euismod
- Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.
- Donec id elit non mi porta gravida at eget metus.
- Malesuada porta
- Etiam porta sem malesuada magna mollis euismod.
<dl>
<dt>...</dt>
<dd>...</dd>
</dl>
Make terms and descriptions in <dl>
line up side-by-side. Starts off stacked like default <dl>
s, but when the navbar expands, so do these.
- Description lists
- A description list is perfect for defining terms.
- Euismod
- Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.
- Donec id elit non mi porta gravida at eget metus.
- Malesuada porta
- Etiam porta sem malesuada magna mollis euismod.
- Felis euismod semper eget lacinia
- Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.
<dl class="dl-horizontal">
<dt>...</dt>
<dd>...</dd>
</dl>
Horizontal description lists will truncate terms that are too long to fit in the left column with text-overflow
. In narrower viewports, they will change to the default stacked layout.
<h1 id="code">Code</h1>
<h2>Inline</h2>
<p>Wrap inline snippets of code with <code><code></code>.</p>
<div class="bs-example"> For example, <code><section></code> should be wrapped as inline. </div>
<div class="highlight">
<pre><code class="html">For example, <span class="nt"><code></span><span class="ni">&lt;</span>section<span class="ni">&gt;</span><span class="nt"></code></span> should be wrapped as inline.
Use <pre>
for multiple lines of code. Be sure to escape any angle brackets in the code for proper rendering.
<p>Sample text here...</p>
<pre><p>Sample text here...</p></pre>
You may optionally add the .pre-scrollable
class, which will set a max-height of 350px and provide a y-axis scrollbar.
<h1 id="tables">Tables</h1>
<h2 id="tables-example">Basic example</h2>
<p>For basic styling—light padding and only horizontal dividers—add the base class <code>.table</code> to any <code><table></code>. It may seem super redundant, but given the widespread use of tables for other plugins like calendars and date pickers, we've opted to isolate our custom table styles.</p>
<div class="bs-example">
<table class="table">
<thead>
<tr>
<th>#</th>
<th>First Name</th>
<th>Last Name</th>
<th>Username</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>Mark</td>
<td>Otto</td>
<td>@mdo</td>
</tr>
<tr>
<td>2</td>
<td>Jacob</td>
<td>Thornton</td>
<td>@fat</td>
</tr>
<tr>
<td>3</td>
<td>Larry</td>
<td>the Bird</td>
<td>@twitter</td>
</tr>
</tbody>
</table>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><table</span> <span class="na">class=</span><span class="s">"table"</span><span class="nt">></span>
... </table>
Use .table-striped
to add zebra-striping to any table row within the <tbody>
.
Striped tables are styled via the :nth-child
CSS selector, which is not available in Internet Explorer 8.
# | First Name | Last Name | Username |
---|---|---|---|
1 | Mark | Otto | @mdo |
2 | Jacob | Thornton | @fat |
3 | Larry | the Bird |
<div class="highlight">
<pre><code class="html"><span class="nt"><table</span> <span class="na">class=</span><span class="s">"table table-striped"</span><span class="nt">></span>
... </table>
Add .table-bordered
for borders on all sides of the table and cells.
# | First Name | Last Name | Username |
---|---|---|---|
1 | Mark | Otto | @mdo |
Mark | Otto | @TwBootstrap | |
2 | Jacob | Thornton | @fat |
3 | Larry the Bird |
<div class="highlight">
<pre><code class="html"><span class="nt"><table</span> <span class="na">class=</span><span class="s">"table table-bordered"</span><span class="nt">></span>
... </table>
Add .table-hover
to enable a hover state on table rows within a <tbody>
.
# | First Name | Last Name | Username |
---|---|---|---|
1 | Mark | Otto | @mdo |
2 | Jacob | Thornton | @fat |
3 | Larry the Bird |
<div class="highlight">
<pre><code class="html"><span class="nt"><table</span> <span class="na">class=</span><span class="s">"table table-hover"</span><span class="nt">></span>
... </table>
Add .table-condensed
to make tables more compact by cutting cell padding in half.
# | First Name | Last Name | Username |
---|---|---|---|
1 | Mark | Otto | @mdo |
2 | Jacob | Thornton | @fat |
3 | Larry the Bird |
<div class="highlight">
<pre><code class="html"><span class="nt"><table</span> <span class="na">class=</span><span class="s">"table table-condensed"</span><span class="nt">></span>
... </table>
Use contextual classes to color table rows or individual cells.
Class | Description |
---|---|
.active |
Applies the hover color to a particular row or cell |
.success |
Indicates a successful or positive action |
.warning |
Indicates a warning that might need attention |
.danger |
Indicates a dangerous or potentially negative action |
# | Column heading | Column heading | Column heading |
---|---|---|---|
1 | Column content | Column content | Column content |
2 | Column content | Column content | Column content |
3 | Column content | Column content | Column content |
4 | Column content | Column content | Column content |
5 | Column content | Column content | Column content |
6 | Column content | Column content | Column content |
7 | Column content | Column content | Column content |
<div class="highlight">
<pre><code class="html"><span class="c"><!-- On rows --></span>
<tr class="active">...</tr>
<tr class="success">...</tr> <tr class="warning">...</tr> <tr class="danger">...</tr>
<!-- On cells (td
or th
) -->
<tr>
<td class="active">...</td>
<td class="success">...</td>
<td class="warning">...</td> <td class="danger">...</td> </tr>
Create responsive tables by wrapping any .table
in .table-responsive
to make them scroll horizontally up to small devices (under 768px). When viewing on anything larger than 768px wide, you will not see any difference in these tables.
# | Table heading | Table heading | Table heading | Table heading | Table heading | Table heading |
---|---|---|---|---|---|---|
1 | Table cell | Table cell | Table cell | Table cell | Table cell | Table cell |
2 | Table cell | Table cell | Table cell | Table cell | Table cell | Table cell |
3 | Table cell | Table cell | Table cell | Table cell | Table cell | Table cell |
<div class="table-responsive">
<table class="table table-bordered">
<thead>
<tr>
<th>#</th>
<th>Table heading</th>
<th>Table heading</th>
<th>Table heading</th>
<th>Table heading</th>
<th>Table heading</th>
<th>Table heading</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>Table cell</td>
<td>Table cell</td>
<td>Table cell</td>
<td>Table cell</td>
<td>Table cell</td>
<td>Table cell</td>
</tr>
<tr>
<td>2</td>
<td>Table cell</td>
<td>Table cell</td>
<td>Table cell</td>
<td>Table cell</td>
<td>Table cell</td>
<td>Table cell</td>
</tr>
<tr>
<td>3</td>
<td>Table cell</td>
<td>Table cell</td>
<td>Table cell</td>
<td>Table cell</td>
<td>Table cell</td>
<td>Table cell</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"table-responsive"</span><span class="nt">></span>
<table class="table"> ... </table>
</div>
<h1 id="forms">Forms</h1>
<h2 id="forms-example">Basic example</h2>
<p>Individual form controls automatically receive some global styling. All textual <code><input></code>, <code><textarea></code>, and <code><select></code> elements with <code>.form-control</code> are set to <code>width: 100%;</code> by default. Wrap labels and controls in <code>.form-group</code> for optimum spacing.</p>
<div class="bs-example">
<form role="form">
<div class="form-group">
<label for="exampleInputEmail1">Email address</label>
<input type="email" class="form-control" id="exampleInputEmail1" placeholder="Enter email">
</div>
<div class="form-group">
<label for="exampleInputPassword1">Password</label>
<input type="password" class="form-control" id="exampleInputPassword1" placeholder="Password">
</div>
<div class="form-group">
<label for="exampleInputFile">File input</label>
<input type="file" id="exampleInputFile">
<p class="help-block">Example block-level help text here.</p>
</div>
<div class="checkbox">
<label>
<input type="checkbox">
Check me out </label>
</div>
<button type="submit" class="btn btn-default">Submit</button>
</form>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><form</span> <span class="na">role=</span><span class="s">"form"</span><span class="nt">></span>
<div class="form-group"> <label for="exampleInputEmail1">Email address</label> <input type="email" class="form-control" id="exampleInputEmail1" placeholder="Enter email">
</div> <div class="form-group"> <label for="exampleInputPassword1">Password</label>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"password"</span> <span class="na">class=</span><span class="s">"form-control"</span> <span class="na">id=</span><span class="s">"exampleInputPassword1"</span> <span class="na">placeholder=</span><span class="s">"Password"</span><span class="nt">></span>
</div>
<div class="form-group"> <label for="exampleInputFile">File input</label> <input type="file" id="exampleInputFile">
<span class="nt"><p</span> <span class="na">class=</span><span class="s">"help-block"</span><span class="nt">></span>Example block-level help text here.<span class="nt"></p></span>
</div> <div class="checkbox">
<span class="nt"><label></span>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"checkbox"</span><span class="nt">></span> Check me out
<span class="nt"></label></span>
</div> <button type="submit" class="btn btn-default">Submit</button>
</form>
Add .form-inline
for left-aligned and inline-block controls for a compact layout.
Inputs, selects, and textareas are 100% wide by default in Bootstrap. To use the inline form, you'll have to set a width on the form controls used within.
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.
<div class="highlight">
<pre><code class="html"><span class="nt"><form</span> <span class="na">class=</span><span class="s">"form-inline"</span> <span class="na">role=</span><span class="s">"form"</span><span class="nt">></span>
<div class="form-group">
<span class="nt"><label</span> <span class="na">class=</span><span class="s">"sr-only"</span> <span class="na">for=</span><span class="s">"exampleInputEmail2"</span><span class="nt">></span>Email address<span class="nt"></label></span>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"email"</span> <span class="na">class=</span><span class="s">"form-control"</span> <span class="na">id=</span><span class="s">"exampleInputEmail2"</span> <span class="na">placeholder=</span><span class="s">"Enter email"</span><span class="nt">></span>
</div> <div class="form-group"> <label class="sr-only" for="exampleInputPassword2">Password</label>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"password"</span> <span class="na">class=</span><span class="s">"form-control"</span> <span class="na">id=</span><span class="s">"exampleInputPassword2"</span> <span class="na">placeholder=</span><span class="s">"Password"</span><span class="nt">></span>
</div>
<div class="checkbox"> <label> <input type="checkbox"> Remember me </label>
</div> <button type="submit" class="btn btn-default">Sign in</button> </form>
Use Bootstrap's predefined grid classes to align labels and groups of form controls in a horizontal layout by adding .form-horizontal
to the form. Doing so changes .form-group
s to behave as grid rows, so no need for .row
.
<div class="highlight">
<pre><code class="html"><span class="nt"><form</span> <span class="na">class=</span><span class="s">"form-horizontal"</span> <span class="na">role=</span><span class="s">"form"</span><span class="nt">></span>
<div class="form-group">
<span class="nt"><label</span> <span class="na">for=</span><span class="s">"inputEmail3"</span> <span class="na">class=</span><span class="s">"col-sm-2 control-label"</span><span class="nt">></span>Email<span class="nt"></label></span>
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"col-sm-10"</span><span class="nt">></span>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"email"</span> <span class="na">class=</span><span class="s">"form-control"</span> <span class="na">id=</span><span class="s">"inputEmail3"</span> <span class="na">placeholder=</span><span class="s">"Email"</span><span class="nt">></span>
<span class="nt"></div></span>
</div> <div class="form-group"> <label for="inputPassword3" class="col-sm-2 control-label">Password</label>
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"col-sm-10"</span><span class="nt">></span>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"password"</span> <span class="na">class=</span><span class="s">"form-control"</span> <span class="na">id=</span><span class="s">"inputPassword3"</span> <span class="na">placeholder=</span><span class="s">"Password"</span><span class="nt">></span>
<span class="nt"></div></span>
</div> <div class="form-group"> <div class="col-sm-offset-2 col-sm-10">
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"checkbox"</span><span class="nt">></span>
<span class="nt"><label></span>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"checkbox"</span><span class="nt">></span> Remember me
<span class="nt"></label></span>
<span class="nt"></div></span>
<span class="nt"></div></span>
</div> <div class="form-group"> <div class="col-sm-offset-2 col-sm-10">
<span class="nt"><button</span> <span class="na">type=</span><span class="s">"submit"</span> <span class="na">class=</span><span class="s">"btn btn-default"</span><span class="nt">></span>Sign in<span class="nt"></button></span>
<span class="nt"></div></span>
</div>
</form>
Examples of standard form controls supported in an example form layout.
Most common form control, text-based input fields. Includes support for all HTML5 types: text
, password
, datetime
, datetime-local
, date
, month
, time
, week
, number
, email
, url
, search
, tel
, and color
.
<div class="highlight">
<pre><code class="html"><span class="nt"><input</span> <span class="na">type=</span><span class="s">"text"</span> <span class="na">class=</span><span class="s">"form-control"</span> <span class="na">placeholder=</span><span class="s">"Text input"</span><span class="nt">></span>
To add integrated text or buttons before and/or after any text-based <input>
, check out the input group component.
Form control which supports multiple lines of text. Change rows
attribute as necessary.
<div class="highlight">
<pre><code class="html"><span class="nt"><textarea</span> <span class="na">class=</span><span class="s">"form-control"</span> <span class="na">rows=</span><span class="s">"3"</span><span class="nt">></textarea></span>
Checkboxes are for selecting one or several options in a list while radios are for selecting one option from many.
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"checkbox"</span><span class="nt">></span>
<label> <input type="checkbox" value=""> Option one is this and that—be sure to include why it's great </label>
</div>
<div class="radio"> <label> <input type="radio" name="optionsRadios" id="optionsRadios1" value="option1" checked>
Option one is this and that<span class="ni">&mdash;</span>be sure to include why it's great
</label> </div> <div class="radio"> <label>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"radio"</span> <span class="na">name=</span><span class="s">"optionsRadios"</span> <span class="na">id=</span><span class="s">"optionsRadios2"</span> <span class="na">value=</span><span class="s">"option2"</span><span class="nt">></span>
Option two can be something else and selecting it will deselect option one
</label>
</div>
Use .checkbox-inline
or .radio-inline
class to a series of checkboxes or radios for controls appear on the same line.
<div class="highlight">
<pre><code class="html"><span class="nt"><label</span> <span class="na">class=</span><span class="s">"checkbox-inline"</span><span class="nt">></span>
<input type="checkbox" id="inlineCheckbox1" value="option1"> 1
</label> <label class="checkbox-inline"> <input type="checkbox" id="inlineCheckbox2" value="option2"> 2
</label> <label class="checkbox-inline"> <input type="checkbox" id="inlineCheckbox3" value="option3"> 3
</label>
Use the default option, or add multiple
to show multiple options at once.
1 2 3 4 5
<div class="highlight">
<pre><code class="html"><span class="nt"><select</span> <span class="na">class=</span><span class="s">"form-control"</span><span class="nt">></span>
<option>1</option>
<option>2</option> <option>3</option> <option>4</option> <option>5</option>
</select>
<select multiple class="form-control"> <option>1</option> <option>2</option>
<option>3</option> <option>4</option> <option>5</option> </select>
When you need to place plain text next to a form label within a horizontal form, use the .form-control-static
class on a <p>
.
<div class="highlight">
<pre><code class="html"><span class="nt"><form</span> <span class="na">class=</span><span class="s">"form-horizontal"</span> <span class="na">role=</span><span class="s">"form"</span><span class="nt">></span>
<div class="form-group"> <label class="col-sm-2 control-label">Email</label> <div class="col-sm-10">
<span class="nt"><p</span> <span class="na">class=</span><span class="s">"form-control-static"</span><span class="nt">></span>[email protected]<span class="nt"></p></span>
<span class="nt"></div></span>
</div> <div class="form-group">
<span class="nt"><label</span> <span class="na">for=</span><span class="s">"inputPassword"</span> <span class="na">class=</span><span class="s">"col-sm-2 control-label"</span><span class="nt">></span>Password<span class="nt"></label></span>
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"col-sm-10"</span><span class="nt">></span>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"password"</span> <span class="na">class=</span><span class="s">"form-control"</span> <span class="na">id=</span><span class="s">"inputPassword"</span> <span class="na">placeholder=</span><span class="s">"Password"</span><span class="nt">></span>
<span class="nt"></div></span>
</div> </form>
Provide feedback to users or visitors with basic feedback states on form controls and labels.
We remove the default outline
styles on some form controls and apply a box-shadow
in its place for :focus
.
<input class="form-control" id="focusedInput" type="text" value="This is focused...">
Add the disabled
attribute on an input to prevent user input and trigger a slightly different look.
<div class="highlight">
<pre><code class="html"><span class="nt"><input</span> <span class="na">class=</span><span class="s">"form-control"</span> <span class="na">id=</span><span class="s">"disabledInput"</span> <span class="na">type=</span><span class="s">"text"</span> <span class="na">placeholder=</span><span class="s">"Disabled input here..."</span> <span class="na">disabled</span><span class="nt">></span>
Add the disabled
attribute to a <fieldset>
to disable all the controls within the <fieldset>
at once.
This class will only change the appearance of <a class="btn btn-default">
buttons, not their functionality. Use custom JavaScript to disable links here.
While Bootstrap will apply these styles in all browsers, Internet Explorer 9 and below don't actually support the disabled
attribute on a <fieldset>
. Use custom JavaScript to disable the fieldset in these browsers.
<div class="highlight">
<pre><code class="html"><span class="nt"><form</span> <span class="na">role=</span><span class="s">"form"</span><span class="nt">></span>
<fieldset disabled>
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"form-group"</span><span class="nt">></span>
<span class="nt"><label</span> <span class="na">for=</span><span class="s">"disabledTextInput"</span><span class="nt">></span>Disabled input<span class="nt"></label></span>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"text"</span> <span class="na">id=</span><span class="s">"disabledTextInput"</span> <span class="na">class=</span><span class="s">"form-control"</span> <span class="na">placeholder=</span><span class="s">"Disabled input"</span><span class="nt">></span>
<span class="nt"></div></span>
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"form-group"</span><span class="nt">></span>
<span class="nt"><label</span> <span class="na">for=</span><span class="s">"disabledSelect"</span><span class="nt">></span>Disabled select menu<span class="nt"></label></span>
<span class="nt"><select</span> <span class="na">id=</span><span class="s">"disabledSelect"</span> <span class="na">class=</span><span class="s">"form-control"</span><span class="nt">></span>
<span class="nt"><option></span>Disabled select<span class="nt"></option></span>
<span class="nt"></select></span>
<span class="nt"></div></span>
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"checkbox"</span><span class="nt">></span>
<span class="nt"><label></span>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"checkbox"</span><span class="nt">></span> Can't check this
<span class="nt"></label></span>
<span class="nt"></div></span>
<span class="nt"><button</span> <span class="na">type=</span><span class="s">"submit"</span> <span class="na">class=</span><span class="s">"btn btn-primary"</span><span class="nt">></span>Submit<span class="nt"></button></span>
</fieldset>
</form>
Bootstrap includes validation styles for error, warning, and success states on form controls. To use, add .has-warning
, .has-error
, or .has-success
to the parent element. Any .control-label
, .form-control
, and .help-block
within that element will receive the validation styles.
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"form-group has-success"</span><span class="nt">></span>
<label class="control-label" for="inputSuccess">Input with success</label> <input type="text" class="form-control" id="inputSuccess">
</div> <div class="form-group has-warning"> <label class="control-label" for="inputWarning">Input with warning</label>
<input type="text" class="form-control" id="inputWarning"> </div> <div class="form-group has-error">
<label class="control-label" for="inputError">Input with error</label> <input type="text" class="form-control" id="inputError">
</div>
Set heights using classes like .input-lg
, and set widths using grid column classes like .col-lg-*
.
Create larger or smaller form controls that match button sizes.
<div class="highlight">
<pre><code class="html"><span class="nt"><input</span> <span class="na">class=</span><span class="s">"form-control input-lg"</span> <span class="na">type=</span><span class="s">"text"</span> <span class="na">placeholder=</span><span class="s">".input-lg"</span><span class="nt">></span>
<input class="form-control" type="text" placeholder="Default input"> <input class="form-control input-sm" type="text" placeholder=".input-sm">
<select class="form-control input-lg">...</select> <select class="form-control">...</select> <select class="form-control input-sm">...</select>
Wrap inputs in grid columns, or any custom parent element, to easily enforce desired widths.
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"row"</span><span class="nt">></span>
<div class="col-xs-2"> <input type="text" class="form-control" placeholder=".col-xs-2">
</div> <div class="col-xs-3"> <input type="text" class="form-control" placeholder=".col-xs-3">
</div> <div class="col-xs-4"> <input type="text" class="form-control" placeholder=".col-xs-4">
</div> </div>
Block level help text for form controls.
<div class="highlight">
<pre><code class="html"><span class="nt"><span</span> <span class="na">class=</span><span class="s">"help-block"</span><span class="nt">></span>A block of help text that breaks onto a new line and may extend beyond one line.<span class="nt"></span></span>
<h1 id="buttons">Buttons</h1>
<h2 id="buttons-options">Options</h2>
<p>Use any of the available button classes to quickly create a styled button.</p>
<div class="bs-example">
<button type="button" class="btn btn-default">Default</button>
<button type="button" class="btn btn-primary">Primary</button>
<button type="button" class="btn btn-success">Success</button>
<button type="button" class="btn btn-info">Info</button>
<button type="button" class="btn btn-warning">Warning</button>
<button type="button" class="btn btn-danger">Danger</button>
<button type="button" class="btn btn-link">Link</button>
</div>
<div class="highlight">
<pre><code class="html"><span class="c"><!-- Standard button --></span>
<button type="button" class="btn btn-default">Default</button>
<!-- Provides extra visual weight and identifies the primary action in a set of buttons --> <button type="button" class="btn btn-primary">Primary</button>
<!-- Indicates a successful or positive action --> <button type="button" class="btn btn-success">Success</button>
<!-- Contextual button for informational alert messages --> <button type="button" class="btn btn-info">Info</button>
<!-- Indicates caution should be taken with this action --> <button type="button" class="btn btn-warning">Warning</button>
<!-- Indicates a dangerous or potentially negative action --> <button type="button" class="btn btn-danger">Danger</button>
<!-- Deemphasize a button by making it look like a link while maintaining button behavior --> <button type="button" class="btn btn-link">Link</button>
Fancy larger or smaller buttons? Add .btn-lg
, .btn-sm
, or .btn-xs
for additional sizes.
Large button Large button
Default button Default button
Small button Small button
Extra small button Extra small button
<p>
<button type="button" class="btn btn-primary btn-lg">Large button</button>
<button type="button" class="btn btn-default btn-lg">Large button</button>
</p>
<p>
<button type="button" class="btn btn-primary">Default button</button>
<button type="button" class="btn btn-default">Default button</button>
</p>
<p>
<button type="button" class="btn btn-primary btn-sm">Small button</button>
<button type="button" class="btn btn-default btn-sm">Small button</button>
</p>
<p>
<button type="button" class="btn btn-primary btn-xs">Extra small button</button>
<button type="button" class="btn btn-default btn-xs">Extra small button</button>
</p>
Create block level buttons—those that span the full width of a parent— by adding .btn-block
.
<button type="button" class="btn btn-primary btn-lg btn-block">Block level button</button>
<button type="button" class="btn btn-default btn-lg btn-block">Block level button</button>
Buttons will appear pressed (with a darker background, darker border, and inset shadow) when active. For <button>
elements, this is done via :active
. For <a>
elements, it's done with .active
. However, you may use .active
<button>
s should you need to replicate the active state progammatically.
No need to add :active
as it's a pseudo-class, but if you need to force the same appearance, go ahead and add .active
.
Primary button Button
<button type="button" class="btn btn-primary btn-lg active">Primary button</button>
<button type="button" class="btn btn-default btn-lg active">Button</button>
Add the .active
class to <a>
buttons.
<a href="#" class="btn btn-primary btn-lg active" role="button">Primary link</a>
<a href="#" class="btn btn-default btn-lg active" role="button">Link</a>
Make buttons look unclickable by fading them back 50%.
Add the disabled
attribute to <button>
buttons.
Primary button Button
<button type="button" class="btn btn-lg btn-primary" disabled="disabled">Primary button</button>
<button type="button" class="btn btn-default btn-lg" disabled="disabled">Button</button>
If you add the disabled
attribute to a <button>
, Internet Explorer 9 and below will render text gray with a nasty text-shadow that we cannot fix.
Add the .disabled
class to <a>
buttons.
<a href="#" class="btn btn-primary btn-lg disabled" role="button">Primary link</a>
<a href="#" class="btn btn-default btn-lg disabled" role="button">Link</a>
We use .disabled
as a utility class here, similar to the common .active
class, so no prefix is required.
This class will only change the <a>
's appearance, not its functionality. Use custom JavaScript to disable links here.
While button classes can be used on <a>
and <button>
elements, only <button>
elements are supported within our nav and navbar components.
Use the button classes on an <a>
, <button>
, or <input>
element.
<a class="btn btn-default" href="#" role="button">Link</a>
<button class="btn btn-default" type="submit">Button</button>
<input class="btn btn-default" type="button" value="Input">
<input class="btn btn-default" type="submit" value="Submit">
As a best practice, we highly recommend using the <button>
element whenever possible to ensure matching cross-browser rendering.
Among other things, there's a Firefox bug that prevents us from setting the line-height
of <input>
-based buttons, causing them to not exactly match the height of other buttons on Firefox.
<h1 id="images">Images</h1>
<p>Add classes to an <code><img></code> element to easily style images in any project.</p>
<div class="bs-callout bs-callout-danger">
<h4>Cross-browser compatibility</h4>
<p>Keep in mind that Internet Explorer 8 lacks support for rounded corners.</p>
</div>
<div class="bs-example bs-example-images"> <img data-src="holder.js/140x140" class="img-rounded" alt="A generic square placeholder image with rounded corners"> <img data-src="holder.js/140x140" class="img-circle" alt="A generic square placeholder image where only the portion within the circle circumscribed about said square is visible"> <img data-src="holder.js/140x140" class="img-thumbnail" alt="A generic square placeholder image with a white border around it, making it resemble a photograph taken with an old instant camera"> </div>
<div class="highlight">
<pre><code class="html"><span class="nt"><img</span> <span class="na">src=</span><span class="s">"..."</span> <span class="na">alt=</span><span class="s">"..."</span> <span class="na">class=</span><span class="s">"img-rounded"</span><span class="nt">></span>
<img src="..." alt="..." class="img-circle"> <img src="..." alt="..." class="img-thumbnail">
Looking for how to make images more responsive? Check out the responsive images section up top.
<h1 id="helper-classes">Helper classes</h1>
<h3 id="helper-classes-close">Close icon</h3>
<p>Use the generic close icon for dismissing content like modals and alerts.</p>
<div class="bs-example">
<p>
<button type="button" class="close" aria-hidden="true">×</button>
</p>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><button</span> <span class="na">type=</span><span class="s">"button"</span> <span class="na">class=</span><span class="s">"close"</span> <span class="na">aria-hidden=</span><span class="s">"true"</span><span class="nt">></span><span class="ni">&times;</span><span class="nt"></button></span>
Use carets to indicate dropdown functionality and direction. Note that the default caret will reverse automatically in dropup menus.
<span class="caret"></span>
Float an element to the left or right with a class. !important
is included to avoid specificity issues. Classes can also be used as mixins.
<div class="pull-left">...</div>
<div class="pull-right">...</div>
// Classes
.pull-left {
float: left !important;
}
.pull-right {
float: right !important;
}
// Usage as mixins
.element {
.pull-left();
}
.another-element {
.pull-right();
}
To align components in navbars with utility classes, use .navbar-left
or .navbar-right
instead. See the navbar docs for details.
Set an element to display: block
and center via margin
. Available as a mixin and class.
<div class="center-block">...</div>
// Classes
.center-block {
display: block;
margin-left: auto;
margin-right: auto;
}
// Usage as mixins
.element {
.center-block();
}
Clear the float
on any element with the .clearfix
class. Utilizes the micro clearfix as popularized by Nicolas Gallagher. Can also be used as a mixin.
<!-- Usage as a class -->
<div class="clearfix">...</div>
// Mixin itself
.clearfix() {
&:before,
&:after {
content: " ";
<span class="k">display</span><span class="o">:</span> <span class="n">table</span><span class="p">;</span>
}
&:after {
clear: both;
}
}
// Usage as a Mixin
.element {
.clearfix();
}
Force an element to be shown or hidden (including for screen readers) with the use of .show
and .hidden
classes. These classes use !important
to avoid specificity conflicts, just like the quick floats. They are only available for block level toggling. They can also be used as mixins.
.hide
is available, but it does not always affect screen readers and is deprecated as of v3.0.1. Use .hidden
or .sr-only
instead.
Furthermore, .invisible
can be used to toggle only the visibility of an element, meaning its display
is not modified and the element can still affect the flow of the document.
<div class="show">...</div>
<div class="hidden">...</div>
// Classes
.show {
display: block !important;
}
.hidden {
display: none !important;
visibility: hidden !important;
}
.invisible {
visibility: hidden;
}
// Usage as mixins
.element {
.show();
}
.another-element {
.hidden();
}
Hide an element to all devices except screen readers with .sr-only
. Necessary for following accessibility best practices. Can also be used as a mixin.
<a class="sr-only" href="#content">Skip to main content</a>
// Usage as a Mixin
.skip-navigation {
.sr-only();
}
Utilize the .text-hide
class or mixin to help replace an element's text content with a background image.
<h1 class="text-hide">Custom heading</h1>
// Usage as a Mixin
.heading {
.text-hide();
}
<h1 id="responsive-utilities">Responsive utilities</h1>
<p class="lead">For faster mobile-friendly development, use these utility classes for showing and hiding content by device via media query. Also included are utility classes for toggling content when printed.</p>
<p>Try to use these on a limited basis and avoid creating entirely different versions of the same site. Instead, use them to complement each device's presentation. <strong>Responsive utilities are currently only available for block and table toggling.</strong> Use with inline and table elements is currently not supported.</p>
<h2 id="responsive-utilities-classes">Available classes</h2>
<p>Use a single or combination of the available classes for toggling content across viewport breakpoints.</p>
<div class="table-responsive">
<table class="table table-bordered table-striped responsive-utilities">
<thead>
<tr>
<th></th>
<th> Extra small devices <small>Phones (<768px)</small> </th>
<th> Small devices <small>Tablets (≥768px)</small> </th>
<th> Medium devices <small>Desktops (≥992px)</small> </th>
<th> Large devices <small>Desktops (≥1200px)</small> </th>
</tr>
</thead>
<tbody>
<tr>
<th><code>.visible-xs</code></th>
<td class="is-visible">Visible</td>
<td class="is-hidden">Hidden</td>
<td class="is-hidden">Hidden</td>
<td class="is-hidden">Hidden</td>
</tr>
<tr>
<th><code>.visible-sm</code></th>
<td class="is-hidden">Hidden</td>
<td class="is-visible">Visible</td>
<td class="is-hidden">Hidden</td>
<td class="is-hidden">Hidden</td>
</tr>
<tr>
<th><code>.visible-md</code></th>
<td class="is-hidden">Hidden</td>
<td class="is-hidden">Hidden</td>
<td class="is-visible">Visible</td>
<td class="is-hidden">Hidden</td>
</tr>
<tr>
<th><code>.visible-lg</code></th>
<td class="is-hidden">Hidden</td>
<td class="is-hidden">Hidden</td>
<td class="is-hidden">Hidden</td>
<td class="is-visible">Visible</td>
</tr>
</tbody>
<tbody>
<tr>
<th><code>.hidden-xs</code></th>
<td class="is-hidden">Hidden</td>
<td class="is-visible">Visible</td>
<td class="is-visible">Visible</td>
<td class="is-visible">Visible</td>
</tr>
<tr>
<th><code>.hidden-sm</code></th>
<td class="is-visible">Visible</td>
<td class="is-hidden">Hidden</td>
<td class="is-visible">Visible</td>
<td class="is-visible">Visible</td>
</tr>
<tr>
<th><code>.hidden-md</code></th>
<td class="is-visible">Visible</td>
<td class="is-visible">Visible</td>
<td class="is-hidden">Hidden</td>
<td class="is-visible">Visible</td>
</tr>
<tr>
<th><code>.hidden-lg</code></th>
<td class="is-visible">Visible</td>
<td class="is-visible">Visible</td>
<td class="is-visible">Visible</td>
<td class="is-hidden">Hidden</td>
</tr>
</tbody>
</table>
</div>
<h2 id="responsive-utilities-print">Print classes</h2>
<p>Similar to the regular responsive classes, use these for toggling content for print.</p>
<div class="table-responsive">
<table class="table table-bordered table-striped responsive-utilities">
<thead>
<tr>
<th>Class</th>
<th>Browser</th>
<th>Print</th>
</tr>
</thead>
<tbody>
<tr>
<th><code>.visible-print</code></th>
<td class="is-hidden">Hidden</td>
<td class="is-visible">Visible</td>
</tr>
<tr>
<th><code>.hidden-print</code></th>
<td class="is-visible">Visible</td>
<td class="is-hidden">Hidden</td>
</tr>
</tbody>
</table>
</div>
<h2 id="responsive-utilities-tests">Test cases</h2>
<p>Resize your browser or load on different devices to test the responsive utility classes.</p>
<h3>Visible on...</h3>
<p>Green checkmarks indicate the element <strong>is visible</strong> in your current viewport.</p>
<div class="row responsive-utilities-test visible-on">
<div class="col-xs-6 col-sm-3"> <span class="hidden-xs">Extra small</span> <span class="visible-xs">✔ Visible on x-small</span> </div>
<div class="col-xs-6 col-sm-3"> <span class="hidden-sm">Small</span> <span class="visible-sm">✔ Visible on small</span> </div>
<div class="clearfix visible-xs"></div>
<div class="col-xs-6 col-sm-3"> <span class="hidden-md">Medium</span> <span class="visible-md">✔ Visible on medium</span> </div>
<div class="col-xs-6 col-sm-3"> <span class="hidden-lg">Large</span> <span class="visible-lg">✔ Visible on large</span> </div>
</div>
<div class="row responsive-utilities-test visible-on">
<div class="col-xs-6 col-sm-6"> <span class="hidden-xs hidden-sm">Extra small and small</span> <span class="visible-xs visible-sm">✔ Visible on x-small and small</span> </div>
<div class="col-xs-6 col-sm-6"> <span class="hidden-md hidden-lg">Medium and large</span> <span class="visible-md visible-lg">✔ Visible on medium and large</span> </div>
<div class="clearfix visible-xs"></div>
<div class="col-xs-6 col-sm-6"> <span class="hidden-xs hidden-md">Extra small and medium</span> <span class="visible-xs visible-md">✔ Visible on x-small and medium</span> </div>
<div class="col-xs-6 col-sm-6"> <span class="hidden-sm hidden-lg">Small and large</span> <span class="visible-sm visible-lg">✔ Visible on small and large</span> </div>
<div class="clearfix visible-xs"></div>
<div class="col-xs-6 col-sm-6"> <span class="hidden-xs hidden-lg">Extra small and large</span> <span class="visible-xs visible-lg">✔ Visible on x-small and large</span> </div>
<div class="col-xs-6 col-sm-6"> <span class="hidden-sm hidden-md">Small and medium</span> <span class="visible-sm visible-md">✔ Visible on small and medium</span> </div>
</div>
<h3>Hidden on...</h3>
<p>Here, green checkmarks also indicate the element <strong>is hidden</strong> in your current viewport.</p>
<div class="row responsive-utilities-test hidden-on">
<div class="col-xs-6 col-sm-3"> <span class="hidden-xs">Extra small</span> <span class="visible-xs">✔ Hidden on x-small</span> </div>
<div class="col-xs-6 col-sm-3"> <span class="hidden-sm">Small</span> <span class="visible-sm">✔ Hidden on small</span> </div>
<div class="clearfix visible-xs"></div>
<div class="col-xs-6 col-sm-3"> <span class="hidden-md">Medium</span> <span class="visible-md">✔ Hidden on medium</span> </div>
<div class="col-xs-6 col-sm-3"> <span class="hidden-lg">Large</span> <span class="visible-lg">✔ Hidden on large</span> </div>
</div>
<div class="row responsive-utilities-test hidden-on">
<div class="col-xs-6 col-sm-6"> <span class="hidden-xs hidden-sm">Extra small and small</span> <span class="visible-xs visible-sm">✔ Hidden on x-small and small</span> </div>
<div class="col-xs-6 col-sm-6"> <span class="hidden-md hidden-lg">Medium and large</span> <span class="visible-md visible-lg">✔ Hidden on medium and large</span> </div>
<div class="clearfix visible-xs"></div>
<div class="col-xs-6 col-sm-6"> <span class="hidden-xs hidden-md">Extra small and medium</span> <span class="visible-xs visible-md">✔ Hidden on x-small and medium</span> </div>
<div class="col-xs-6 col-sm-6"> <span class="hidden-sm hidden-lg">Small and large</span> <span class="visible-sm visible-lg">✔ Hidden on small and large</span> </div>
<div class="clearfix visible-xs"></div>
<div class="col-xs-6 col-sm-6"> <span class="hidden-xs hidden-lg">Extra small and large</span> <span class="visible-xs visible-lg">✔ Hidden on x-small and large</span> </div>
<div class="col-xs-6 col-sm-6"> <span class="hidden-sm hidden-md">Small and medium</span> <span class="visible-sm visible-md">✔ Hidden on small and medium</span> </div>
</div>
<h1 id="glyphicons">Glyphicons</h1>
<h2 id="glyphicons-glyphs">Available glyphs</h2>
<p>Includes 200 glyphs in font format from the Glyphicon Halflings set. <a href="http://glyphicons.com/">Glyphicons</a> Halflings are normally not available for free, but their creator has made them available for Bootstrap free of cost. As a thank you, we only ask that you to include a link back to <a href="http://glyphicons.com/">Glyphicons</a> whenever possible.</p>
<ul class="bs-glyphicons">
<li> <span class="glyphicon glyphicon-adjust"></span> <span class="glyphicon-class">.glyphicon .glyphicon-adjust</span> </li>
<li> <span class="glyphicon glyphicon-align-center"></span> <span class="glyphicon-class">.glyphicon .glyphicon-align-center</span> </li>
<li> <span class="glyphicon glyphicon-align-justify"></span> <span class="glyphicon-class">.glyphicon .glyphicon-align-justify</span> </li>
<li> <span class="glyphicon glyphicon-align-left"></span> <span class="glyphicon-class">.glyphicon .glyphicon-align-left</span> </li>
<li> <span class="glyphicon glyphicon-align-right"></span> <span class="glyphicon-class">.glyphicon .glyphicon-align-right</span> </li>
<li> <span class="glyphicon glyphicon-arrow-down"></span> <span class="glyphicon-class">.glyphicon .glyphicon-arrow-down</span> </li>
<li> <span class="glyphicon glyphicon-arrow-left"></span> <span class="glyphicon-class">.glyphicon .glyphicon-arrow-left</span> </li>
<li> <span class="glyphicon glyphicon-arrow-right"></span> <span class="glyphicon-class">.glyphicon .glyphicon-arrow-right</span> </li>
<li> <span class="glyphicon glyphicon-arrow-up"></span> <span class="glyphicon-class">.glyphicon .glyphicon-arrow-up</span> </li>
<li> <span class="glyphicon glyphicon-asterisk"></span> <span class="glyphicon-class">.glyphicon .glyphicon-asterisk</span> </li>
<li> <span class="glyphicon glyphicon-backward"></span> <span class="glyphicon-class">.glyphicon .glyphicon-backward</span> </li>
<li> <span class="glyphicon glyphicon-ban-circle"></span> <span class="glyphicon-class">.glyphicon .glyphicon-ban-circle</span> </li>
<li> <span class="glyphicon glyphicon-barcode"></span> <span class="glyphicon-class">.glyphicon .glyphicon-barcode</span> </li>
<li> <span class="glyphicon glyphicon-bell"></span> <span class="glyphicon-class">.glyphicon .glyphicon-bell</span> </li>
<li> <span class="glyphicon glyphicon-bold"></span> <span class="glyphicon-class">.glyphicon .glyphicon-bold</span> </li>
<li> <span class="glyphicon glyphicon-book"></span> <span class="glyphicon-class">.glyphicon .glyphicon-book</span> </li>
<li> <span class="glyphicon glyphicon-bookmark"></span> <span class="glyphicon-class">.glyphicon .glyphicon-bookmark</span> </li>
<li> <span class="glyphicon glyphicon-briefcase"></span> <span class="glyphicon-class">.glyphicon .glyphicon-briefcase</span> </li>
<li> <span class="glyphicon glyphicon-bullhorn"></span> <span class="glyphicon-class">.glyphicon .glyphicon-bullhorn</span> </li>
<li> <span class="glyphicon glyphicon-calendar"></span> <span class="glyphicon-class">.glyphicon .glyphicon-calendar</span> </li>
<li> <span class="glyphicon glyphicon-camera"></span> <span class="glyphicon-class">.glyphicon .glyphicon-camera</span> </li>
<li> <span class="glyphicon glyphicon-certificate"></span> <span class="glyphicon-class">.glyphicon .glyphicon-certificate</span> </li>
<li> <span class="glyphicon glyphicon-check"></span> <span class="glyphicon-class">.glyphicon .glyphicon-check</span> </li>
<li> <span class="glyphicon glyphicon-chevron-down"></span> <span class="glyphicon-class">.glyphicon .glyphicon-chevron-down</span> </li>
<li> <span class="glyphicon glyphicon-chevron-left"></span> <span class="glyphicon-class">.glyphicon .glyphicon-chevron-left</span> </li>
<li> <span class="glyphicon glyphicon-chevron-right"></span> <span class="glyphicon-class">.glyphicon .glyphicon-chevron-right</span> </li>
<li> <span class="glyphicon glyphicon-chevron-up"></span> <span class="glyphicon-class">.glyphicon .glyphicon-chevron-up</span> </li>
<li> <span class="glyphicon glyphicon-circle-arrow-down"></span> <span class="glyphicon-class">.glyphicon .glyphicon-circle-arrow-down</span> </li>
<li> <span class="glyphicon glyphicon-circle-arrow-left"></span> <span class="glyphicon-class">.glyphicon .glyphicon-circle-arrow-left</span> </li>
<li> <span class="glyphicon glyphicon-circle-arrow-right"></span> <span class="glyphicon-class">.glyphicon .glyphicon-circle-arrow-right</span> </li>
<li> <span class="glyphicon glyphicon-circle-arrow-up"></span> <span class="glyphicon-class">.glyphicon .glyphicon-circle-arrow-up</span> </li>
<li> <span class="glyphicon glyphicon-cloud"></span> <span class="glyphicon-class">.glyphicon .glyphicon-cloud</span> </li>
<li> <span class="glyphicon glyphicon-cloud-download"></span> <span class="glyphicon-class">.glyphicon .glyphicon-cloud-download</span> </li>
<li> <span class="glyphicon glyphicon-cloud-upload"></span> <span class="glyphicon-class">.glyphicon .glyphicon-cloud-upload</span> </li>
<li> <span class="glyphicon glyphicon-cog"></span> <span class="glyphicon-class">.glyphicon .glyphicon-cog</span> </li>
<li> <span class="glyphicon glyphicon-collapse-down"></span> <span class="glyphicon-class">.glyphicon .glyphicon-collapse-down</span> </li>
<li> <span class="glyphicon glyphicon-collapse-up"></span> <span class="glyphicon-class">.glyphicon .glyphicon-collapse-up</span> </li>
<li> <span class="glyphicon glyphicon-comment"></span> <span class="glyphicon-class">.glyphicon .glyphicon-comment</span> </li>
<li> <span class="glyphicon glyphicon-compressed"></span> <span class="glyphicon-class">.glyphicon .glyphicon-compressed</span> </li>
<li> <span class="glyphicon glyphicon-copyright-mark"></span> <span class="glyphicon-class">.glyphicon .glyphicon-copyright-mark</span> </li>
<li> <span class="glyphicon glyphicon-credit-card"></span> <span class="glyphicon-class">.glyphicon .glyphicon-credit-card</span> </li>
<li> <span class="glyphicon glyphicon-cutlery"></span> <span class="glyphicon-class">.glyphicon .glyphicon-cutlery</span> </li>
<li> <span class="glyphicon glyphicon-dashboard"></span> <span class="glyphicon-class">.glyphicon .glyphicon-dashboard</span> </li>
<li> <span class="glyphicon glyphicon-download"></span> <span class="glyphicon-class">.glyphicon .glyphicon-download</span> </li>
<li> <span class="glyphicon glyphicon-download-alt"></span> <span class="glyphicon-class">.glyphicon .glyphicon-download-alt</span> </li>
<li> <span class="glyphicon glyphicon-earphone"></span> <span class="glyphicon-class">.glyphicon .glyphicon-earphone</span> </li>
<li> <span class="glyphicon glyphicon-edit"></span> <span class="glyphicon-class">.glyphicon .glyphicon-edit</span> </li>
<li> <span class="glyphicon glyphicon-eject"></span> <span class="glyphicon-class">.glyphicon .glyphicon-eject</span> </li>
<li> <span class="glyphicon glyphicon-envelope"></span> <span class="glyphicon-class">.glyphicon .glyphicon-envelope</span> </li>
<li> <span class="glyphicon glyphicon-euro"></span> <span class="glyphicon-class">.glyphicon .glyphicon-euro</span> </li>
<li> <span class="glyphicon glyphicon-exclamation-sign"></span> <span class="glyphicon-class">.glyphicon .glyphicon-exclamation-sign</span> </li>
<li> <span class="glyphicon glyphicon-expand"></span> <span class="glyphicon-class">.glyphicon .glyphicon-expand</span> </li>
<li> <span class="glyphicon glyphicon-export"></span> <span class="glyphicon-class">.glyphicon .glyphicon-export</span> </li>
<li> <span class="glyphicon glyphicon-eye-close"></span> <span class="glyphicon-class">.glyphicon .glyphicon-eye-close</span> </li>
<li> <span class="glyphicon glyphicon-eye-open"></span> <span class="glyphicon-class">.glyphicon .glyphicon-eye-open</span> </li>
<li> <span class="glyphicon glyphicon-facetime-video"></span> <span class="glyphicon-class">.glyphicon .glyphicon-facetime-video</span> </li>
<li> <span class="glyphicon glyphicon-fast-backward"></span> <span class="glyphicon-class">.glyphicon .glyphicon-fast-backward</span> </li>
<li> <span class="glyphicon glyphicon-fast-forward"></span> <span class="glyphicon-class">.glyphicon .glyphicon-fast-forward</span> </li>
<li> <span class="glyphicon glyphicon-file"></span> <span class="glyphicon-class">.glyphicon .glyphicon-file</span> </li>
<li> <span class="glyphicon glyphicon-film"></span> <span class="glyphicon-class">.glyphicon .glyphicon-film</span> </li>
<li> <span class="glyphicon glyphicon-filter"></span> <span class="glyphicon-class">.glyphicon .glyphicon-filter</span> </li>
<li> <span class="glyphicon glyphicon-fire"></span> <span class="glyphicon-class">.glyphicon .glyphicon-fire</span> </li>
<li> <span class="glyphicon glyphicon-flag"></span> <span class="glyphicon-class">.glyphicon .glyphicon-flag</span> </li>
<li> <span class="glyphicon glyphicon-flash"></span> <span class="glyphicon-class">.glyphicon .glyphicon-flash</span> </li>
<li> <span class="glyphicon glyphicon-floppy-disk"></span> <span class="glyphicon-class">.glyphicon .glyphicon-floppy-disk</span> </li>
<li> <span class="glyphicon glyphicon-floppy-open"></span> <span class="glyphicon-class">.glyphicon .glyphicon-floppy-open</span> </li>
<li> <span class="glyphicon glyphicon-floppy-remove"></span> <span class="glyphicon-class">.glyphicon .glyphicon-floppy-remove</span> </li>
<li> <span class="glyphicon glyphicon-floppy-save"></span> <span class="glyphicon-class">.glyphicon .glyphicon-floppy-save</span> </li>
<li> <span class="glyphicon glyphicon-floppy-saved"></span> <span class="glyphicon-class">.glyphicon .glyphicon-floppy-saved</span> </li>
<li> <span class="glyphicon glyphicon-folder-close"></span> <span class="glyphicon-class">.glyphicon .glyphicon-folder-close</span> </li>
<li> <span class="glyphicon glyphicon-folder-open"></span> <span class="glyphicon-class">.glyphicon .glyphicon-folder-open</span> </li>
<li> <span class="glyphicon glyphicon-font"></span> <span class="glyphicon-class">.glyphicon .glyphicon-font</span> </li>
<li> <span class="glyphicon glyphicon-forward"></span> <span class="glyphicon-class">.glyphicon .glyphicon-forward</span> </li>
<li> <span class="glyphicon glyphicon-fullscreen"></span> <span class="glyphicon-class">.glyphicon .glyphicon-fullscreen</span> </li>
<li> <span class="glyphicon glyphicon-gbp"></span> <span class="glyphicon-class">.glyphicon .glyphicon-gbp</span> </li>
<li> <span class="glyphicon glyphicon-gift"></span> <span class="glyphicon-class">.glyphicon .glyphicon-gift</span> </li>
<li> <span class="glyphicon glyphicon-glass"></span> <span class="glyphicon-class">.glyphicon .glyphicon-glass</span> </li>
<li> <span class="glyphicon glyphicon-globe"></span> <span class="glyphicon-class">.glyphicon .glyphicon-globe</span> </li>
<li> <span class="glyphicon glyphicon-hand-down"></span> <span class="glyphicon-class">.glyphicon .glyphicon-hand-down</span> </li>
<li> <span class="glyphicon glyphicon-hand-left"></span> <span class="glyphicon-class">.glyphicon .glyphicon-hand-left</span> </li>
<li> <span class="glyphicon glyphicon-hand-right"></span> <span class="glyphicon-class">.glyphicon .glyphicon-hand-right</span> </li>
<li> <span class="glyphicon glyphicon-hand-up"></span> <span class="glyphicon-class">.glyphicon .glyphicon-hand-up</span> </li>
<li> <span class="glyphicon glyphicon-hd-video"></span> <span class="glyphicon-class">.glyphicon .glyphicon-hd-video</span> </li>
<li> <span class="glyphicon glyphicon-hdd"></span> <span class="glyphicon-class">.glyphicon .glyphicon-hdd</span> </li>
<li> <span class="glyphicon glyphicon-header"></span> <span class="glyphicon-class">.glyphicon .glyphicon-header</span> </li>
<li> <span class="glyphicon glyphicon-headphones"></span> <span class="glyphicon-class">.glyphicon .glyphicon-headphones</span> </li>
<li> <span class="glyphicon glyphicon-heart"></span> <span class="glyphicon-class">.glyphicon .glyphicon-heart</span> </li>
<li> <span class="glyphicon glyphicon-heart-empty"></span> <span class="glyphicon-class">.glyphicon .glyphicon-heart-empty</span> </li>
<li> <span class="glyphicon glyphicon-home"></span> <span class="glyphicon-class">.glyphicon .glyphicon-home</span> </li>
<li> <span class="glyphicon glyphicon-import"></span> <span class="glyphicon-class">.glyphicon .glyphicon-import</span> </li>
<li> <span class="glyphicon glyphicon-inbox"></span> <span class="glyphicon-class">.glyphicon .glyphicon-inbox</span> </li>
<li> <span class="glyphicon glyphicon-indent-left"></span> <span class="glyphicon-class">.glyphicon .glyphicon-indent-left</span> </li>
<li> <span class="glyphicon glyphicon-indent-right"></span> <span class="glyphicon-class">.glyphicon .glyphicon-indent-right</span> </li>
<li> <span class="glyphicon glyphicon-info-sign"></span> <span class="glyphicon-class">.glyphicon .glyphicon-info-sign</span> </li>
<li> <span class="glyphicon glyphicon-italic"></span> <span class="glyphicon-class">.glyphicon .glyphicon-italic</span> </li>
<li> <span class="glyphicon glyphicon-leaf"></span> <span class="glyphicon-class">.glyphicon .glyphicon-leaf</span> </li>
<li> <span class="glyphicon glyphicon-link"></span> <span class="glyphicon-class">.glyphicon .glyphicon-link</span> </li>
<li> <span class="glyphicon glyphicon-list"></span> <span class="glyphicon-class">.glyphicon .glyphicon-list</span> </li>
<li> <span class="glyphicon glyphicon-list-alt"></span> <span class="glyphicon-class">.glyphicon .glyphicon-list-alt</span> </li>
<li> <span class="glyphicon glyphicon-lock"></span> <span class="glyphicon-class">.glyphicon .glyphicon-lock</span> </li>
<li> <span class="glyphicon glyphicon-log-in"></span> <span class="glyphicon-class">.glyphicon .glyphicon-log-in</span> </li>
<li> <span class="glyphicon glyphicon-log-out"></span> <span class="glyphicon-class">.glyphicon .glyphicon-log-out</span> </li>
<li> <span class="glyphicon glyphicon-magnet"></span> <span class="glyphicon-class">.glyphicon .glyphicon-magnet</span> </li>
<li> <span class="glyphicon glyphicon-map-marker"></span> <span class="glyphicon-class">.glyphicon .glyphicon-map-marker</span> </li>
<li> <span class="glyphicon glyphicon-minus"></span> <span class="glyphicon-class">.glyphicon .glyphicon-minus</span> </li>
<li> <span class="glyphicon glyphicon-minus-sign"></span> <span class="glyphicon-class">.glyphicon .glyphicon-minus-sign</span> </li>
<li> <span class="glyphicon glyphicon-move"></span> <span class="glyphicon-class">.glyphicon .glyphicon-move</span> </li>
<li> <span class="glyphicon glyphicon-music"></span> <span class="glyphicon-class">.glyphicon .glyphicon-music</span> </li>
<li> <span class="glyphicon glyphicon-new-window"></span> <span class="glyphicon-class">.glyphicon .glyphicon-new-window</span> </li>
<li> <span class="glyphicon glyphicon-off"></span> <span class="glyphicon-class">.glyphicon .glyphicon-off</span> </li>
<li> <span class="glyphicon glyphicon-ok"></span> <span class="glyphicon-class">.glyphicon .glyphicon-ok</span> </li>
<li> <span class="glyphicon glyphicon-ok-circle"></span> <span class="glyphicon-class">.glyphicon .glyphicon-ok-circle</span> </li>
<li> <span class="glyphicon glyphicon-ok-sign"></span> <span class="glyphicon-class">.glyphicon .glyphicon-ok-sign</span> </li>
<li> <span class="glyphicon glyphicon-open"></span> <span class="glyphicon-class">.glyphicon .glyphicon-open</span> </li>
<li> <span class="glyphicon glyphicon-paperclip"></span> <span class="glyphicon-class">.glyphicon .glyphicon-paperclip</span> </li>
<li> <span class="glyphicon glyphicon-pause"></span> <span class="glyphicon-class">.glyphicon .glyphicon-pause</span> </li>
<li> <span class="glyphicon glyphicon-pencil"></span> <span class="glyphicon-class">.glyphicon .glyphicon-pencil</span> </li>
<li> <span class="glyphicon glyphicon-phone"></span> <span class="glyphicon-class">.glyphicon .glyphicon-phone</span> </li>
<li> <span class="glyphicon glyphicon-phone-alt"></span> <span class="glyphicon-class">.glyphicon .glyphicon-phone-alt</span> </li>
<li> <span class="glyphicon glyphicon-picture"></span> <span class="glyphicon-class">.glyphicon .glyphicon-picture</span> </li>
<li> <span class="glyphicon glyphicon-plane"></span> <span class="glyphicon-class">.glyphicon .glyphicon-plane</span> </li>
<li> <span class="glyphicon glyphicon-play"></span> <span class="glyphicon-class">.glyphicon .glyphicon-play</span> </li>
<li> <span class="glyphicon glyphicon-play-circle"></span> <span class="glyphicon-class">.glyphicon .glyphicon-play-circle</span> </li>
<li> <span class="glyphicon glyphicon-plus"></span> <span class="glyphicon-class">.glyphicon .glyphicon-plus</span> </li>
<li> <span class="glyphicon glyphicon-plus-sign"></span> <span class="glyphicon-class">.glyphicon .glyphicon-plus-sign</span> </li>
<li> <span class="glyphicon glyphicon-print"></span> <span class="glyphicon-class">.glyphicon .glyphicon-print</span> </li>
<li> <span class="glyphicon glyphicon-pushpin"></span> <span class="glyphicon-class">.glyphicon .glyphicon-pushpin</span> </li>
<li> <span class="glyphicon glyphicon-qrcode"></span> <span class="glyphicon-class">.glyphicon .glyphicon-qrcode</span> </li>
<li> <span class="glyphicon glyphicon-question-sign"></span> <span class="glyphicon-class">.glyphicon .glyphicon-question-sign</span> </li>
<li> <span class="glyphicon glyphicon-random"></span> <span class="glyphicon-class">.glyphicon .glyphicon-random</span> </li>
<li> <span class="glyphicon glyphicon-record"></span> <span class="glyphicon-class">.glyphicon .glyphicon-record</span> </li>
<li> <span class="glyphicon glyphicon-refresh"></span> <span class="glyphicon-class">.glyphicon .glyphicon-refresh</span> </li>
<li> <span class="glyphicon glyphicon-registration-mark"></span> <span class="glyphicon-class">.glyphicon .glyphicon-registration-mark</span> </li>
<li> <span class="glyphicon glyphicon-remove"></span> <span class="glyphicon-class">.glyphicon .glyphicon-remove</span> </li>
<li> <span class="glyphicon glyphicon-remove-circle"></span> <span class="glyphicon-class">.glyphicon .glyphicon-remove-circle</span> </li>
<li> <span class="glyphicon glyphicon-remove-sign"></span> <span class="glyphicon-class">.glyphicon .glyphicon-remove-sign</span> </li>
<li> <span class="glyphicon glyphicon-repeat"></span> <span class="glyphicon-class">.glyphicon .glyphicon-repeat</span> </li>
<li> <span class="glyphicon glyphicon-resize-full"></span> <span class="glyphicon-class">.glyphicon .glyphicon-resize-full</span> </li>
<li> <span class="glyphicon glyphicon-resize-horizontal"></span> <span class="glyphicon-class">.glyphicon .glyphicon-resize-horizontal</span> </li>
<li> <span class="glyphicon glyphicon-resize-small"></span> <span class="glyphicon-class">.glyphicon .glyphicon-resize-small</span> </li>
<li> <span class="glyphicon glyphicon-resize-vertical"></span> <span class="glyphicon-class">.glyphicon .glyphicon-resize-vertical</span> </li>
<li> <span class="glyphicon glyphicon-retweet"></span> <span class="glyphicon-class">.glyphicon .glyphicon-retweet</span> </li>
<li> <span class="glyphicon glyphicon-road"></span> <span class="glyphicon-class">.glyphicon .glyphicon-road</span> </li>
<li> <span class="glyphicon glyphicon-save"></span> <span class="glyphicon-class">.glyphicon .glyphicon-save</span> </li>
<li> <span class="glyphicon glyphicon-saved"></span> <span class="glyphicon-class">.glyphicon .glyphicon-saved</span> </li>
<li> <span class="glyphicon glyphicon-screenshot"></span> <span class="glyphicon-class">.glyphicon .glyphicon-screenshot</span> </li>
<li> <span class="glyphicon glyphicon-sd-video"></span> <span class="glyphicon-class">.glyphicon .glyphicon-sd-video</span> </li>
<li> <span class="glyphicon glyphicon-search"></span> <span class="glyphicon-class">.glyphicon .glyphicon-search</span> </li>
<li> <span class="glyphicon glyphicon-send"></span> <span class="glyphicon-class">.glyphicon .glyphicon-send</span> </li>
<li> <span class="glyphicon glyphicon-share"></span> <span class="glyphicon-class">.glyphicon .glyphicon-share</span> </li>
<li> <span class="glyphicon glyphicon-share-alt"></span> <span class="glyphicon-class">.glyphicon .glyphicon-share-alt</span> </li>
<li> <span class="glyphicon glyphicon-shopping-cart"></span> <span class="glyphicon-class">.glyphicon .glyphicon-shopping-cart</span> </li>
<li> <span class="glyphicon glyphicon-signal"></span> <span class="glyphicon-class">.glyphicon .glyphicon-signal</span> </li>
<li> <span class="glyphicon glyphicon-sort"></span> <span class="glyphicon-class">.glyphicon .glyphicon-sort</span> </li>
<li> <span class="glyphicon glyphicon-sort-by-alphabet"></span> <span class="glyphicon-class">.glyphicon .glyphicon-sort-by-alphabet</span> </li>
<li> <span class="glyphicon glyphicon-sort-by-alphabet-alt"></span> <span class="glyphicon-class">.glyphicon .glyphicon-sort-by-alphabet-alt</span> </li>
<li> <span class="glyphicon glyphicon-sort-by-attributes"></span> <span class="glyphicon-class">.glyphicon .glyphicon-sort-by-attributes</span> </li>
<li> <span class="glyphicon glyphicon-sort-by-attributes-alt"></span> <span class="glyphicon-class">.glyphicon .glyphicon-sort-by-attributes-alt</span> </li>
<li> <span class="glyphicon glyphicon-sort-by-order"></span> <span class="glyphicon-class">.glyphicon .glyphicon-sort-by-order</span> </li>
<li> <span class="glyphicon glyphicon-sort-by-order-alt"></span> <span class="glyphicon-class">.glyphicon .glyphicon-sort-by-order-alt</span> </li>
<li> <span class="glyphicon glyphicon-sound-5-1"></span> <span class="glyphicon-class">.glyphicon .glyphicon-sound-5-1</span> </li>
<li> <span class="glyphicon glyphicon-sound-6-1"></span> <span class="glyphicon-class">.glyphicon .glyphicon-sound-6-1</span> </li>
<li> <span class="glyphicon glyphicon-sound-7-1"></span> <span class="glyphicon-class">.glyphicon .glyphicon-sound-7-1</span> </li>
<li> <span class="glyphicon glyphicon-sound-dolby"></span> <span class="glyphicon-class">.glyphicon .glyphicon-sound-dolby</span> </li>
<li> <span class="glyphicon glyphicon-sound-stereo"></span> <span class="glyphicon-class">.glyphicon .glyphicon-sound-stereo</span> </li>
<li> <span class="glyphicon glyphicon-star"></span> <span class="glyphicon-class">.glyphicon .glyphicon-star</span> </li>
<li> <span class="glyphicon glyphicon-star-empty"></span> <span class="glyphicon-class">.glyphicon .glyphicon-star-empty</span> </li>
<li> <span class="glyphicon glyphicon-stats"></span> <span class="glyphicon-class">.glyphicon .glyphicon-stats</span> </li>
<li> <span class="glyphicon glyphicon-step-backward"></span> <span class="glyphicon-class">.glyphicon .glyphicon-step-backward</span> </li>
<li> <span class="glyphicon glyphicon-step-forward"></span> <span class="glyphicon-class">.glyphicon .glyphicon-step-forward</span> </li>
<li> <span class="glyphicon glyphicon-stop"></span> <span class="glyphicon-class">.glyphicon .glyphicon-stop</span> </li>
<li> <span class="glyphicon glyphicon-subtitles"></span> <span class="glyphicon-class">.glyphicon .glyphicon-subtitles</span> </li>
<li> <span class="glyphicon glyphicon-tag"></span> <span class="glyphicon-class">.glyphicon .glyphicon-tag</span> </li>
<li> <span class="glyphicon glyphicon-tags"></span> <span class="glyphicon-class">.glyphicon .glyphicon-tags</span> </li>
<li> <span class="glyphicon glyphicon-tasks"></span> <span class="glyphicon-class">.glyphicon .glyphicon-tasks</span> </li>
<li> <span class="glyphicon glyphicon-text-height"></span> <span class="glyphicon-class">.glyphicon .glyphicon-text-height</span> </li>
<li> <span class="glyphicon glyphicon-text-width"></span> <span class="glyphicon-class">.glyphicon .glyphicon-text-width</span> </li>
<li> <span class="glyphicon glyphicon-th"></span> <span class="glyphicon-class">.glyphicon .glyphicon-th</span> </li>
<li> <span class="glyphicon glyphicon-th-large"></span> <span class="glyphicon-class">.glyphicon .glyphicon-th-large</span> </li>
<li> <span class="glyphicon glyphicon-th-list"></span> <span class="glyphicon-class">.glyphicon .glyphicon-th-list</span> </li>
<li> <span class="glyphicon glyphicon-thumbs-down"></span> <span class="glyphicon-class">.glyphicon .glyphicon-thumbs-down</span> </li>
<li> <span class="glyphicon glyphicon-thumbs-up"></span> <span class="glyphicon-class">.glyphicon .glyphicon-thumbs-up</span> </li>
<li> <span class="glyphicon glyphicon-time"></span> <span class="glyphicon-class">.glyphicon .glyphicon-time</span> </li>
<li> <span class="glyphicon glyphicon-tint"></span> <span class="glyphicon-class">.glyphicon .glyphicon-tint</span> </li>
<li> <span class="glyphicon glyphicon-tower"></span> <span class="glyphicon-class">.glyphicon .glyphicon-tower</span> </li>
<li> <span class="glyphicon glyphicon-transfer"></span> <span class="glyphicon-class">.glyphicon .glyphicon-transfer</span> </li>
<li> <span class="glyphicon glyphicon-trash"></span> <span class="glyphicon-class">.glyphicon .glyphicon-trash</span> </li>
<li> <span class="glyphicon glyphicon-tree-conifer"></span> <span class="glyphicon-class">.glyphicon .glyphicon-tree-conifer</span> </li>
<li> <span class="glyphicon glyphicon-tree-deciduous"></span> <span class="glyphicon-class">.glyphicon .glyphicon-tree-deciduous</span> </li>
<li> <span class="glyphicon glyphicon-unchecked"></span> <span class="glyphicon-class">.glyphicon .glyphicon-unchecked</span> </li>
<li> <span class="glyphicon glyphicon-upload"></span> <span class="glyphicon-class">.glyphicon .glyphicon-upload</span> </li>
<li> <span class="glyphicon glyphicon-usd"></span> <span class="glyphicon-class">.glyphicon .glyphicon-usd</span> </li>
<li> <span class="glyphicon glyphicon-user"></span> <span class="glyphicon-class">.glyphicon .glyphicon-user</span> </li>
<li> <span class="glyphicon glyphicon-volume-down"></span> <span class="glyphicon-class">.glyphicon .glyphicon-volume-down</span> </li>
<li> <span class="glyphicon glyphicon-volume-off"></span> <span class="glyphicon-class">.glyphicon .glyphicon-volume-off</span> </li>
<li> <span class="glyphicon glyphicon-volume-up"></span> <span class="glyphicon-class">.glyphicon .glyphicon-volume-up</span> </li>
<li> <span class="glyphicon glyphicon-warning-sign"></span> <span class="glyphicon-class">.glyphicon .glyphicon-warning-sign</span> </li>
<li> <span class="glyphicon glyphicon-wrench"></span> <span class="glyphicon-class">.glyphicon .glyphicon-wrench</span> </li>
<li> <span class="glyphicon glyphicon-zoom-in"></span> <span class="glyphicon-class">.glyphicon .glyphicon-zoom-in</span> </li>
<li> <span class="glyphicon glyphicon-zoom-out"></span> <span class="glyphicon-class">.glyphicon .glyphicon-zoom-out</span> </li>
</ul>
<h2 id="glyphicons-how-to-use">How to use</h2>
<p>For performance reasons, all icons require a base class and individual icon class. To use, place the following code just about anywhere. Be sure to leave a space between the icon and text for proper padding.</p>
<div class="highlight">
<pre><code class="html"><span class="nt"><span</span> <span class="na">class=</span><span class="s">"glyphicon glyphicon-search"</span><span class="nt">></span></span>
Use them in buttons, button groups for a toolbar, navigation, or prepended form inputs.
<button type="button" class="btn btn-default btn-lg">
<span class="glyphicon glyphicon-star"></span> Star
</button>
<h1 id="dropdowns">Dropdowns</h1>
<p class="lead">Toggleable, contextual menu for displaying lists of links. Made interactive with the <a href="javascript/#dropdowns">dropdown JavaScript plugin</a>.</p>
<h3 id="dropdowns-example">Example</h3>
<p>Wrap the dropdown's trigger and the dropdown menu within <code>.dropdown</code>, or another element that declares <code>position: relative;</code>. Then add the menu's HTML.</p>
<div class="bs-example">
<div class="dropdown clearfix">
<button class="btn dropdown-toggle sr-only" type="button" id="dropdownMenu1" data-toggle="dropdown"> Dropdown <span class="caret"></span> </button>
<ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu1">
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Action</a></li>
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Another action</a></li>
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Something else here</a></li>
<li role="presentation" class="divider"></li>
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Separated link</a></li>
</ul>
</div>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"dropdown"</span><span class="nt">></span>
<button class="btn dropdown-toggle sr-only" type="button" id="dropdownMenu1" data-toggle="dropdown">
Dropdown
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"caret"</span><span class="nt">></span></span>
</button> <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu1">
<span class="nt"><li</span> <span class="na">role=</span><span class="s">"presentation"</span><span class="nt">><a</span> <span class="na">role=</span><span class="s">"menuitem"</span> <span class="na">tabindex=</span><span class="s">"-1"</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Action<span class="nt"></a></li></span>
<span class="nt"><li</span> <span class="na">role=</span><span class="s">"presentation"</span><span class="nt">><a</span> <span class="na">role=</span><span class="s">"menuitem"</span> <span class="na">tabindex=</span><span class="s">"-1"</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Another action<span class="nt"></a></li></span>
<span class="nt"><li</span> <span class="na">role=</span><span class="s">"presentation"</span><span class="nt">><a</span> <span class="na">role=</span><span class="s">"menuitem"</span> <span class="na">tabindex=</span><span class="s">"-1"</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Something else here<span class="nt"></a></li></span>
<span class="nt"><li</span> <span class="na">role=</span><span class="s">"presentation"</span> <span class="na">class=</span><span class="s">"divider"</span><span class="nt">></li></span>
<span class="nt"><li</span> <span class="na">role=</span><span class="s">"presentation"</span><span class="nt">><a</span> <span class="na">role=</span><span class="s">"menuitem"</span> <span class="na">tabindex=</span><span class="s">"-1"</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Separated link<span class="nt"></a></li></span>
</ul> </div>
Add .pull-right
to a .dropdown-menu
to right align the dropdown menu.
<ul class="dropdown-menu pull-right" role="menu" aria-labelledby="dLabel">
...
</ul>
Add a header to label sections of actions in any dropdown menu.
- Dropdown header
- Action
- Another action
- Something else here
- Dropdown header
- Separated link
<div class="highlight">
<pre><code class="html"><span class="nt"><ul</span> <span class="na">class=</span><span class="s">"dropdown-menu"</span> <span class="na">role=</span><span class="s">"menu"</span> <span class="na">aria-labelledby=</span><span class="s">"dropdownMenu2"</span><span class="nt">></span>
<li role="presentation" class="dropdown-header">Dropdown header</li> ... <li role="presentation" class="divider"></li>
<li role="presentation" class="dropdown-header">Dropdown header</li> ... </ul>
Add .disabled
to a <li>
in the dropdown to disable the link.
<div class="highlight">
<pre><code class="html"><span class="nt"><ul</span> <span class="na">class=</span><span class="s">"dropdown-menu"</span> <span class="na">role=</span><span class="s">"menu"</span> <span class="na">aria-labelledby=</span><span class="s">"dropdownMenu3"</span><span class="nt">></span>
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Regular link</a></li>
<li role="presentation" class="disabled"><a role="menuitem" tabindex="-1" href="#">Disabled link</a></li>
<li role="presentation"><a role="menuitem" tabindex="-1" href="#">Another link</a></li>
</ul>
<h1 id="btn-groups">Button groups</h1>
<p class="lead">Group a series of buttons together on a single line with the button group. Add on optional JavaScript radio and checkbox style behavior with <a href="javascript/#buttons">our buttons plugin</a>.</p>
<div class="bs-callout bs-callout-info">
<h4>Tooltips & popovers in button groups require special setting</h4>
<p>When using tooltips or popovers on elements within a <code>.btn-group</code>, you'll have to specify the option <code>container: 'body'</code> to avoid unwanted side effects (such as the element growing wider and/or losing its rounded corners when the tooltip or popover is triggered).</p>
</div>
<h3 id="btn-groups-single">Basic example</h3>
<p>Wrap a series of buttons with <code>.btn</code> in <code>.btn-group</code>.</p>
<div class="bs-example">
<div class="btn-group" style="margin: 9px 0 5px;">
<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>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"btn-group"</span><span class="nt">></span>
<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">
<div class="btn-group">...</div>
<div class="btn-group">...</div>
<div class="btn-group">...</div>
</div>
Instead of applying button sizing classes to every button in a group, just add .btn-group-*
to the .btn-group
.
<div class="btn-group btn-group-lg">...</div>
<div class="btn-group">...</div>
<div class="btn-group btn-group-sm">...</div>
<div class="btn-group btn-group-xs">...</div>
Place a .btn-group
within another .btn-group
when you want dropdown menus mixed with a series of buttons.
<div class="btn-group">
<button type="button" class="btn btn-default">1</button>
<button type="button" class="btn btn-default">2</button>
<div class="btn-group">
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown">
Dropdown
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"caret"</span><span class="nt">></span></span>
<span class="nt"></button></span>
<span class="nt"><ul</span> <span class="na">class=</span><span class="s">"dropdown-menu"</span><span class="nt">></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Dropdown link<span class="nt"></a></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Dropdown link<span class="nt"></a></li></span>
<span class="nt"></ul></span>
</div>
</div>
Make a set of buttons appear vertically stacked rather than horizontally.
<div class="btn-group-vertical">
...
</div>
Make a group of buttons stretch at the same size to span the entire width of its parent.
This only works with <a>
elements as the <button>
doesn't pick up these styles.
<div class="btn-group btn-group-justified">
...
</div>
<h1 id="btn-dropdowns">Button dropdowns</h1>
<p class="lead">Use any button to trigger a dropdown menu by placing it within a <code>.btn-group</code> and providing the proper menu markup.</p>
<div class="bs-callout bs-callout-danger">
<h4>Plugin dependency</h4>
<p>Button dropdowns require the <a href="javascript/#dropdowns">dropdown plugin</a> to be included in your version of Bootstrap.</p>
</div>
<h3 id="btn-dropdowns-single">Single button dropdowns</h3>
<p>Turn a button into a dropdown toggle with some basic markup changes.</p>
<div class="bs-example">
<div class="btn-group">
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown">Default <span class="caret"></span></button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
<div class="btn-group">
<button type="button" class="btn btn-primary dropdown-toggle" data-toggle="dropdown">Primary <span class="caret"></span></button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
<div class="btn-group">
<button type="button" class="btn btn-success dropdown-toggle" data-toggle="dropdown">Success <span class="caret"></span></button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
<div class="btn-group">
<button type="button" class="btn btn-info dropdown-toggle" data-toggle="dropdown">Info <span class="caret"></span></button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
<div class="btn-group">
<button type="button" class="btn btn-warning dropdown-toggle" data-toggle="dropdown">Warning <span class="caret"></span></button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
<div class="btn-group">
<button type="button" class="btn btn-danger dropdown-toggle" data-toggle="dropdown">Danger <span class="caret"></span></button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
</div>
<div class="highlight">
<pre><code class="html"><span class="c"><!-- Single button --></span>
<div class="btn-group"> <button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown">
Action <span class="nt"><span</span> <span class="na">class=</span><span class="s">"caret"</span><span class="nt">></span></span>
</button> <ul class="dropdown-menu" role="menu">
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Action<span class="nt"></a></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Another action<span class="nt"></a></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Something else here<span class="nt"></a></li></span>
<span class="nt"><li</span> <span class="na">class=</span><span class="s">"divider"</span><span class="nt">></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Separated link<span class="nt"></a></li></span>
</ul> </div>
Similarly, create split button dropdowns with the same markup changes, only with a separate button.
<div class="btn-group">
<button type="button" class="btn btn-primary">Primary</button>
<button type="button" class="btn btn-primary dropdown-toggle" data-toggle="dropdown"> <span class="caret"></span> <span class="sr-only">Toggle Dropdown</span> </button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
<div class="btn-group">
<button type="button" class="btn btn-success">Success</button>
<button type="button" class="btn btn-success dropdown-toggle" data-toggle="dropdown"> <span class="caret"></span> <span class="sr-only">Toggle Dropdown</span> </button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
<div class="btn-group">
<button type="button" class="btn btn-info">Info</button>
<button type="button" class="btn btn-info dropdown-toggle" data-toggle="dropdown"> <span class="caret"></span> <span class="sr-only">Toggle Dropdown</span> </button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
<div class="btn-group">
<button type="button" class="btn btn-warning">Warning</button>
<button type="button" class="btn btn-warning dropdown-toggle" data-toggle="dropdown"> <span class="caret"></span> <span class="sr-only">Toggle Dropdown</span> </button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
<div class="btn-group">
<button type="button" class="btn btn-danger">Danger</button>
<button type="button" class="btn btn-danger dropdown-toggle" data-toggle="dropdown"> <span class="caret"></span> <span class="sr-only">Toggle Dropdown</span> </button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
</div>
<div class="highlight">
<pre><code class="html"><span class="c"><!-- Split button --></span>
<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"> <span class="caret"></span>
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"sr-only"</span><span class="nt">></span>Toggle Dropdown<span class="nt"></span></span>
</button> <ul class="dropdown-menu" role="menu">
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Action<span class="nt"></a></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Another action<span class="nt"></a></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Something else here<span class="nt"></a></li></span>
<span class="nt"><li</span> <span class="na">class=</span><span class="s">"divider"</span><span class="nt">></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Separated link<span class="nt"></a></li></span>
</ul> </div>
Button dropdowns work with buttons of all sizes.
</div>
<div class="btn-toolbar" role="toolbar">
<div class="btn-group">
<button class="btn btn-default btn-sm dropdown-toggle" type="button" data-toggle="dropdown"> Small button <span class="caret"></span> </button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
</div>
<div class="btn-toolbar" role="toolbar">
<div class="btn-group">
<button class="btn btn-default btn-xs dropdown-toggle" type="button" data-toggle="dropdown"> Extra small button <span class="caret"></span> </button>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
</div>
</div>
<div class="highlight">
<pre><code class="html"><span class="c"><!-- Large button group --></span>
<div class="btn-group"> <button class="btn btn-default btn-lg dropdown-toggle" type="button" data-toggle="dropdown">
Large button <span class="nt"><span</span> <span class="na">class=</span><span class="s">"caret"</span><span class="nt">></span></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">
Small button <span class="nt"><span</span> <span class="na">class=</span><span class="s">"caret"</span><span class="nt">></span></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">
Extra small button <span class="nt"><span</span> <span class="na">class=</span><span class="s">"caret"</span><span class="nt">></span></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-primary">Right dropup</button>
<button type="button" class="btn btn-primary dropdown-toggle" data-toggle="dropdown"> <span class="caret"></span> <span class="sr-only">Toggle Dropdown</span> </button>
<ul class="dropdown-menu pull-right" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
</div>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"btn-group dropup"</span><span class="nt">></span>
<button type="button" class="btn btn-default">Dropup</button>
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown"> <span class="caret"></span>
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"sr-only"</span><span class="nt">></span>Toggle Dropdown<span class="nt"></span></span>
</button> <ul class="dropdown-menu">
<span class="c"><!-- Dropdown menu links --></span>
</ul> </div>
<h1 id="input-groups">Input groups</h1>
<p class="lead">Extend form controls by adding text or buttons before, after, or on both sides of any text-based input. Use <code>.input-group</code> with an <code>.input-group-addon</code> to prepend or append elements to a <code>.form-control</code>.</p>
<div class="bs-callout bs-callout-danger">
<h4>Cross-browser compatibility</h4>
<p>Avoid using <code><select></code> elements here as they cannot be fully styled in WebKit browsers.</p>
</div>
<div class="bs-callout bs-callout-info">
<h4>Tooltips & popovers in input groups require special setting</h4>
<p>When using tooltips or popovers on elements within an <code>.input-group</code>, you'll have to specify the option <code>container: 'body'</code> to avoid unwanted side effects (such as the element growing wider and/or losing its rounded corners when the tooltip or popover is triggered).</p>
</div>
<div class="bs-callout bs-callout-info">
<h4>Don't mix with form groups</h4>
<p>Do not apply input group classes directly to form groups. An input group is an isolated component.</p>
</div>
<h2 id="input-groups-basic">Basic example</h2>
<form class="bs-example bs-example-form" role="form">
<div class="input-group"> <span class="input-group-addon">@</span>
<input type="text" class="form-control" placeholder="Username">
</div>
<br>
<div class="input-group">
<input type="text" class="form-control">
<span class="input-group-addon">.00</span> </div>
<br>
<div class="input-group"> <span class="input-group-addon">$</span>
<input type="text" class="form-control">
<span class="input-group-addon">.00</span> </div>
</form>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"input-group"</span><span class="nt">></span>
<span class="input-group-addon">@</span>
<input type="text" class="form-control" placeholder="Username"> </div>
<div class="input-group">
<input type="text" class="form-control"> <span class="input-group-addon">.00</span>
</div>
<div class="input-group"> <span class="input-group-addon">$</span> <input type="text" class="form-control">
<span class="input-group-addon">.00</span> </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">@</span>
<input type="text" class="form-control" placeholder="Username">
</div>
<div class="input-group">
<span class="input-group-addon">@</span>
<input type="text" class="form-control" placeholder="Username">
</div>
<div class="input-group input-group-sm">
<span class="input-group-addon">@</span>
<input type="text" class="form-control" placeholder="Username">
</div>
Place any checkbox or radio option within an input group's addon instead of text.
</div>
<div class="col-lg-6">
<div class="input-group"> <span class="input-group-addon">
<input type="radio">
</span>
<input type="text" class="form-control">
</div>
</div>
</div>
</form>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"row"</span><span class="nt">></span>
<div class="col-lg-6"> <div class="input-group"> <span class="input-group-addon">
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"checkbox"</span><span class="nt">></span>
<span class="nt"></span></span>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"text"</span> <span class="na">class=</span><span class="s">"form-control"</span><span class="nt">></span>
<span class="nt"></div></span><span class="c"><!-- /input-group --></span>
</div><!-- /.col-lg-6 --> <div class="col-lg-6"> <div class="input-group">
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"input-group-addon"</span><span class="nt">></span>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"radio"</span><span class="nt">></span>
<span class="nt"></span></span>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"text"</span> <span class="na">class=</span><span class="s">"form-control"</span><span class="nt">></span>
<span class="nt"></div></span><span class="c"><!-- /input-group --></span>
</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>
<div class="col-lg-6">
<div class="input-group">
<input type="text" class="form-control">
<span class="input-group-btn">
<button class="btn btn-default" type="button">Go!</button>
</span> </div>
</div>
</div>
</form>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"row"</span><span class="nt">></span>
<div class="col-lg-6"> <div class="input-group"> <span class="input-group-btn">
<span class="nt"><button</span> <span class="na">class=</span><span class="s">"btn btn-default"</span> <span class="na">type=</span><span class="s">"button"</span><span class="nt">></span>Go!<span class="nt"></button></span>
<span class="nt"></span></span>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"text"</span> <span class="na">class=</span><span class="s">"form-control"</span><span class="nt">></span>
<span class="nt"></div></span><span class="c"><!-- /input-group --></span>
</div><!-- /.col-lg-6 --> <div class="col-lg-6"> <div class="input-group">
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"text"</span> <span class="na">class=</span><span class="s">"form-control"</span><span class="nt">></span>
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"input-group-btn"</span><span class="nt">></span>
<span class="nt"><button</span> <span class="na">class=</span><span class="s">"btn btn-default"</span> <span class="na">type=</span><span class="s">"button"</span><span class="nt">></span>Go!<span class="nt"></button></span>
<span class="nt"></span></span>
<span class="nt"></div></span><span class="c"><!-- /input-group --></span>
</div><!-- /.col-lg-6 --> </div><!-- /.row -->
<input type="text" class="form-control">
</div>
</div>
<div class="col-lg-6">
<div class="input-group">
<input type="text" class="form-control">
<div class="input-group-btn">
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
<ul class="dropdown-menu pull-right" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
</div>
</div>
</div>
</form>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"row"</span><span class="nt">></span>
<div class="col-lg-6">
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"input-group"</span><span class="nt">></span>
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"input-group-btn"</span><span class="nt">></span>
<span class="nt"><button</span> <span class="na">type=</span><span class="s">"button"</span> <span class="na">class=</span><span class="s">"btn btn-default dropdown-toggle"</span> <span class="na">data-toggle=</span><span class="s">"dropdown"</span><span class="nt">></span>Action <span class="nt"><span</span> <span class="na">class=</span><span class="s">"caret"</span><span class="nt">></span></button></span>
<span class="nt"><ul</span> <span class="na">class=</span><span class="s">"dropdown-menu"</span><span class="nt">></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Action<span class="nt"></a></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Another action<span class="nt"></a></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Something else here<span class="nt"></a></li></span>
<span class="nt"><li</span> <span class="na">class=</span><span class="s">"divider"</span><span class="nt">></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Separated link<span class="nt"></a></li></span>
<span class="nt"></ul></span>
<span class="nt"></div></span><span class="c"><!-- /btn-group --></span>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"text"</span> <span class="na">class=</span><span class="s">"form-control"</span><span class="nt">></span>
<span class="nt"></div></span><span class="c"><!-- /input-group --></span>
</div><!-- /.col-lg-6 -->
<div class="col-lg-6"> <div class="input-group"> <input type="text" class="form-control">
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"input-group-btn"</span><span class="nt">></span>
<span class="nt"><button</span> <span class="na">type=</span><span class="s">"button"</span> <span class="na">class=</span><span class="s">"btn btn-default dropdown-toggle"</span> <span class="na">data-toggle=</span><span class="s">"dropdown"</span><span class="nt">></span>Action <span class="nt"><span</span> <span class="na">class=</span><span class="s">"caret"</span><span class="nt">></span></button></span>
<span class="nt"><ul</span> <span class="na">class=</span><span class="s">"dropdown-menu pull-right"</span><span class="nt">></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Action<span class="nt"></a></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Another action<span class="nt"></a></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Something else here<span class="nt"></a></li></span>
<span class="nt"><li</span> <span class="na">class=</span><span class="s">"divider"</span><span class="nt">></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Separated link<span class="nt"></a></li></span>
<span class="nt"></ul></span>
<span class="nt"></div></span><span class="c"><!-- /btn-group --></span>
<span class="nt"></div></span><span class="c"><!-- /input-group --></span>
</div><!-- /.col-lg-6 --> </div><!-- /.row -->
</div>
<div class="col-lg-6">
<div class="input-group">
<input type="text" class="form-control">
<div class="input-group-btn">
<button type="button" class="btn btn-default" tabindex="-1">Action</button>
<button type="button" class="btn btn-default dropdown-toggle" data-toggle="dropdown" tabindex="-1"> <span class="caret"></span> <span class="sr-only">Toggle Dropdown</span> </button>
<ul class="dropdown-menu pull-right" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</div>
</div>
</div>
</div>
</form>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"input-group"</span><span class="nt">></span>
<div class="input-group-btn">
<span class="c"><!-- Button and dropdown menu --></span>
</div> <input type="text" class="form-control"> </div>
<div class="input-group"> <input type="text" class="form-control"> <div class="input-group-btn">
<span class="c"><!-- Button and dropdown menu --></span>
</div> </div>
<h1 id="nav">Navs</h1>
<p class="lead">Navs available in Bootstrap have shared markup, starting with the base <code>.nav</code> class, as well as shared states. Swap modifier classes to switch between each style.</p>
<h2 id="nav-tabs">Tabs</h2>
<p>Note the <code>.nav-tabs</code> class requires the <code>.nav</code> base class.</p>
<div class="bs-example">
<ul class="nav nav-tabs">
<li class="active"><a href="#">Home</a></li>
<li><a href="#">Profile</a></li>
<li><a href="#">Messages</a></li>
</ul>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><ul</span> <span class="na">class=</span><span class="s">"nav nav-tabs"</span><span class="nt">></span>
<li class="active"><a href="#">Home</a></li>
<li><a href="#">Profile</a></li> <li><a href="#">Messages</a></li>
</ul>
For tabs with tabbable areas, you must use the tabs JavaScript plugin.
Take that same HTML, but use .nav-pills
instead:
<ul class="nav nav-pills">
<li class="active"><a href="#">Home</a></li>
<li><a href="#">Profile</a></li>
<li><a href="#">Messages</a></li>
</ul>
Pills are also vertically stackable. Just add .nav-stacked
.
<ul class="nav nav-pills nav-stacked">
...
</ul>
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.
Chrome and Safari both exhibit 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.
<ul class="nav nav-tabs nav-justified">
...
</ul>
<ul class="nav nav-pills nav-justified">
...
</ul>
For any nav component (tabs, pills, or list), add .disabled
for gray links and no hover effects.
This class will only change the <a>
's appearance, not its functionality. Use custom JavaScript to disable links here.
<ul class="nav nav-pills">
...
<li 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">
...
<li class="dropdown">
<span class="nt"><a</span> <span class="na">class=</span><span class="s">"dropdown-toggle"</span> <span class="na">data-toggle=</span><span class="s">"dropdown"</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>
Dropdown <span class="nt"><span</span> <span class="na">class=</span><span class="s">"caret"</span><span class="nt">></span></span>
<span class="nt"></a></span>
<span class="nt"><ul</span> <span class="na">class=</span><span class="s">"dropdown-menu"</span><span class="nt">></span>
...
<span class="nt"></ul></span>
</li>
...
</ul>
<div class="highlight">
<pre><code class="html"><span class="nt"><ul</span> <span class="na">class=</span><span class="s">"nav nav-pills"</span><span class="nt">></span>
... <li class="dropdown"> <a class="dropdown-toggle" data-toggle="dropdown" href="#">
Dropdown <span class="nt"><span</span> <span class="na">class=</span><span class="s">"caret"</span><span class="nt">></span></span>
<span class="nt"></a></span>
<span class="nt"><ul</span> <span class="na">class=</span><span class="s">"dropdown-menu"</span><span class="nt">></span>
...
<span class="nt"></ul></span>
</li> ... </ul>
<h1 id="navbar">Navbar</h1>
<h2 id="navbar-default">Default navbar</h2>
<p>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.</p>
<div class="bs-callout bs-callout-info">
<h4>Customize the collapsing point</h4>
<p>Depending on the content in your navbar, you might need to change the point at which your navbar switches between collapsed and horizontal mode. Customize the <code>@grid-float-breakpoint</code> variable or add your own media query.</p>
</div>
<div class="bs-callout bs-callout-danger">
<h4>Requires JavaScript</h4>
<p>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 <code>.navbar-collapse</code>.</p>
</div>
<div class="bs-example">
<nav class="navbar navbar-default" role="navigation">
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1"> <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>
<div class="collapse navbar-collapse" id="bs-example-navbar-collapse-1">
<ul class="nav navbar-nav">
<li class="active"><a href="#">Link</a></li>
<li><a href="#">Link</a></li>
<li class="dropdown"> <a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown <b class="caret"></b></a>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
<li class="divider"></li>
<li><a href="#">One more separated link</a></li>
</ul>
</li>
</ul>
<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>
<ul class="nav navbar-nav navbar-right">
<li><a href="#">Link</a></li>
<li class="dropdown"> <a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown <b class="caret"></b></a>
<ul class="dropdown-menu" role="menu">
<li><a href="#">Action</a></li>
<li><a href="#">Another action</a></li>
<li><a href="#">Something else here</a></li>
<li class="divider"></li>
<li><a href="#">Separated link</a></li>
</ul>
</li>
</ul>
</div>
</nav>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><nav</span> <span class="na">class=</span><span class="s">"navbar navbar-default"</span> <span class="na">role=</span><span class="s">"navigation"</span><span class="nt">></span>
<!-- Brand and toggle get grouped for better mobile display -->
<div class="navbar-header"> <button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-1">
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"sr-only"</span><span class="nt">></span>Toggle navigation<span class="nt"></span></span>
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"icon-bar"</span><span class="nt">></span></span>
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"icon-bar"</span><span class="nt">></span></span>
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"icon-bar"</span><span class="nt">></span></span>
<span class="nt"></button></span>
<span class="nt"><a</span> <span class="na">class=</span><span class="s">"navbar-brand"</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Brand<span class="nt"></a></span>
</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">
<span class="nt"><li</span> <span class="na">class=</span><span class="s">"active"</span><span class="nt">><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Link<span class="nt"></a></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Link<span class="nt"></a></li></span>
<span class="nt"><li</span> <span class="na">class=</span><span class="s">"dropdown"</span><span class="nt">></span>
<span class="nt"><a</span> <span class="na">href=</span><span class="s">"#"</span> <span class="na">class=</span><span class="s">"dropdown-toggle"</span> <span class="na">data-toggle=</span><span class="s">"dropdown"</span><span class="nt">></span>Dropdown <span class="nt"><b</span> <span class="na">class=</span><span class="s">"caret"</span><span class="nt">></b></a></span>
<span class="nt"><ul</span> <span class="na">class=</span><span class="s">"dropdown-menu"</span><span class="nt">></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Action<span class="nt"></a></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Another action<span class="nt"></a></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Something else here<span class="nt"></a></li></span>
<span class="nt"><li</span> <span class="na">class=</span><span class="s">"divider"</span><span class="nt">></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Separated link<span class="nt"></a></li></span>
<span class="nt"><li</span> <span class="na">class=</span><span class="s">"divider"</span><span class="nt">></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>One more separated link<span class="nt"></a></li></span>
<span class="nt"></ul></span>
<span class="nt"></li></span>
<span class="nt"></ul></span>
<span class="nt"><form</span> <span class="na">class=</span><span class="s">"navbar-form navbar-left"</span> <span class="na">role=</span><span class="s">"search"</span><span class="nt">></span>
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"form-group"</span><span class="nt">></span>
<span class="nt"><input</span> <span class="na">type=</span><span class="s">"text"</span> <span class="na">class=</span><span class="s">"form-control"</span> <span class="na">placeholder=</span><span class="s">"Search"</span><span class="nt">></span>
<span class="nt"></div></span>
<span class="nt"><button</span> <span class="na">type=</span><span class="s">"submit"</span> <span class="na">class=</span><span class="s">"btn btn-default"</span><span class="nt">></span>Submit<span class="nt"></button></span>
<span class="nt"></form></span>
<span class="nt"><ul</span> <span class="na">class=</span><span class="s">"nav navbar-nav navbar-right"</span><span class="nt">></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Link<span class="nt"></a></li></span>
<span class="nt"><li</span> <span class="na">class=</span><span class="s">"dropdown"</span><span class="nt">></span>
<span class="nt"><a</span> <span class="na">href=</span><span class="s">"#"</span> <span class="na">class=</span><span class="s">"dropdown-toggle"</span> <span class="na">data-toggle=</span><span class="s">"dropdown"</span><span class="nt">></span>Dropdown <span class="nt"><b</span> <span class="na">class=</span><span class="s">"caret"</span><span class="nt">></b></a></span>
<span class="nt"><ul</span> <span class="na">class=</span><span class="s">"dropdown-menu"</span><span class="nt">></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Action<span class="nt"></a></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Another action<span class="nt"></a></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Something else here<span class="nt"></a></li></span>
<span class="nt"><li</span> <span class="na">class=</span><span class="s">"divider"</span><span class="nt">></li></span>
<span class="nt"><li><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Separated link<span class="nt"></a></li></span>
<span class="nt"></ul></span>
<span class="nt"></li></span>
<span class="nt"></ul></span>
</div><!-- /.navbar-collapse --> </nav>
The responsive navbar requires the collapse plugin to be included in your version of Bootstrap.
Be sure to add a role="navigation"
to every navbar to help with accessibility.
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.
<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>
Screen readers will have trouble with your forms if you don't include a label for every input. For these inline navbar forms, you can hide the labels using the .sr-only
class.
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>
Like the standard button classes, .navbar-btn
can be used on <a>
and <input>
elements. However, neither .navbar-btn
nor the standard button classes should be used on <a>
elements within .navbar-nav
.
Wrap strings of text in an element with .navbar-text
, usually on a <p>
tag for proper leading and color.
Signed in as Mark Otto
<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
.
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-6"> <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>
<div class="collapse navbar-collapse" id="bs-example-navbar-collapse-6">
<ul class="nav navbar-nav">
<li class="active"><a href="#">Home</a></li>
<li><a href="#">Link</a></li>
<li><a href="#">Link</a></li>
</ul>
</div>
</nav>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><nav</span> <span class="na">class=</span><span class="s">"navbar navbar-default navbar-fixed-top"</span> <span class="na">role=</span><span class="s">"navigation"</span><span class="nt">></span>
... </nav>
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.
body { padding-top: 70px; }
Make sure to include this after the core Bootstrap CSS.
Add .navbar-fixed-bottom
instead.
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-7"> <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>
<div class="collapse navbar-collapse" id="bs-example-navbar-collapse-7">
<ul class="nav navbar-nav">
<li class="active"><a href="#">Home</a></li>
<li><a href="#">Link</a></li>
<li><a href="#">Link</a></li>
</ul>
</div>
</nav>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><nav</span> <span class="na">class=</span><span class="s">"navbar navbar-default navbar-fixed-bottom"</span> <span class="na">role=</span><span class="s">"navigation"</span><span class="nt">></span>
... </nav>
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.
body { padding-bottom: 70px; }
Make sure to include this after the core Bootstrap CSS.
Create a full-width navbar that scrolls away with the page by adding .navbar-static-top
. Unlike the .navbar-fixed-*
classes, you do not need to change any padding on the body
.
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-8"> <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>
<div class="collapse navbar-collapse" id="bs-example-navbar-collapse-8">
<ul class="nav navbar-nav">
<li class="active"><a href="#">Home</a></li>
<li><a href="#">Link</a></li>
<li><a href="#">Link</a></li>
</ul>
</div>
</nav>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><nav</span> <span class="na">class=</span><span class="s">"navbar navbar-default navbar-static-top"</span> <span class="na">role=</span><span class="s">"navigation"</span><span class="nt">></span>
... </nav>
Modify the look of the navbar by adding .navbar-inverse
.
<div class="navbar-header">
<button type="button" class="navbar-toggle" data-toggle="collapse" data-target="#bs-example-navbar-collapse-9"> <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>
<div class="collapse navbar-collapse" id="bs-example-navbar-collapse-9">
<ul class="nav navbar-nav">
<li class="active"><a href="#">Home</a></li>
<li><a href="#">Link</a></li>
<li><a href="#">Link</a></li>
</ul>
</div>
</nav>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><nav</span> <span class="na">class=</span><span class="s">"navbar navbar-inverse"</span> <span class="na">role=</span><span class="s">"navigation"</span><span class="nt">></span>
... </nav>
<h1 id="breadcrumbs">Breadcrumbs <small></small></h1>
<p class="lead">Indicate the current page's location within a navigational hierarchy.</p>
<p>Separators are automatically added in CSS through <code>:before</code> and <code>content</code>.</p>
<div class="bs-example">
<ol class="breadcrumb">
<li class="active">Home</li>
</ol>
<ol class="breadcrumb">
<li><a href="#">Home</a></li>
<li class="active">Library</li>
</ol>
<ol class="breadcrumb" style="margin-bottom: 5px;">
<li><a href="#">Home</a></li>
<li><a href="#">Library</a></li>
<li class="active">Data</li>
</ol>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><ol</span> <span class="na">class=</span><span class="s">"breadcrumb"</span><span class="nt">></span>
<li><a href="#">Home</a></li> <li><a href="#">Library</a></li>
<li class="active">Data</li> </ol>
<h1 id="pagination">Pagination</h1>
<p class="lead">Provide pagination links for your site or app with the multi-page pagination component, or the simpler <a href="#pagination-pager">pager alternative</a>.</p>
<h2 id="pagination-default">Default pagination</h2>
<p>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.</p>
<div class="bs-example">
<ul class="pagination">
<li><a href="#">«</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="#">»</a></li>
</ul>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><ul</span> <span class="na">class=</span><span class="s">"pagination"</span><span class="nt">></span>
<li><a href="#">«</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="#">»</a></li> </ul>
Links are customizable for different circumstances. Use .disabled
for unclickable links and .active
to indicate the current page.
<ul class="pagination">
<li class="disabled"><a href="#">«</a></li>
<li class="active"><a href="#">1 <span class="sr-only">(current)</span></a></li>
...
</ul>
You can optionally swap out active or disabled anchors for <span>
to remove click functionality while retaining intended styles.
<ul class="pagination">
<li class="disabled"><span>«</span></li>
<li class="active"><span>1 <span class="sr-only">(current)</span></span></li>
...
</ul>
Fancy larger or smaller pagination? Add .pagination-lg
or .pagination-sm
for additional sizes.
<ul class="pagination pagination-lg">...</ul>
<ul class="pagination">...</ul>
<ul class="pagination pagination-sm">...</ul>
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.
<ul class="pager">
<li><a href="#">Previous</a></li>
<li><a href="#">Next</a></li>
</ul>
Alternatively, you can align each link to the sides:
<ul class="pager">
<li class="previous"><a href="#">← Older</a></li>
<li class="next"><a href="#">Newer →</a></li>
</ul>
Pager links also use the general .disabled
utility class from the pagination.
<ul class="pager">
<li class="previous disabled"><a href="#">← Older</a></li>
<li class="next"><a href="#">Newer →</a></li>
</ul>
<h1 id="labels">Labels</h1>
<p class="lead"></p>
<h3>Example</h3>
<div class="bs-example">
<h1>Example heading <span class="label label-default">New</span></h1>
<h2>Example heading <span class="label label-default">New</span></h2>
<h3>Example heading <span class="label label-default">New</span></h3>
<h4>Example heading <span class="label label-default">New</span></h4>
<h5>Example heading <span class="label label-default">New</span></h5>
<h6>Example heading <span class="label label-default">New</span></h6>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><h3></span>Example heading <span class="nt"><span</span> <span class="na">class=</span><span class="s">"label label-default"</span><span class="nt">></span>New<span class="nt"></span></h3></span>
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-primary">Primary</span>
<span class="label label-success">Success</span>
<span class="label label-info">Info</span>
<span class="label label-warning">Warning</span>
<span class="label label-danger">Danger</span>
<h1 id="badges">Badges</h1>
<p class="lead">Easily highlight new or unread items by adding a <code><span class="badge"></code> to links, Bootstrap navs, and more.</p>
<div class="bs-example"> <a href="#">Inbox <span class="badge">42</span></a> </div>
<div class="highlight">
<pre><code class="html"><span class="nt"><a</span> <span class="na">href=</span><span class="s">"#"</span><span class="nt">></span>Inbox <span class="nt"><span</span> <span class="na">class=</span><span class="s">"badge"</span><span class="nt">></span>42<span class="nt"></span></a></span>
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 and list navigations.
<ul class="nav nav-pills nav-stacked">
<li class="active">
<a href="#">
<span class="badge pull-right">42</span>
Home
<span class="nt"></a></span>
</li>
...
</ul>
<h1 id="jumbotron">Jumbotron</h1>
<p>A lightweight, flexible component that can optionally extend the entire viewport to showcase key content on your site.</p>
<div class="bs-example">
<div class="jumbotron">
<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-primary btn-lg" role="button">Learn more</a></p>
</div>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"jumbotron"</span><span class="nt">></span>
<h1>Hello, world!</h1> <p>...</p> <p><a class="btn btn-primary btn-lg" role="button">Learn more</a></p>
</div>
To make the jumbotron full width, and without rounded corners, place it outside all .container
s and instead add a .container
within.
<div class="jumbotron">
<div class="container">
...
</div>
</div>
<h1 id="page-header">Page header</h1>
<p>A simple shell for an <code>h1</code> to appropriately space out and segment sections of content on a page. It can utilize the <code>h1</code>'s default <code>small</code> element, as well as most other components (with additional styles).</p>
<div class="bs-example">
<h1>Example page header <small>Subtext for header</small></h1>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"page-header"</span><span class="nt">></span>
<h1>Example page header <small>Subtext for header</small></h1> </div>
<h1 id="thumbnails">Thumbnails</h1>
<p class="lead">Extend Bootstrap's <a href="css/#grid">grid system</a> with the thumbnail component to easily display grids of images, videos, text, and more.</p>
<h3 id="thumbnails-default">Default example</h3>
<p>By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.</p>
<div class="bs-example">
<div class="row">
<div class="col-sm-6 col-md-3"> <a href="#" class="thumbnail"> <img data-src="holder.js/100%x180" alt="Generic placeholder thumbnail"> </a> </div>
<div class="col-sm-6 col-md-3"> <a href="#" class="thumbnail"> <img data-src="holder.js/100%x180" alt="Generic placeholder thumbnail"> </a> </div>
<div class="col-sm-6 col-md-3"> <a href="#" class="thumbnail"> <img data-src="holder.js/100%x180" alt="Generic placeholder thumbnail"> </a> </div>
<div class="col-sm-6 col-md-3"> <a href="#" class="thumbnail"> <img data-src="holder.js/100%x180" alt="Generic placeholder thumbnail"> </a> </div>
</div>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"row"</span><span class="nt">></span>
<div class="col-sm-6 col-md-3"> <a href="#" class="thumbnail"> <img data-src="holder.js/100%x180" alt="...">
<span class="nt"></a></span>
</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="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"row"</span><span class="nt">></span>
<div class="col-sm-6 col-md-4">
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"thumbnail"</span><span class="nt">></span>
<span class="nt"><img</span> <span class="na">data-src=</span><span class="s">"holder.js/300x200"</span> <span class="na">alt=</span><span class="s">"..."</span><span class="nt">></span>
<span class="nt"><div</span> <span class="na">class=</span><span class="s">"caption"</span><span class="nt">></span>
<span class="nt"><h3></span>Thumbnail label<span class="nt"></h3></span>
<span class="nt"><p></span>...<span class="nt"></p></span>
<span class="nt"><p><a</span> <span class="na">href=</span><span class="s">"#"</span> <span class="na">class=</span><span class="s">"btn btn-primary"</span> <span class="na">role=</span><span class="s">"button"</span><span class="nt">></span>Button<span class="nt"></a></span> <span class="nt"><a</span> <span class="na">href=</span><span class="s">"#"</span> <span class="na">class=</span><span class="s">"btn btn-default"</span> <span class="na">role=</span><span class="s">"button"</span><span class="nt">></span>Button<span class="nt"></a></p></span>
<span class="nt"></div></span>
<span class="nt"></div></span>
</div> </div>
<h1 id="alerts">Alerts</h1>
<p class="lead">Provide contextual feedback messages for typical user actions with the handful of available and flexible alert messages. For inline dismissal, use the <a href="javascript/#alerts">alerts jQuery plugin</a>.</p>
<h2 id="alerts-examples">Examples</h2>
<p>Wrap any text and an optional dismiss button in <code>.alert</code> and one of the four contextual classes (e.g., <code>.alert-success</code>) for basic alert messages.</p>
<div class="bs-callout bs-callout-info">
<h4>No default class</h4>
<p>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.</p>
</div>
<div class="bs-example">
<div class="alert alert-success"> <strong>Well done!</strong> You successfully read this important alert message. </div>
<div class="alert alert-info"> <strong>Heads up!</strong> This alert needs your attention, but it's not super important. </div>
<div class="alert alert-warning"> <strong>Warning!</strong> Best check yo self, you're not looking too good. </div>
<div class="alert alert-danger"> <strong>Oh snap!</strong> Change a few things up and try submitting again. </div>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"alert alert-success"</span><span class="nt">></span>...<span class="nt"></div></span>
<div class="alert alert-info">...</div> <div class="alert alert-warning">...</div>
<div class="alert alert-danger">...</div>
Build on any alert by adding an optional .alert-dismissable
and close button.
<div class="alert alert-warning alert-dismissable">
<button type="button" class="close" data-dismiss="alert" aria-hidden="true">×</button>
<strong>Warning!</strong> Best check yo self, 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">
<a href="#" class="alert-link">...</a>
</div>
<div class="alert alert-info">
<a href="#" class="alert-link">...</a>
</div>
<div class="alert alert-warning">
<a href="#" class="alert-link">...</a>
</div>
<div class="alert alert-danger">
<a href="#" class="alert-link">...</a>
</div>
<h1 id="progress">Progress bars</h1>
<p class="lead">Provide up-to-date feedback on the progress of a workflow or action with simple yet flexible progress bars.</p>
<div class="bs-callout bs-callout-danger">
<h4>Cross-browser compatibility</h4>
<p>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.</p>
</div>
<h3 id="progress-basic">Basic example</h3>
<p>Default progress bar.</p>
<div class="bs-example">
<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>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"progress"</span><span class="nt">></span>
<div class="progress-bar" role="progressbar" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100" style="width: 60%;">
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"sr-only"</span><span class="nt">></span>60% Complete<span class="nt"></span></span>
</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="nt"><span</span> <span class="na">class=</span><span class="s">"sr-only"</span><span class="nt">></span>40% Complete (success)<span class="nt"></span></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="nt"><span</span> <span class="na">class=</span><span class="s">"sr-only"</span><span class="nt">></span>20% Complete<span class="nt"></span></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="nt"><span</span> <span class="na">class=</span><span class="s">"sr-only"</span><span class="nt">></span>60% Complete (warning)<span class="nt"></span></span>
</div>
</div>
<div class="progress">
<div class="progress-bar progress-bar-danger" role="progressbar" aria-valuenow="80" aria-valuemin="0" aria-valuemax="100" style="width: 80%">
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"sr-only"</span><span class="nt">></span>80% Complete<span class="nt"></span></span>
</div>
</div>
Uses a gradient to create a striped effect. Not available in IE8.
<div class="progress progress-striped">
<div class="progress-bar progress-bar-success" role="progressbar" aria-valuenow="40" aria-valuemin="0" aria-valuemax="100" style="width: 40%">
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"sr-only"</span><span class="nt">></span>40% Complete (success)<span class="nt"></span></span>
</div>
</div>
<div class="progress progress-striped">
<div class="progress-bar progress-bar-info" role="progressbar" aria-valuenow="20" aria-valuemin="0" aria-valuemax="100" style="width: 20%">
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"sr-only"</span><span class="nt">></span>20% Complete<span class="nt"></span></span>
</div>
</div>
<div class="progress progress-striped">
<div class="progress-bar progress-bar-warning" role="progressbar" aria-valuenow="60" aria-valuemin="0" aria-valuemax="100" style="width: 60%">
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"sr-only"</span><span class="nt">></span>60% Complete (warning)<span class="nt"></span></span>
</div>
</div>
<div class="progress progress-striped">
<div class="progress-bar progress-bar-danger" role="progressbar" aria-valuenow="80" aria-valuemin="0" aria-valuemax="100" style="width: 80%">
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"sr-only"</span><span class="nt">></span>80% Complete (danger)<span class="nt"></span></span>
</div>
</div>
Add .active
to .progress-striped
to animate the stripes right to left. Not available in all versions of IE.
<div class="progress progress-striped active">
<div class="progress-bar" role="progressbar" aria-valuenow="45" aria-valuemin="0" aria-valuemax="100" style="width: 45%">
<span class="nt"><span</span> <span class="na">class=</span><span class="s">"sr-only"</span><span class="nt">></span>45% Complete<span class="nt"></span></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" 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>
<h1 id="media">Media object</h1>
<p class="lead">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.</p>
<h3 id="media-default">Default media</h3>
<p>The default media allow to float a media object (images, video, audio) to the left or right of a content block.</p>
<div class="bs-example">
<div class="media"> <a class="pull-left" href="#"> <img class="media-object" data-src="holder.js/64x64" alt="Generic placeholder image"> </a>
<div class="media-body">
<h4 class="media-heading">Media heading</h4>
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. </div>
</div>
<div class="media"> <a class="pull-left" href="#"> <img class="media-object" data-src="holder.js/64x64" alt="Generic placeholder image"> </a>
<div class="media-body">
<h4 class="media-heading">Media heading</h4>
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.
<div class="media"> <a class="pull-left" href="#"> <img class="media-object" data-src="holder.js/64x64" alt="Generic placeholder image"> </a>
<div class="media-body">
<h4 class="media-heading">Media heading</h4>
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. </div>
</div>
</div>
</div>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"media"</span><span class="nt">></span>
<a class="pull-left" href="#"> <img class="media-object" src="..." alt="...">
</a> <div class="media-body"> <h4 class="media-heading">Media heading</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.
<div class="media"> <a class="pull-left" href="#"> <img class="media-object" data-src="holder.js/64x64" alt="Generic placeholder image"> </a> <div class="media-body"> <h4 class="media-heading">Nested media heading</h4> 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. <div class="media"> <a class="pull-left" href="#"> <img class="media-object" data-src="holder.js/64x64" alt="Generic placeholder image"> </a> <div class="media-body"> <h4 class="media-heading">Nested media heading</h4> 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. </div> </div> </div> </div> <div class="media"> <a class="pull-left" href="#"> <img class="media-object" data-src="holder.js/64x64" alt="Generic placeholder image"> </a> <div class="media-body"> <h4 class="media-heading">Nested media heading</h4> 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. </div> </div> </div> </li> <li class="media"> <a class="pull-right" href="#"> <img class="media-object" data-src="holder.js/64x64" alt="Generic placeholder image"> </a> <div class="media-body"> <h4 class="media-heading">Media heading</h4> 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. </div> </li> </ul> </div> <div class="highlight"> <pre><code class="html"><span class="nt"><ul</span> <span class="na">class=</span><span class="s">"media-list"</span><span class="nt">></span>
<li class="media"> <a class="pull-left" href="#"> <img class="media-object" src="..." alt="...">
<span class="nt"></a></span> <span class="nt"><div</span> <span class="na">class=</span><span class="s">"media-body"</span><span class="nt">></span> <span class="nt"><h4</span> <span class="na">class=</span><span class="s">"media-heading"</span><span class="nt">></span>Media heading<span class="nt"></h4></span> ... <span class="nt"></div></span>
</li> </ul>
<h1 id="list-group">List group</h1> <p class="lead">List groups are a flexible and powerful component for displaying not only simple lists of elements, but complex ones with custom content.</p> <h3 id="list-group-basic">Basic example</h3> <p>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.</p> <div class="bs-example"> <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> <div class="highlight"> <pre><code class="html"><span class="nt"><ul</span> <span class="na">class=</span><span class="s">"list-group"</span><span class="nt">></span>
<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.
- 14 Cras justo odio
- 2 Dapibus ac facilisis in
- 1 Morbi leo risus
<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>
Add nearly any HTML within, even for linked list groups like the one below.
<div class="list-group">
<a href="#" class="list-group-item active">
<h4 class="list-group-item-heading">List group item heading</h4>
<span class="nt"><p</span> <span class="na">class=</span><span class="s">"list-group-item-text"</span><span class="nt">></span>...<span class="nt"></p></span>
</a>
</div>
<h1 id="panels">Panels</h1>
<p class="lead">While not always necessary, sometimes you need to put your DOM in a box. For those situations, try the panel component.</p>
<h3 id="panels-basic">Basic example</h3>
<p>By default, all the <code>.panel</code> does is apply some basic border and padding to contain some content.</p>
<div class="bs-example">
<div class="panel panel-default">
<div class="panel-body"> Basic panel example </div>
</div>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"panel panel-default"</span><span class="nt">></span>
<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.
<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.
<div class="panel-heading">Panel heading</div>
<div class="panel-body">
<p>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.</p>
</div>
<table class="table">
<thead>
<tr>
<th>#</th>
<th>First Name</th>
<th>Last Name</th>
<th>Username</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>Mark</td>
<td>Otto</td>
<td>@mdo</td>
</tr>
<tr>
<td>2</td>
<td>Jacob</td>
<td>Thornton</td>
<td>@fat</td>
</tr>
<tr>
<td>3</td>
<td>Larry</td>
<td>the Bird</td>
<td>@twitter</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"panel panel-default"</span><span class="nt">></span>
<!-- 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.
<div class="panel-heading">Panel heading</div>
<table class="table">
<thead>
<tr>
<th>#</th>
<th>First Name</th>
<th>Last Name</th>
<th>Username</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>Mark</td>
<td>Otto</td>
<td>@mdo</td>
</tr>
<tr>
<td>2</td>
<td>Jacob</td>
<td>Thornton</td>
<td>@fat</td>
</tr>
<tr>
<td>3</td>
<td>Larry</td>
<td>the Bird</td>
<td>@twitter</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"panel panel-default"</span><span class="nt">></span>
<!-- 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.
<div class="panel-heading">Panel heading</div>
<div class="panel-body">
<p>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.</p>
</div>
<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>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"panel panel-default"</span><span class="nt">></span>
<!-- 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>
<span class="nt"><li</span> <span class="na">class=</span><span class="s">"list-group-item"</span><span class="nt">></span>Morbi leo risus<span class="nt"></li></span>
<span class="nt"><li</span> <span class="na">class=</span><span class="s">"list-group-item"</span><span class="nt">></span>Porta ac consectetur ac<span class="nt"></li></span>
<span class="nt"><li</span> <span class="na">class=</span><span class="s">"list-group-item"</span><span class="nt">></span>Vestibulum at eros<span class="nt"></li></span>
</ul> </div>
<h1 id="wells">Wells</h1>
<h3>Default well</h3>
<p>Use the well as a simple effect on an element to give it an inset effect.</p>
<div class="bs-example">
<div class="well"> Look, I'm in a well! </div>
</div>
<div class="highlight">
<pre><code class="html"><span class="nt"><div</span> <span class="na">class=</span><span class="s">"well"</span><span class="nt">></span>...<span class="nt"></div></span>
Control padding and rounded corners with two optional modifier classes.
<div class="well well-lg">...</div>
<div class="well well-sm">...</div>