<h1>Button groups <small>Join buttons for more toolbar-like functionality</small></h1>
</div>
<divclass="row">
<divclass="span4">
<h3>Button groups</h3>
<p>Use button groups to join multiple buttons together as one composite component. Build them with a series of <code><a></code> or <code><button></code> elements.</p>
<h3>Best practices</h3>
<p>We recommend the following guidelines for using button groups and toolbars:</p>
<ul>
<li>Always use the same element in a single button group, <code><a></code> or <code><button></code>.</li>
<li>Don't mix buttons of different colors in the same button group.</li>
<li>Use icons in addition to or instead of text, but be sure include alt and title text where appropriate.</li>
</ul>
<p><spanclass="label label-info">Related</span> Button groups with dropdowns (see below) should be called out separately and always include a dropdown caret to indicate intended behavior.</p>
</div>
<divclass="span4">
<h3>Default example</h3>
<p>Here's how the HTML looks for a standard button group built with anchor tag buttons:</p>
<divclass="">
<divclass="btn-group"style="margin: 9px 0;">
<buttonclass="btn">Left</button>
<buttonclass="btn">Middle</button>
<buttonclass="btn">Right</button>
</div>
</div>
<preclass="prettyprint linenums">
<div class="btn-group">
<button class="btn">1</button>
<button class="btn">2</button>
<button class="btn">3</button>
</div>
</pre>
<h3>Toolbar example</h3>
<p>Combine sets of <code><div class="btn-group"></code> into a <code><div class="btn-toolbar"></code> for more complex components.</p>
<divclass="btn-toolbar">
<divclass="btn-group">
<buttonclass="btn">1</button>
<buttonclass="btn">2</button>
<buttonclass="btn">3</button>
<buttonclass="btn">4</button>
</div>
<divclass="btn-group">
<buttonclass="btn">5</button>
<buttonclass="btn">6</button>
<buttonclass="btn">7</button>
</div>
<divclass="btn-group">
<buttonclass="btn">8</button>
</div>
</div>
<preclass="prettyprint linenums">
<div class="btn-toolbar">
<div class="btn-group">
...
</div>
</div>
</pre>
</div>
<divclass="span4">
<h3>Checkbox and radio flavors</h3>
<p>Button groups can also function as radios, where only one button may be active, or checkboxes, where any number of buttons may be active. View <ahref="./javascript.html#buttons">the Javascript docs</a> for that.</p>
<p><aclass="btn js-btn"href="./javascript.html#buttons">Get the javascript »</a></p>
<h3>Dropdowns in button groups</h3>
<p><spanclass="label label-info">Heads up!</span> Buttons with dropdowns must be individually wrapped in their own <code>.btn-group</code> within a <code>.btn-toolbar</code> for proper rendering.</p>
<p>Similar to a button group, our markup uses regular button markup, but with a handful of additions to refine the style and support Bootstrap's dropdown jQuery plugin.</p>
<p>Button dropdowns require the <ahref="./javascript.html#dropdowns">Bootstrap dropdown plugin</a> to function.</p>
<p>In some cases—like mobile—dropdown menus will extend outside the viewport. You need to resolve the alignment manually or with custom javascript.</p>
</div><!--/span-->
</div><!--/row-->
<br>
<h2>Split button dropdowns</h2>
<divclass="row">
<divclass="span4">
<h3>Overview and examples</h3>
<p>Building on the button group styles and markup, we can easily create a split button. Split buttons feature a standard action on the left and a dropdown toggle on the right with contextual links.</p>
<p>Dropdown menus can also be toggled from the bottom up by adding a single class to the immediate parent of <code>.dropdown-menu</code>. It will flip the direction of the <code>.caret</code> and reposition the menu itself to move from the bottom up instead of top down.</p>
<h1>Nav, tabs, and pills <small>Highly customizable list-style navigation</small></h1>
</div>
<h2>Lightweight defaults <small>Same markup, different classes</small></h2>
<divclass="row">
<divclass="span4">
<h3>Powerful base class</h3>
<p>All nav components here—tabs, pills, and lists—<strong>share the same base markup and styles</strong> through the <code>.nav</code> class.</p>
<h3>When to use</h3>
<p>Tabs and pills are great for sections of content or navigating between pages of related content.</p>
<h3>Component alignment</h3>
<p>To align nav links, use the <code>.pull-left</code> or <code>.pull-right</code> utility classes. Both classes will add a CSS float in the specified direction.</p>
</div>
<divclass="span4">
<h3>Basic tabs</h3>
<p>Take a regular <code><ul></code> of links and add <code>.nav-tabs</code>:</p>
<h2>Nav lists <small>Build simple stacked navs, great for sidebars</small></h2>
<divclass="row">
<divclass="span4">
<h3>Application-style navigation</h3>
<p>Nav lists provide a simple and easy way to build groups of nav links with optional headers. They're best used in sidebars like the Finder in OS X.</p>
<p>Structurally, they're built on the same core nav styles as tabs and pills, so usage and customization are straightforward.</p>
<hr>
<h4>With icons</h4>
<p>Nav lists are also easy to equip with icons. Add the proper <code><i></code> tag with class and you're set.</p>
<h4>Horizontal dividers</h4>
<p>Add a horizontal divider by creating an empty list item with the class <code>.divider</code>, like so:</p>
<preclass="prettyprint linenums">
<ul class="nav nav-list">
...
<li class="divider"></li>
...
</ul>
</pre>
</div>
<divclass="span4">
<h3>Example nav list</h3>
<p>Take a list of links and add <code>class="nav nav-list"</code>:</p>
<divclass="well"style="padding: 8px 0;">
<ulclass="nav nav-list">
<liclass="nav-header">List header</li>
<liclass="active"><ahref="#">Home</a></li>
<li><ahref="#">Library</a></li>
<li><ahref="#">Applications</a></li>
<liclass="nav-header">Another list header</li>
<li><ahref="#">Profile</a></li>
<li><ahref="#">Settings</a></li>
<liclass="divider"></li>
<li><ahref="#">Help</a></li>
</ul>
</div><!-- /well -->
<preclass="prettyprint linenums">
<ul class="nav nav-list">
<li class="nav-header">
List header
</li>
<li class="active">
<a href="#">Home</a>
</li>
<li>
<a href="#">Library</a>
</li>
...
</ul>
</pre>
</div>
<divclass="span4">
<h3>Example with icons</h3>
<p>Same example, but with <code><i></code> tags for icons.</p>
<h2>Tabbable nav <small>Bring tabs to life via javascript</small></h2>
<divclass="row">
<divclass="span4">
<h3>What's included</h3>
<p>Bring your tabs to life with a simple plugin to toggle between content via tabs. Bootstrap integrates tabbable tabs in four styles: top (default), right, bottom, and left.</p>
<p>Changing between them is easy and only requires changing very little markup.</p>
</div>
<divclass="span4">
<h3>Tabbable example</h3>
<p>To make tabs tabbable, wrap the <code>.nav-tabs</code> in another div with class <code>.tabbable</code>.</p>
<p>The navbar requires only a few divs to structure it well for static or fixed display.</p>
<preclass="prettyprint linenums">
<div class="navbar">
<div class="navbar-inner">
<div class="container">
...
</div>
</div>
</div>
</pre>
<h3>Fixed navbar</h3>
<p>Fix the navbar to the top or bottom of the viewport with an additional class on the outermost div, <code>.navbar</code>.</p>
<divclass="row">
<divclass="span4">
<preclass="prettyprint linenums">
<div class="navbar navbar-fixed-top">
...
</div>
</pre>
</div><!--/span-->
<divclass="span4">
<preclass="prettyprint linenums">
<div class="navbar navbar-fixed-bottom">
...
</div>
</pre>
</div><!--/span-->
</div><!--/row-->
<p>When you affix the navbar, remember to account for the hidden area underneath. Add 40px or more of apdding to the <code><body></code>. Be sure to add this after the core Bootstrap CSS and before the optional responsive CSS.</p>
<h3>Brand name</h3>
<p>A simple link to show your brand or project name only requires an anchor tag.</p>
<preclass="prettyprint linenums">
<a class="brand" href="#">
Project name
</a>
</pre>
<h3>Forms in navbar</h3>
<p>To properly style and position a form within the navbar, add the appropriate classes as shown below. For a default form, include <code>.navbar-form</code> and either <code>.pull-left</code> or <code>.pull-right</code> to properly align it.</p>
<preclass="prettyprint linenums">
<form class="navbar-form pull-left">
<input type="text" class="span2">
</form>
</pre>
<p>For a more customized search form, add the <code>.navbar-search</code> class to receive specialized styles in the navbar.</p>
<p>Depending on the amount of content in your topbar, you might want to implement the responsive options. To do so, wrap your nav content in a containing div, <code>.nav-collapse.collapse</code>, and add the navbar toggle button, <code>.btn-navbar</code>.</p>
<preclass="prettyprint linenums">
<div class="navbar">
<div class="navbar-inner">
<div class="container">
<!-- .btn-navbar is used as the toggle for collapsed navbar content -->
<p>You can easily add dividers to your nav links with an empty list item and a simple class. Just add this between links:</p>
<preclass="prettyprint linenums">
<ul class="nav">
...
<li class="divider-vertical"></li>
...
</ul>
</pre>
<h3>Component alignment</h3>
<p>To align a nav, search form, or text, use the <code>.pull-left</code> or <code>.pull-right</code> utility classes. Both classes will add a CSS float in the specified direction.</p>
<p>Adding dropdowns and dropups to the nav is super simple, but does require the use of <ahref="./javascript.html#dropdown">our javascript plugin</a>.</p>
<p>Breadcrumb navigation is used as a way to show users where they are within an app or a site, but not for primary navigation. Keep their use sparse and succinct to be most effective.</p>
<h3>Examples</h3>
<p>A single example shown as it might be displayed across multiple pages.</p>
<h1>Pagination <small>Two options for paging through content</small></h1>
</div>
<h2>Multicon-page pagination</h2>
<divclass="row">
<divclass="span4">
<h3>When to use</h3>
<p>Ultra simplistic and minimally styled 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>
<h3>Stateful page links</h3>
<p>Links are customizable and work in a number of circumstances with the right class. <code>.disabled</code> for unclickable links and <code>.active</code> for current page.</p>
<h3>Flexible alignment</h3>
<p>Add either of two optional classes to change the alignment of pagination links: <code>.pagination-centered</code> and <code>.pagination-right</code>.</p>
</div>
<divclass="span4">
<h3>Examples</h3>
<p>The default pagination component is flexible and works in a number of variations.</p>
<divclass="pagination">
<ul>
<liclass="disabled"><ahref="#">«</a></li>
<liclass="active"><ahref="#">1</a></li>
<li><ahref="#">2</a></li>
<li><ahref="#">3</a></li>
<li><ahref="#">4</a></li>
<li><ahref="#">»</a></li>
</ul>
</div>
<divclass="pagination">
<ul>
<li><ahref="#">«</a></li>
<li><ahref="#">10</a></li>
<liclass="active"><ahref="#">11</a></li>
<li><ahref="#">12</a></li>
<li><ahref="#">»</a></li>
</ul>
</div>
<divclass="pagination">
<ul>
<li><ahref="#">←</a></li>
<liclass="active"><ahref="#">10</a></li>
<liclass="disabled"><ahref="#">...</a></li>
<li><ahref="#">20</a></li>
<li><ahref="#">→</a></li>
</ul>
</div>
<divclass="pagination pagination-centered">
<ul>
<liclass="active"><ahref="#">1</a></li>
<li><ahref="#">2</a></li>
<li><ahref="#">3</a></li>
<li><ahref="#">4</a></li>
<li><ahref="#">5</a></li>
</ul>
</div>
</div>
<divclass="span4">
<h3>Markup</h3>
<p>Wrapped in a <code><div></code>, pagination is just a <code><ul></code>.</p>
<h2>Pager <small>For quick previous and next links</small></h2>
<divclass="row">
<divclass="span4">
<h3>About pager</h3>
<p>The pager component is a set of links for simple pagination implementations with light markup and even lighter styles. It's great for simple sites like blogs or magazines.</p>
<h4>Optional disabled state</h4>
<p>Pager links also use the general <code>.disabled</code> class from the pagination.</p>
</div>
<divclass="span4">
<h3>Default example</h3>
<p>By default, the pager centers links.</p>
<ulclass="pager">
<li><ahref="#">Previous</a></li>
<li><ahref="#">Next</a></li>
</ul>
<preclass="prettyprint linenums">
<ul class="pager">
<li>
<a href="#">Previous</a>
</li>
<li>
<a href="#">Next</a>
</li>
</ul>
</pre>
</div>
<divclass="span4">
<h3>Aligned links</h3>
<p>Alternatively, you can align each link to the sides:</p>
<h1>Badges <small>Indicators and unread counts</small></h1>
</div>
<divclass="row">
<divclass="span4">
<h3>About</h3>
<p>Badges are small, simple components for displaying an indicator or count of some sort. They're commonly found in email clients like Mail.app or on mobile apps for push notifications.</p>
<h1>Typographic components <small>Page header and hero unit for segmenting content</small></h1>
</div>
<h2>Hero unit</h2>
<divclass="row">
<divclass="span4">
<p>Bootstrap provides a lightweight, flexible component called a hero unit to showcase content on your site. It works well on marketing and content-heavy sites.</p>
<h3>Markup</h3>
<p>Wrap your content in a <code>div</code> like so:</p>
<preclass="prettyprint linenums">
<div class="hero-unit">
<h1>Heading</h1>
<p>Tagline</p>
<p>
<a class="btn btn-primary btn-large">
Learn more
</a>
</p>
</div>
</pre>
</div>
<divclass="span8">
<divclass="hero-unit">
<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 simple shell for an <code>h1</code> to appropratiely 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 most other components (with additional styles).</p>
</div>
<divclass="span8">
<divclass="page-header">
<h1>Example page header <small>Subtext for header</small></h1>
<p>Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.</p>
<p>Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.</p>
<p>Thumbnails (previously <code>.media-grid</code> up until v1.4) are great for grids of photos or videos, image search results, retail products, portfolios, and much more. They can be links or static content.</p>
</div>
<divclass="span4">
<h3>Simple, flexible markup</h3>
<p>Thumbnail markup is simple—a <code>ul</code> with any number of <code>li</code> elements is all that is required. It's also super flexible, allowing for any type of content with just a bit more markup to wrap your contents.</p>
</div>
<divclass="span4">
<h3>Uses grid column sizes</h3>
<p>Lastly, the thumbnails component uses existing grid system classes—like <code>.span2</code> or <code>.span3</code>—for control of thumbnail dimensions.</p>
</div>
</div>
<divclass="row">
<divclass="span6">
<h2>The markup</h2>
<p>As mentioned previously, the required markup for thumbnails is light and straightforward. Here's a look at the default setup <strong>for linked images</strong>:</p>
<p>For custom HTML content in thumbnails, the markup changes slightly. To allow block level content anywhere, we swap the <code><a></code> for a <code><div></code> like so:</p>
<h1>Alerts <small>Styles for success, warning, and error messages</small></h1>
</div>
<h2>Lightweight defaults</h2>
<divclass="row">
<divclass="span4">
<h3>Rewritten base class</h3>
<p>With Bootstrap 2, we've simplified the base class: <code>.alert</code> instead of <code>.alert-message</code>. We've also reduced the minimum required markup—no <code><p></code> is required by default, just the outer <code><div></code>.</p>
<h3>Single alert message</h3>
<p>For a more durable component with less code, we've removed the differentiating look for block alerts, messages that come with more padding and typically more text. The class also has changed to <code>.alert-block</code>.</p>
<hr>
<h3>Goes great with javascript</h3>
<p>Bootstrap comes with a great jQuery plugin that supports alert messages, making dismissing them quick and easy.</p>
<p><aclass="btn js-btn"href="./javascript.html#alerts">Get the plugin »</a></p>
</div>
<divclass="span8">
<h3>Example alerts</h3>
<p>Wrap your message and an optional close icon in a div with simple class.</p>
<divclass="alert">
<aclass="close"data-dismiss="alert">×</a>
<strong>Warning!</strong> Best check yo self, you're not looking too good.
<strong>Warning!</strong> Best check yo self, you're not looking too good.
</div>
</pre>
<p>Easily extend the standard alert message with two optional classes: <code>.alert-block</code> for more padding and text controls and <code>.alert-heading</code> for a matching heading.</p>
<divclass="alert alert-block">
<aclass="close"data-dismiss="alert">×</a>
<h4class="alert-heading">Warning!</h4>
<p>Best check yo self, you're not looking too good. Nulla vitae elit libero, a pharetra augue. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.</p>
<p>Progress bars use CSS3 transitions, so if you dynamically adjust the width via javascript, it will smoothly resize.</p>
<p>If you use the <code>.active</code> class, your <code>.progress-striped</code> progress bars will animate the stripes left to right.</p>
</div>
<divclass="span3">
<h3>Browser support</h3>
<p>Progress bars use CSS3 gradients, transitions, and animations to achieve all their effects. These features are not supported in IE7-9 or older versions of Firefox.</p>
<p>Opera and IE do not support animations at this time.</p>
<pclass="pull-right"><ahref="#">Back to top</a></p>
<p>Designed and built with all the love in the world <ahref="http://twitter.com/twitter"target="_blank">@twitter</a> by <ahref="http://twitter.com/mdo"target="_blank">@mdo</a> and <ahref="http://twitter.com/fat"target="_blank">@fat</a>.</p>
<p>Code licensed under the <ahref="http://www.apache.org/licenses/LICENSE-2.0"target="_blank">Apache License v2.0</a>. Documentation licensed under <ahref="http://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a>.</p>
<p>Icons from <ahref="http://glyphicons.com">Glyphicons Free</a>, licensed under <ahref="http://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a>.</p>
