components.html 55.2 KB
Newer Older
1
2
3
4
5
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <title>Bootstrap, from Twitter</title>
Raul Riera's avatar
Raul Riera committed
6
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
7
8
9
    <meta name="description" content="">
    <meta name="author" content="">

10
    <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
11
12
13
14
15
    <!--[if lt IE 9]>
      <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
    <![endif]-->

    <!-- Le styles -->
16
17
    <link href="assets/css/bootstrap.css" rel="stylesheet">
    <link href="assets/css/bootstrap-responsive.css" rel="stylesheet">
18
19
20
21
    <link href="assets/css/docs.css" rel="stylesheet">
    <link href="assets/js/google-code-prettify/prettify.css" rel="stylesheet">

    <!-- Le fav and touch icons -->
Mark Otto's avatar
Mark Otto committed
22
    <link rel="shortcut icon" href="assets/ico/favicon.ico">
Mark Otto's avatar
Mark Otto committed
23
24
25
    <link rel="apple-touch-icon" href="assets/ico/apple-touch-icon.png">
    <link rel="apple-touch-icon" sizes="72x72" href="assets/ico/apple-touch-icon-72x72.png">
    <link rel="apple-touch-icon" sizes="114x114" href="assets/ico/apple-touch-icon-114x114.png">
26
27
  </head>

Jacob Thornton's avatar
Jacob Thornton committed
28
  <body data-spy="scroll" data-target=".subnav" data-offset="50">
29
30


Jacob Thornton's avatar
Jacob Thornton committed
31
  <!-- Navbar
32
    ================================================== -->
33
    <div class="navbar navbar-fixed-top">
34
35
      <div class="navbar-inner">
        <div class="container">
36
          <a class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse">
Mark Otto's avatar
Mark Otto committed
37
38
39
            <span class="icon-bar"></span>
            <span class="icon-bar"></span>
            <span class="icon-bar"></span>
40
          </a>
41
          <a class="brand" href="./index.html">Bootstrap</a>
Mark Otto's avatar
Mark Otto committed
42
          <div class="nav-collapse">
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
            <ul class="nav">
              <li class="">
                <a href="./index.html">Overview</a>
              </li>
              <li class="">
                <a href="./scaffolding.html">Scaffolding</a>
              </li>
              <li class="">
                <a href="./base-css.html">Base CSS</a>
              </li>
              <li class="active">
                <a href="./components.html">Components</a>
              </li>
              <li class="">
                <a href="./javascript.html">Javascript plugins</a>
              </li>
              <li class="">
                <a href="./less.html">Using LESS</a>
              </li>
62
              <li class="divider-vertical"></li>
63
64
65
              <li class="">
                <a href="./download.html">Customize</a>
              </li>
66
67
68
              <li class="">
                <a href="./examples.html">Examples</a>
              </li>
69
70
            </ul>
          </div>
71
72
73
74
75
76
        </div>
      </div>
    </div>

    <div class="container">

Mark Otto's avatar
Mark Otto committed
77
78
79
80
81
82
<!-- Masthead
================================================== -->
<header class="jumbotron subhead" id="overview">
  <h1>Components</h1>
  <p class="lead">Dozens of reusable components are built into Bootstrap to provide navigation, alerts, popovers, and much more.</p>
  <div class="subnav">
83
    <ul class="nav nav-pills">
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
      <li class="dropdown">
        <a class="dropdown-toggle" data-toggle="dropdown" href="#">Buttons <b class="caret"></b></a>
        <ul class="dropdown-menu">
          <li><a href="#buttonGroups">Button groups</a></li>
          <li><a href="#buttonDropdowns">Button dropdowns</a></li>
        </ul>
      </li>
      <li class="dropdown">
        <a class="dropdown-toggle" data-toggle="dropdown" href="#">Navigation <b class="caret"></b></a>
        <ul class="dropdown-menu">
          <li><a href="#navs">Nav, tabs, pills</a></li>
          <li><a href="#navbar">Navbar</a></li>
          <li><a href="#breadcrumbs">Breadcrumbs</a></li>
          <li><a href="#pagination">Pagination</a></li>
        </ul>
      </li>
      <li><a href="#labels">Labels</a></li>
101
102
103
      <li><a href="#thumbnails">Thumbnails</a></li>
      <li><a href="#alerts">Alerts</a></li>
      <li><a href="#progress">Progress bars</a></li>
104
      <li><a href="#misc">Miscellaneous</a></li>
Jacob Thornton's avatar
Jacob Thornton committed
105
    </ul>
Mark Otto's avatar
Mark Otto committed
106
107
  </div>
</header>
108
109


110

