<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>
<p>You can also combine sets of <code><div class="btn-group"></code> into a <code><div class="btn-toolbar"></code> for more complex projects.</p>
<divclass="btn-toolbar"style="margin-top: 18px;">
<divclass="btn-group">
<aclass="btn"href="#">Left</a>
<aclass="btn"href="#">Middle</a>
<aclass="btn"href="#">Right</a>
</div>
</div>
<divclass="btn-toolbar">
<divclass="btn-group">
<aclass="btn"href="#">1</a>
<aclass="btn"href="#">2</a>
<aclass="btn"href="#">3</a>
<aclass="btn"href="#">4</a>
</div>
<divclass="btn-group">
<aclass="btn"href="#">5</a>
<aclass="btn"href="#">6</a>
<aclass="btn"href="#">7</a>
</div>
<divclass="btn-group">
<aclass="btn"href="#">8</a>
</div>
</div>
</div>
<divclass="span4">
<h3>Example markup</h3>
<p>Here's how the HTML looks for a standard button group built with anchor tag buttons:</p>
<preclass="prettyprint linenums">
<div class="btn-group">
<a class="btn" href="#">1</a>
<a class="btn" href="#">2</a>
<a class="btn" href="#">3</a>
</div>
</pre>
<p>And with a toolbar for multiple groups:</p>
<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>
<hr>
<h4class="muted">Heads up</h4>
<pclass="muted">CSS for button groups is in a separate file, button-groups.less.</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>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>
<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>Why tabs and pills</h3>
<p>Tabs and pills in Bootstrap are built on a <code><ul></code> with the same core HTML, a list of links. Swap between tabs or pills with only a class.</p>
<p>Both options are great for sub-sections of content or navigating between pages of related content.</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>
<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>
</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>
<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>
<p>To make the navbar fixed to the top of the viewport, add <code>.navbar-fixed-top</code> to the outermost div, <code>.navbar</code>. In your CSS, you will also need to account for the overlap it causes by adding <code>padding-top: 40px;</code> to your <code><body></code>.</p>
<preclass="prettyprint linenums">
<div class="navbar navbar-fixed-top">
...
</div>
</pre>
<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>Search form</h3>
<p>Search forms receive custom styles in the navbar with the <code>.navbar-search</code> class. Include <code>.pull-left</code> or <code>.pull-right</code> on the <code>form</code> to align it.</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>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 implemenations with light markup and even lighter styles. It's great for simple sites like blogs or magazines.</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>
<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 outter <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">×</a>
<strong>Warning!</strong> Best check yo self, you’re not looking too good.
</div>
<preclass="prettyprint linenums">
<div class="alert">
<a class="close">×</a>
<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">×</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 utilize some of the same class names as buttons and alerts for similar styling.</p>
<ul>
<li><code>.progress-info</code></li>
<li><code>.progress-success</code></li>
<li><code>.progress-danger</code></li>
</ul>
<p>Alternatively, you can customize the LESS files and roll your own colors and sizes.</p>
</div>
<divclass="span4">
<h3>Behavior</h3>
<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="span4">
<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-8 or older versions of Firefox.</p>
<p>Opera does 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>