Mark Otto's avatar
Mark Otto committed
111
112
113
114
115
116
117
118
119
120
121
<!-- Button Groups
================================================== -->
<section id="buttonGroups">
  <div class="page-header">
    <h1>Button groups <small>Join buttons for more toolbar-like functionality</small></h1>
  </div>
  <div class="row">
    <div class="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>&lt;a&gt;</code> or <code>&lt;button&gt;</code> elements.</p>
      <p>You can also combine sets of <code>&lt;div class="btn-group"&gt;</code> into a <code>&lt;div class="btn-toolbar"&gt;</code> for more complex projects.</p>
122
      <div class="btn-toolbar" style="margin-top: 18px;">
Mark Otto's avatar
Mark Otto committed
123
124
125
126
127
128
        <div class="btn-group">
          <a class="btn" href="#">Left</a>
          <a class="btn" href="#">Middle</a>
          <a class="btn" href="#">Right</a>
        </div>
      </div>
129
130
131
132
133
134
135
136
137
138
139
140
141
142
      <div class="btn-toolbar">
        <div class="btn-group">
          <a class="btn" href="#">1</a>
          <a class="btn" href="#">2</a>
          <a class="btn" href="#">3</a>
          <a class="btn" href="#">4</a>
        </div>
        <div class="btn-group">
          <a class="btn" href="#">5</a>
          <a class="btn" href="#">6</a>
          <a class="btn" href="#">7</a>
        </div>
        <div class="btn-group">
          <a class="btn" href="#">8</a>
143
144
        </div>
      </div>
Mark Otto's avatar
Mark Otto committed
145
146
147
148
    </div>
    <div class="span4">
      <h3>Example markup</h3>
      <p>Here's how the HTML looks for a standard button group built with anchor tag buttons:</p>
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
  &lt;a class="btn" href="#"&gt;1&lt;/a&gt;
  &lt;a class="btn" href="#"&gt;2&lt;/a&gt;
  &lt;a class="btn" href="#"&gt;3&lt;/a&gt;
&lt;/div&gt;
</pre>
      <p>And with a toolbar for multiple groups:</p>
<pre class="prettyprint linenums">
&lt;div class="btn-toolbar"&gt;
  &lt;div class="btn-group"&gt;
    ...
  &lt;/div&gt;
&lt;/div&gt;
</pre>
    </div>
Mark Otto's avatar
Mark Otto committed
165
166
167
168
169
170
171
172
173
174
    <div class="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 <a href="./javascript.html#buttons">the Javascript docs</a> for that.</p>
      <p><a class="btn js-btn" href="./javascript.html#buttons">Get the javascript &raquo;</a></p>
      <hr>
      <h4 class="muted">Heads up</h4>
      <p class="muted">CSS for button groups is in a separate file, button-groups.less.</p>
    </div>
  </div>
</section>
175
176
177



Mark Otto's avatar
Mark Otto committed
178
179
<!-- Split button dropdowns
================================================== -->
180
<section id="buttonDropdowns">
Mark Otto's avatar
Mark Otto committed
181
  <div class="page-header">
182
    <h1>Buttons dropdowns <small>Contextual dropdown menus built on button groups</small></h1>
Mark Otto's avatar
Mark Otto committed
183
  </div>
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200

  <div class="row">
    <div class="span4">
      <h3>Button dropdowns</h3>
      <p>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="btn-toolbar" style="margin-top: 18px;">
        <div class="btn-group">
          <a class="btn dropdown-toggle" data-toggle="dropdown" href="#">Action <span class="caret"></span></a>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
201
          <a class="btn btn-primary dropdown-toggle" data-toggle="dropdown" href="#">Action <span class="caret"></span></a>
202
203
204
205
206
207
208
209
210
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
211
          <a class="btn btn-danger dropdown-toggle" data-toggle="dropdown" href="#">Danger <span class="caret"></span></a>
212
213
214
215
216
217
218
219
220
221
222
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
      </div>
      <div class="btn-toolbar">
        <div class="btn-group">
223
          <a class="btn btn-success dropdown-toggle" data-toggle="dropdown" href="#">Success <span class="caret"></span></a>
224
225
226
227
228
229
230
231
232
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
233
          <a class="btn btn-info dropdown-toggle" data-toggle="dropdown" href="#">Info <span class="caret"></span></a>
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
      </div>
    </div>
    <div class="span8">
      <h3>Example markup</h3>
      <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>
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
  &lt;a class="btn dropdown-toggle" data-toggle="dropdown" href="#"&gt;
    Action
    &lt;span class="caret"&gt;&lt;/span&gt;
  &lt;/a&gt;
  &lt;ul class="dropdown-menu"&gt;
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>
    </div>
  </div>

Mark Otto's avatar
Mark Otto committed
261
262
263
264
  <div class="row">
    <div class="span4">
      <h3>Split button dropdowns</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>
265
266
267
268
269
270
271
272
273
274
275
276
277
      <div class="btn-toolbar" style="margin-top: 18px;">
        <div class="btn-group">
          <a class="btn" href="#">Action</a>
          <a class="btn dropdown-toggle" data-toggle="dropdown" href="#"><span class="caret"></span></a>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
278
279
          <a class="btn btn-primary" href="#">Action</a>
          <a class="btn btn-primary dropdown-toggle" data-toggle="dropdown" href="#"><span class="caret"></span></a>
280
281
282
283
284
285
286
287
288
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
289
290
          <a class="btn btn-danger" href="#">Danger</a>
          <a class="btn btn-danger dropdown-toggle" data-toggle="dropdown" href="#"><span class="caret"></span></a>
291
292
293
294
295
296
297
298
299
300
301
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
      </div>
      <div class="btn-toolbar">
        <div class="btn-group">
302
303
          <a class="btn btn-success" href="#">Success</a>
          <a class="btn btn-success dropdown-toggle" data-toggle="dropdown" href="#"><span class="caret"></span></a>
304
305
306
307
308
309
310
311
312
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
313
314
          <a class="btn btn-info" href="#">Info</a>
          <a class="btn btn-info dropdown-toggle" data-toggle="dropdown" href="#"><span class="caret"></span></a>
315
316
317
318
319
320
321
322
323
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
      </div>
324
    </div>
Mark Otto's avatar
Mark Otto committed
325
326
    <div class="span8">
      <h3>Example markup</h3>
327
      <p>We expand on the normal button dropdowns to provide a second button action that operates as a separate dropdown trigger.</p>
328
329
330
331
332
333
334
335
336
337
338
339
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
  &lt;a class="btn" href="#"&gt;Action&lt;/a&gt;
  &lt;a class="btn dropdown-toggle" data-toggle="dropdown" href="#"&gt;
    &lt;span class="caret"&gt;&lt;/span&gt;
  &lt;/a&gt;
  &lt;ul class="dropdown-menu"&gt;
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>
    </div>
Mark Otto's avatar
Mark Otto committed
340
341
  </div>
</section>
342

343
344


345
<!-- Nav, Tabs, & Pills
346
================================================== -->
347
<section id="navs">
348
  <div class="page-header">
349
    <h1>Nav, tabs, and pills <small>Highly customizable list-style navigation</small></h1>
350
  </div>
351

352
  <h2>Lightweight defaults <small>Same markup, different classes</small></h2>
353
  <div class="row">
354
355
356
357
358
359
360
361
362
    <div class="span4">
      <h3>Powerful base class</h3>
      <p>All nav components here&mdash;tabs, pills, and lists&mdash;<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>&lt;ul&gt;</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>
    <div class="span4">
      <h3>Basic tabs</h3>
nkryptic's avatar
nkryptic committed
363
      <p>Take a regular <code>&lt;ul&gt;</code> of links and add <code>.nav-tabs</code>:</p>
364
      <ul class="nav nav-tabs">
365
366
367
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
368
      </ul>
369
<pre class="prettyprint linenums">
370
&lt;ul class="nav nav-tabs"&gt;
371
372
373
374
375
376
377
  &lt;li class="active"&gt;
    &lt;a href="#"&gt;Home&lt;/a&gt;
  &lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;...&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;...&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</pre>
378
    </div>
379
380
    <div class="span4">
      <h3>Basic pills</h3>
nkryptic's avatar
nkryptic committed
381
      <p>Take that same HTML, but use <code>.nav-pills</code> instead:</p>
382
      <ul class="nav nav-pills">
383
384
385
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
386
      </ul>
387
<pre class="prettyprint linenums">
388
&lt;ul class="nav nav-pills"&gt;
389
390
391
392
393
394
395
  &lt;li class="active"&gt;
    &lt;a href="#"&gt;Home&lt;/a&gt;
  &lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;...&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;...&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</pre>
396
397
398
    </div>
  </div>

399
  <h2>Stackable <small>Make tabs or pills vertical</small></h2>
400
401
  <div class="row">
    <div class="span4">
402
      <h3>How to stack 'em</h3>
nkryptic's avatar
nkryptic committed
403
      <p>As tabs and pills are horizontal by default, just add a second class, <code>.nav-stacked</code>, to make them appear vertically stacked.</p>
404
405
    </div>
    <div class="span4">
406
      <h3>Stacked tabs</h3>
407
      <ul class="nav nav-tabs nav-stacked">
408
409
410
411
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
      </ul>
412
<pre class="prettyprint linenums">
413
&lt;ul class="nav nav-tabs nav-stacked"&gt;
414
415
416
  ...
&lt;/ul&gt;
</pre>
417
418
419
    </div>
    <div class="span4">
      <h3>Stacked pills</h3>
420
      <ul class="nav nav-pills nav-stacked">
421
422
423
424
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
      </ul>
425
<pre class="prettyprint linenums">
426
&lt;ul class="nav nav-pills nav-stacked"&gt;
427
428
429
430
  ...
&lt;/ul&gt;
</pre>
    </div>
431
432
  </div>

433
  <h2>Dropdowns <small>For advanced nav components</small></h2>
434
  <div class="row">
435
436
437
438
    <div class="span4">
      <h3>Rich menus made easy</h3>
      <p>Dropdown menus in Bootstrap tabs and pills are super easy and require only a little extra HTML and a lightweight jQuery plugin.</p>
      <p>Head over to the Javascript page to read the docs on <a href="./javascript.html#tabs">initializing dropdowns</a> in Bootstrap.</p>
439
    </div>
440
441
    <div class="span4">
      <h3>Tabs with dropdowns</h3>
442
      <ul class="nav nav-tabs">
443
444
445
446
447
448
449
450
451
452
453
454
455
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li class="dropdown">
          <a class="dropdown-toggle" data-toggle="dropdown" href="#">Dropdown <b class="caret"></b></a>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </li>
      </ul>
456
<pre class="prettyprint linenums">
457
&lt;ul class="nav nav-tabs"&gt;
458
  &lt;li class="dropdown"&gt;
459
    &lt;a class="dropdown-toggle"
460
461
462
463
464
465
466
467
468
469
       data-toggle="dropdown"
       href="#"&gt;
        Dropdown
        &lt;b class="caret"&gt;&lt;/b&gt;
      &lt;/a&gt;
    &lt;ul class="dropdown-menu"&gt;
      &lt;!-- links --&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
&lt;/ul&gt;
470
</pre>
471
472
473
    </div>
    <div class="span4">
      <h3>Pills with dropdowns</h3>
474
      <ul class="nav nav-pills">
475
476
477
478
479
480
481
482
483
484
485
486
487
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li class="dropdown">
          <a class="dropdown-toggle" data-toggle="dropdown" href="#">Dropdown <b class="caret"></b></a>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </li>
      </ul>
488
<pre class="prettyprint linenums">
489
&lt;ul class="nav nav-pills"&gt;
490
  &lt;li class="dropdown"&gt;
491
    &lt;a class="dropdown-toggle"
492
493
494
495
496
497
498
499
500
501
       data-toggle="dropdown"
       href="#"&gt;
        Dropdown
        &lt;b class="caret"&gt;&lt;/b&gt;
      &lt;/a&gt;
    &lt;ul class="dropdown-menu"&gt;
      &lt;!-- links --&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
&lt;/ul&gt;
502
503
</pre>
    </div>
504
505
  </div>

506
507
508
509
510
511
  <h2>Nav lists <small>Build simple stacked navs, great for sidebars</small></h2>
  <div class="row">
    <div class="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>
512
513
      <h4>With icons</h4>
      <p>Nav lists are also easy to equip with icons. Add the proper <code>&lt;i&gt;</code> tag with class and you're set.</p>
514
515
    </div>
    <div class="span4">
516
      <h3>Example nav list</h3>
nkryptic's avatar
nkryptic committed
517
      <p>Take a list of links and add <code>class="nav nav-list"</code>:</p>
518
      <div class="well" style="padding: 8px 0;">
519
        <ul class="nav nav-list">
520
          <li class="nav-header">List header</li>
521
          <li class="active"><a href="#">Home</a></li>
522
523
524
525
526
527
          <li><a href="#">Library</a></li>
          <li><a href="#">Applications</a></li>
          <li class="nav-header">Another list header</li>
          <li><a href="#">Profile</a></li>
          <li><a href="#">Settings</a></li>
          <li><a href="#">Help</a></li>
528
        </ul>
529
      </div> <!-- /well -->
530
<pre class="prettyprint linenums">
531
&lt;ul class="nav nav-list"&gt;
532
533
534
  &lt;li class="nav-header"&gt;
    List header
  &lt;/li&gt;
535
  &lt;li class="active"&gt;
536
    &lt;a href="#"&gt;Home&lt;/a&gt;
537
  &lt;/li&gt;
538
539
  &lt;li&gt;
    &lt;a href="#"&gt;Library&lt;/a&gt;
540
  &lt;/li&gt;
541
  ...
542
&lt;/ul&gt;
543
544
545
546
547
548
</pre>
    </div>
    <div class="span4">
      <h3>Example with icons</h3>
      <p>Same example, but with <code>&lt;i&gt;</code> tags for icons.</p>
      <div class="well" style="padding: 8px 0;">
549
        <ul class="nav nav-list">
550
          <li class="nav-header">List header</li>
Mark Otto's avatar
Mark Otto committed
551
552
553
          <li class="active"><a href="#"><i class="icon-white icon-home"></i> Home</a></li>
          <li><a href="#"><i class="icon-book"></i> Library</a></li>
          <li><a href="#"><i class="icon-pencil"></i> Applications</a></li>
554
          <li class="nav-header">Another list header</li>
Mark Otto's avatar
Mark Otto committed
555
556
557
          <li><a href="#"><i class="icon-user"></i> Profile</a></li>
          <li><a href="#"><i class="icon-cog"></i> Settings</a></li>
          <li><a href="#"><i class="icon-flag"></i> Help</a></li>
558
559
560
        </ul>
      </div> <!-- /well -->
<pre class="prettyprint linenums">
561
&lt;ul class="nav nav-list"&gt;
562
563
564
  ...
  &lt;li&gt;
    &lt;a href="#"&gt;
Mark Otto's avatar
Mark Otto committed
565
      &lt;i class="icon-book"&gt;&lt;/i&gt;
566
567
568
569
570
      Library
    &lt;/a&gt;
  &lt;/li&gt;
  ...
&lt;/ul&gt;
571
</pre>
572
573
    </div>
  </div>
574

575

576
  <h2>Tabbable nav <small>Bring tabs to life via javascript</small></h2>
577
578
579
  <div class="row">
    <div class="span4">
      <h3>What's included</h3>
580
      <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>
581
582
      <p>Changing between them is easy and only requires changing very little markup.</p>
    </div>
583
    <div class="span4">
584
      <h3>Tabbable example</h3>
nkryptic's avatar
nkryptic committed
585
      <p>To make tabs tabbable, wrap the <code>.nav-tabs</code> in another div with class <code>.tabbable</code>.</p>
586
      <div class="tabbable" style="margin-bottom: 9px;">
587
        <ul class="nav nav-tabs">
588
589
590
          <li class="active"><a href="#1" data-toggle="tab">Section 1</a></li>
          <li><a href="#2" data-toggle="tab">Section 2</a></li>
          <li><a href="#3" data-toggle="tab">Section 3</a></li>
591
592
593
        </ul>
        <div class="tab-content">
          <div class="tab-pane active" id="1">
594
            <p>I'm in Section 1.</p>
595
596
          </div>
          <div class="tab-pane" id="2">
597
            <p>Howdy, I'm in Section 2.</p>
598
599
          </div>
          <div class="tab-pane" id="3">
600
            <p>What up girl, this is Section 3.</p>
601
602
          </div>
        </div>
603
      </div> <!-- /tabbable -->
604
605
606
607
    </div>
    <div class="span4">
      <h3>Custom jQuery plugin</h3>
      <p>All tabbable tabs are powered by our lightweight jQuery plugin. Read more about how to bring tabbable tabs to life on the javascript docs page.</p>
Mark Otto's avatar
Mark Otto committed
608
      <p><a class="btn" href="./javascript.html#tabs">Get the javascript &rarr;</a></p>
609
610
    </div>
  </div>
611

612
613
  <h3>Straightforward markup</h3>
  <p>Using tabbable tabs requires a wrapping div, a set of tabs, and a set of tabbable panes of content.</p>
614
615
<pre class="prettyprint linenums">
&lt;div class="tabbable"&gt;
616
  &lt;ul class="nav nav-tabs"&gt;
617
618
619
620
621
622
623
624
625
626
627
628
629
    &lt;li class="active"&gt;&lt;a href="#1" data-toggle="tab"&gt;Section 1&lt;/a&gt;&lt;/li&gt;
    &lt;li&gt;&lt;a href="#2" data-toggle="tab"&gt;Section 2&lt;/a&gt;&lt;/li&gt;
  &lt;/ul&gt;
  &lt;div class="tab-content"&gt;
    &lt;div class="tab-pane active" id="1"&gt;
      &lt;p&gt;I'm in Section 1.&lt;/p&gt;
    &lt;/div&gt;
    &lt;div class="tab-pane" id="2"&gt;
      &lt;p&gt;Howdy, I'm in Section 2.&lt;/p&gt;
    &lt;/div&gt;
  &lt;/div&gt;
&lt;/div&gt;
</pre>
630

631
632
633
634
635
636
637
638
639
  <h3>Tabbable in any direction</h3>
  <div class="row">
    <div class="span4">
      <h4>Tabs on the bottom</h4>
      <p>Flip the order of the HTML and add a class to put tabs on the bottom.</p>
      <div class="tabbable tabs-below">
        <div class="tab-content">
          <div class="tab-pane active" id="A">
            <p>I'm in Section A.</p>
640
          </div>
641
642
643
644
645
          <div class="tab-pane" id="B">
            <p>Howdy, I'm in Section B.</p>
          </div>
          <div class="tab-pane" id="C">
            <p>What up girl, this is Section C.</p>
646
647
          </div>
        </div>
648
        <ul class="nav nav-tabs">
649
650
651
652
653
          <li class="active"><a href="#A" data-toggle="tab">Section 1</a></li>
          <li><a href="#B" data-toggle="tab">Section 2</a></li>
          <li><a href="#C" data-toggle="tab">Section 3</a></li>
        </ul>
      </div> <!-- /tabbable -->
654
<pre class="prettyprint linenums" style="margin-top: 11px;">
Mark Otto's avatar
Mark Otto committed
655
&lt;div class="tabbable tabs-below"&gt;
656
657
658
  &lt;div class="tab-content"&gt;
    ...
  &lt;/div&gt;
659
660
661
  &lt;ul class="nav nav-tabs"&gt;
    ...
  &lt;/ul&gt;
662
663
&lt;/div&gt;
</pre>
664
665
666
667
668
    </div>
    <div class="span4">
      <h4>Tabs on the left</h4>
      <p>Swap the class to put tabs on the left.</p>
      <div class="tabbable tabs-left">
669
        <ul class="nav nav-tabs">
670
671
672
673
          <li class="active"><a href="#lA" data-toggle="tab">Section 1</a></li>
          <li><a href="#lB" data-toggle="tab">Section 2</a></li>
          <li><a href="#lC" data-toggle="tab">Section 3</a></li>
        </ul>
674
        <div class="tab-content">
675
676
          <div class="tab-pane active" id="lA">
            <p>I'm in Section A.</p>
677
          </div>
678
679
          <div class="tab-pane" id="lB">
            <p>Howdy, I'm in Section B.</p>
680
          </div>
681
682
          <div class="tab-pane" id="lC">
            <p>What up girl, this is Section C.</p>
683
684
          </div>
        </div>
685
      </div> <!-- /tabbable -->
686
687
<pre class="prettyprint linenums">
&lt;div class="tabbable tabs-left"&gt;
688
  &lt;ul class="nav nav-tabs"&gt;
689
690
691
692
693
694
695
    ...
  &lt;/ul&gt;
  &lt;div class="tab-content"&gt;
    ...
  &lt;/div&gt;
&lt;/div&gt;
</pre>
696
697
698
699
700
    </div>
    <div class="span4">
      <h4>Tabs on the right</h4>
      <p>Swap the class to put tabs on the right.</p>
      <div class="tabbable tabs-right">
701
        <ul class="nav nav-tabs">
702
703
704
          <li class="active"><a href="#rA" data-toggle="tab">Section 1</a></li>
          <li><a href="#rB" data-toggle="tab">Section 2</a></li>
          <li><a href="#rC" data-toggle="tab">Section 3</a></li>
705
        </ul>
706
707
708
709
710
711
712
713
714
715
716
717
        <div class="tab-content">
          <div class="tab-pane active" id="rA">
            <p>I'm in Section A.</p>
          </div>
          <div class="tab-pane" id="rB">
            <p>Howdy, I'm in Section B.</p>
          </div>
          <div class="tab-pane" id="rC">
            <p>What up girl, this is Section C.</p>
          </div>
        </div>
      </div> <!-- /tabbable -->
718
719
<pre class="prettyprint linenums">
&lt;div class="tabbable tabs-right"&gt;
720
  &lt;ul class="nav nav-tabs"&gt;
721
722
723
724
725
726
727
    ...
  &lt;/ul&gt;
  &lt;div class="tab-content"&gt;
    ...
  &lt;/div&gt;
&lt;/div&gt;
</pre>
728
729
    </div>
  </div>
730

731
732
733
734
735
736
737
738
739
740
741
742
</section>



<!-- Navbar
================================================== -->
<section id="navbar">
  <div class="page-header">
    <h1>Navbar</h1>
  </div>
  <h2>Static navbar example</h2>
  <p>An example of a static (not fixed to the top) navbar with project name, navigation, and search form.</p>
743
  <div class="navbar">
744
745
    <div class="navbar-inner">
      <div class="container" style="width: auto;">
746
        <a class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse">
Mark Otto's avatar
Mark Otto committed
747
748
749
          <span class="icon-bar"></span>
          <span class="icon-bar"></span>
          <span class="icon-bar"></span>
750
        </a>
751
        <a class="brand" href="#">Project name</a>
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
        <div class="nav-collapse">
          <ul class="nav">
            <li class="active"><a href="#">Home</a></li>
            <li><a href="#">Link</a></li>
            <li><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">
                <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>
          <form class="navbar-search pull-left" action="">
            <input type="text" class="search-query span2" placeholder="Search">
          </form>
          <ul class="nav pull-right">
            <li><a href="#">Link</a></li>
774
            <li class="divider-vertical"></li>
775
776
777
778
779
780
781
782
783
784
785
786
            <li class="dropdown">
              <a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown <b class="caret"></b></a>
              <ul class="dropdown-menu">
                <li><a href="#">Action</a></li>
                <li><a href="#">Another action</a></li>
                <li><a href="#">Something else here</a></li>
                <li class="divider"></li>
                <li><a href="#">Separated link</a></li>
              </ul>
            </li>
          </ul>
        </div><!-- /.nav-collapse -->
787
788
789
790
791
792
793
794
795
      </div>
    </div><!-- /navbar-inner -->
  </div><!-- /navbar -->

  <div class="row">
    <div class="span8">
      <h3>Navbar scaffolding</h3>
      <p>The navbar requires only a few divs to structure it well for static or fixed display.</p>
<pre class="prettyprint linenums">
796
&lt;div class="navbar"&gt;
797
  &lt;div class="navbar-inner"&gt;
798
    &lt;div class="container"&gt;
799
800
801
802
803
      ...
    &lt;/div&gt;
  &lt;/div&gt;
&lt;/div&gt;
</pre>
804
      <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>&lt;body&gt;</code>.</p>
805
<pre class="prettyprint linenums">
806
&lt;div class="navbar navbar-fixed-top"&gt;
807
808
809
810
811
812
813
814
815
816
817
818
819
  ...
&lt;/div&gt;
</pre>
      <h3>Brand name</h3>
      <p>A simple link to show your brand or project name only requires an anchor tag.</p>
<pre class="prettyprint linenums">
&lt;a class="brand" href="#"&gt;
  Project name
&lt;/a&gt;
</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>
<pre class="prettyprint linenums">
820
821
&lt;form class="navbar-search pull-left"&gt;
  &lt;input type="text" class="search-query" placeholder="Search"&gt;
822
823
&lt;/form&gt;
</pre>
824
      <h3>Optional responsive variation</h3>
825
      <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>
826
<pre class="prettyprint linenums">
827
&lt;div class="navbar"&gt;
828
829
830
831
832
  &lt;div class="navbar-inner"&gt;
    &lt;div class="container"&gt;
      
      &lt;!-- .btn-navbar is used as the toggle for collapsed navbar content --&gt;
      &lt;a class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse"&gt;
Mark Otto's avatar
Mark Otto committed
833
834
835
        &lt;span class="icon-bar"&gt;&lt;/span&gt;
        &lt;span class="icon-bar"&gt;&lt;/span&gt;
        &lt;span class="icon-bar"&gt;&lt;/span&gt;
836
837
838
839
840
841
      &lt;/a&gt;
      
      &lt;!-- Be sure to leave the brand out there if you want it shown --&gt;
      &lt;a class="brand" href="#"&gt;Project name&lt;/a&gt;

      &lt;!-- Everything you want hidden at 940px or less, place within here --&gt;
842
      &lt;div class="nav-collapse"&gt;
843
844
845
846
847
848
849
        &lt;!-- .nav, .navbar-search, .navbar-form, etc --&gt;
      &lt;/div&gt;

    &lt;/div&gt;
  &lt;/div&gt;
&lt;/div&gt;
</pre>
850
851
852
      <div class="alert alert-info">
        <strong>Heads up!</strong> The responsive navbar requires the <a href="./javascript.html#collapse">collapse plugin</a>.
      </div>
853

854
    </div><!-- /.span -->
855
856
857
    <div class="span4">
      <h3>Nav links</h3>
      <p>Nav items are simple to add via unordered lists.</p>
858
<pre class="prettyprint linenums">
859
860
861
862
863
864
865
866
&lt;ul class="nav"&gt;
  &lt;li class="active"&gt;
    &lt;a href="#">Home&lt;/a&gt;
  &lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Link&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Link&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</pre>
867
      <h3>Adding dropdowns</h3>
Mark Otto's avatar
Mark Otto committed
868
      <p>Adding dropdowns to the nav is super simple, but does require the use of <a href="./javascript.html#dropdown">our javascript plugin</a>.</p>
869
870
871
872
873
874
875
<pre class="prettyprint linenums">
&lt;ul class="nav"&gt;
  &lt;li class="dropdown"&gt;
    &lt;a href="#"
          class="dropdown-toggle"
          data-toggle="dropdown">
          Account
876
          &lt;b class="caret"&gt;&lt;/b&gt;
877
878
879
880
881
    &lt;/a&gt;
    &lt;ul class="dropdown-menu"&gt;
      ...
    &lt;/ul&gt;
  &lt;/li&gt;
882
883
&lt;/ul&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
884
      <p><a class="btn" href="./javascript.html#dropdown">Get the javascript &rarr;</a></p>
885
886
    </div><!-- /.span -->
  </div><!-- /.row -->
887

888
889
890
891
892
893
894
895
896
897
898
</section>



<!-- Breadcrumbs
================================================== -->
<section id="breadcrumbs">
  <div class="page-header">
    <h1>Breadcrumbs <small></small></h1>
  </div>

899
  <div class="row">
900
901
902
903
904
905
    <div class="span6">
      <h3>Why use them</h3>
      <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>
906
907
908
909
910
      <ul class="breadcrumb">
        <li class="active">Home</li>
      </ul>
      <ul class="breadcrumb">
        <li><a href="#">Home</a> <span class="divider">/</span></li>
911
        <li class="active">Library</li>
912
913
914
      </ul>
      <ul class="breadcrumb">
        <li><a href="#">Home</a> <span class="divider">/</span></li>
915
916
        <li><a href="#">Library</a> <span class="divider">/</span></li>
        <li class="active">Data</li>
917
      </ul>
918
919
920
921
    </div>
    <div class="span6">
      <h3>Markup</h3>
      <p>HTML is your standard unordered list with links.</p>
922
923
<pre class="prettyprint linenums">
&lt;ul class="breadcrumb"&gt;
924
925
926
927
928
929
930
931
932
  &lt;li&gt;
    &lt;a href="#"&gt;Home&lt;/a&gt; &lt;span class="divider"&gt;/&lt;/span&gt;
  &lt;/li&gt;
  &lt;li&gt;
    &lt;a href="#"&gt;Library&lt;/a&gt; &lt;span class="divider"&gt;/&lt;/span&gt;
  &lt;/li&gt;
  &lt;li class="active"&gt;
    &lt;a href="#"&gt;Data&lt;/a&gt;
  &lt;/li&gt;
933
934
935
936
937
&lt;/ul&gt;
</pre>
    </div>
  </div>

938
939
940
941
942
943
</section>



<!-- Pagination
================================================== -->
Chris Gunther's avatar
Chris Gunther committed
944
<section id="pagination">
945
  <div class="page-header">
946
    <h1>Pagination <small>Two options for paging through content</small></h1>
947
948
  </div>

Mark Otto's avatar
Mark Otto committed
949
  <h2>Multicon-page pagination</h2>
950
  <div class="row">
951
952
953
954
955
956
957
    <div class="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>
958
    </div>
959
960
961
    <div class="span4">
      <h3>Examples</h3>
      <p>The default pagination component is flexible and works in a number of variations.</p>
962
963
      <div class="pagination">
        <ul>
964
          <li class="disabled"><a href="#">&laquo;</a></li>
965
966
967
968
          <li class="active"><a href="#">1</a></li>
          <li><a href="#">2</a></li>
          <li><a href="#">3</a></li>
          <li><a href="#">4</a></li>
969
          <li><a href="#">&raquo;</a></li>
970
971
972
973
        </ul>
      </div>
      <div class="pagination">
        <ul>
974
          <li><a href="#">&laquo;</a></li>
975
          <li><a href="#">10</a></li>
976
977
978
          <li class="active"><a href="#">11</a></li>
          <li><a href="#">12</a></li>
          <li><a href="#">&raquo;</a></li>
979
980
981
982
983
        </ul>
      </div>
      <div class="pagination">
        <ul>
          <li><a href="#">&larr;</a></li>
984
          <li class="active"><a href="#">10</a></li>
985
          <li class="disabled"><a href="#">...</a></li>
986
          <li><a href="#">20</a></li>
987
          <li><a href="#">&rarr;</a></li>
988
989
        </ul>
      </div>
990
      <div class="pagination pagination-centered">
991
        <ul>
992
993
994
995
996
          <li class="active"><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>
997
998
        </ul>
      </div>
999
1000
    </div>
    <div class="span4">
For faster browsing, not all history is shown. View entire blame