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

    <!-- Le styles -->
11
12
    <link href="assets/css/bootstrap.css" rel="stylesheet">
    <link href="assets/css/bootstrap-responsive.css" rel="stylesheet">
13
14
    <link href="assets/css/docs.css" rel="stylesheet">
    <link href="assets/js/google-code-prettify/prettify.css" rel="stylesheet">
Mark Otto's avatar
Mark Otto committed
15
16
17
18
19

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

21
    <!-- Le fav and touch icons -->
Mark Otto's avatar
Mark Otto committed
22
    <link rel="shortcut icon" href="assets/ico/favicon.ico">
23
    <link rel="apple-touch-icon-precomposed" sizes="114x114" href="assets/ico/apple-touch-icon-114-precomposed.png">
24
25
    <link rel="apple-touch-icon-precomposed" sizes="72x72" href="assets/ico/apple-touch-icon-72-precomposed.png">
    <link rel="apple-touch-icon-precomposed" href="assets/ico/apple-touch-icon-57-precomposed.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>
Mark Otto's avatar
Mark Otto committed
101
      <li><a href="#badges">Badges</a></li>
102
      <li><a href="#typography">Typography</a></li>
103
104
105
      <li><a href="#thumbnails">Thumbnails</a></li>
      <li><a href="#alerts">Alerts</a></li>
      <li><a href="#progress">Progress bars</a></li>
106
      <li><a href="#misc">Miscellaneous</a></li>
Jacob Thornton's avatar
Jacob Thornton committed
107
    </ul>
Mark Otto's avatar
Mark Otto committed
108
109
  </div>
</header>
110
111


112

Mark Otto's avatar
Mark Otto committed
113
114
115
116
117
118
119
120
121
122
<!-- 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>
123
124
125
126
127
128
129
130
131
132
133
134
135
136
      <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>&lt;a&gt;</code> or <code>&lt;button&gt;</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><span class="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>
    <div class="span4">
      <h3>Default example</h3>
      <p>Here's how the HTML looks for a standard button group built with anchor tag buttons:</p>
      <div class="">
        <div class="btn-group" style="margin: 9px 0;">
137
138
139
          <button class="btn">Left</button>
          <button class="btn">Middle</button>
          <button class="btn">Right</button>
Mark Otto's avatar
Mark Otto committed
140
141
        </div>
      </div>
142
143
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
144
145
146
  &lt;button class="btn"&gt;1&lt;/button&gt;
  &lt;button class="btn"&gt;2&lt;/button&gt;
  &lt;button class="btn"&gt;3&lt;/button&gt;
147
148
149
150
&lt;/div&gt;
</pre>
      <h3>Toolbar example</h3>
      <p>Combine sets of <code>&lt;div class="btn-group"&gt;</code> into a <code>&lt;div class="btn-toolbar"&gt;</code> for more complex components.</p>
151
152
      <div class="btn-toolbar">
        <div class="btn-group">
153
154
155
156
          <button class="btn">1</button>
          <button class="btn">2</button>
          <button class="btn">3</button>
          <button class="btn">4</button>
157
158
        </div>
        <div class="btn-group">
159
160
161
          <button class="btn">5</button>
          <button class="btn">6</button>
          <button class="btn">7</button>
162
163
        </div>
        <div class="btn-group">
164
          <button class="btn">8</button>
165
166
167
168
169
170
171
172
173
174
        </div>
      </div>
<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
175
176
177
178
    <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>
Mark Otto's avatar
Mark Otto committed
179
180
      <h3>Dropdowns in button groups</h3>
      <p><span class="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>
Mark Otto's avatar
Mark Otto committed
181
182
183
    </div>
  </div>
</section>
184
185
186



Mark Otto's avatar
Mark Otto committed
187
188
<!-- Split button dropdowns
================================================== -->
189
<section id="buttonDropdowns">
Mark Otto's avatar
Mark Otto committed
190
  <div class="page-header">
191
    <h1>Button dropdown menus <small>Built on button groups to provide contextual menus</small></h1>
Mark Otto's avatar
Mark Otto committed
192
  </div>
193

194
  <h2>Button dropdowns</h2>
195
196
  <div class="row">
    <div class="span4">
197
      <h3>Overview and examples</h3>
198
199
200
      <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">
201
          <button class="btn dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
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
          <button class="btn btn-primary dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
212
213
214
215
216
217
218
219
220
          <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">
221
          <button class="btn btn-danger dropdown-toggle" data-toggle="dropdown">Danger <span class="caret"></span></button>
222
223
224
225
226
227
228
229
230
231
          <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">
232
        <div class="btn-group">
233
          <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown">Warning <span class="caret"></span></button>
234
235
236
237
238
239
240
241
          <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 -->
242
        <div class="btn-group">
243
          <button class="btn btn-success dropdown-toggle" data-toggle="dropdown">Success <span class="caret"></span></button>
244
245
246
247
248
249
250
251
252
          <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">
253
          <button class="btn btn-info dropdown-toggle" data-toggle="dropdown">Info <span class="caret"></span></button>
254
255
256
257
258
259
260
261
          <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 -->
262
        <div class="btn-group">
263
          <button class="btn btn-inverse dropdown-toggle" data-toggle="dropdown">Inverse <span class="caret"></span></button>
264
265
266
267
268
269
270
271
          <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 -->
272
      </div><!-- /btn-toolbar -->
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
    </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>
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
  <div class="row">
    <div class="span4">
      <h3>Works with all button sizes</h3>
      <p>Button dropdowns work at any size. your button sizes to <code>.btn-large</code>, <code>.btn-small</code>, or <code>.btn-mini</code>.</p>
      <div class="btn-toolbar" style="margin-top: 18px;">
        <div class="btn-group">
          <button class="btn btn-large dropdown-toggle" data-toggle="dropdown">Large button <span class="caret"></span></button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
          <button class="btn btn-small dropdown-toggle" data-toggle="dropdown">Small button <span class="caret"></span></button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
          <button class="btn btn-mini dropdown-toggle" data-toggle="dropdown">Mini button <span class="caret"></span></button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
      </div><!-- /btn-toolbar -->
    </div><!--/span-->
    <div class="span4">
328
329
330
      <h3>Requires javascript</h3>
      <p>Button dropdowns require the <a href="./javascript.html#dropdowns">Bootstrap dropdown plugin</a> to function.</p>
      <p>In some cases&mdash;like mobile&mdash;dropdown menus will extend outside the viewport. You need to resolve the alignment manually or with custom javascript.</p>
331
332
    </div><!--/span-->
  </div><!--/row-->
333
  <br>
334

335
  <h2>Split button dropdowns</h2>
Mark Otto's avatar
Mark Otto committed
336
337
  <div class="row">
    <div class="span4">
338
      <h3>Overview and examples</h3>
Mark Otto's avatar
Mark Otto committed
339
      <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>
340
341
      <div class="btn-toolbar" style="margin-top: 18px;">
        <div class="btn-group">
342
343
          <button class="btn">Action</button>
          <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
344
345
346
347
348
349
350
351
352
          <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">
353
354
          <button class="btn btn-primary">Action</button>
          <button class="btn btn-primary dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
355
356
357
358
359
360
361
362
363
          <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">
364
365
          <button class="btn btn-danger">Danger</button>
          <button class="btn btn-danger dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
366
367
368
369
370
371
372
373
374
375
          <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">
376
        <div class="btn-group">
377
378
          <button class="btn btn-warning">Warning</button>
          <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
379
380
381
382
383
384
385
386
          <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 -->
387
        <div class="btn-group">
388
389
          <button class="btn btn-success">Success</button>
          <button class="btn btn-success dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
390
391
392
393
394
395
396
397
398
          <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">
399
400
          <button class="btn btn-info">Info</button>
          <button class="btn btn-info dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
401
402
403
404
405
406
407
408
          <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 -->
409
410
      </div>
      <div class="btn-toolbar">
411
        <div class="btn-group">
412
413
          <button class="btn btn-inverse">Inverse</button>
          <button class="btn btn-inverse dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
414
415
416
417
418
419
420
421
          <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 -->
422
423
424
425
426
      </div><!-- /btn-toolbar -->
      <h3>Right aligned menus</h3>
      <p>Add <code>.pull-right</code> to the <code>.dropdown-menu</code> of any button dropdown for right aligned menus.</p>
      <div class="btn-toolbar">
        <div class="btn-group">
427
          <button class="btn">Right aligned</button>
428
          <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
          <ul class="dropdown-menu pull-right">
            <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><!-- /btn-toolbar -->
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
  ...
  &lt;ul class="dropdown-menu pull-right"&gt;
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>
446
    </div>
Mark Otto's avatar
Mark Otto committed
447
448
    <div class="span8">
      <h3>Example markup</h3>
449
      <p>We expand on the normal button dropdowns to provide a second button action that operates as a separate dropdown trigger.</p>
450
451
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
452
453
  &lt;button class="btn"&gt;Action&lt;/button&gt;
  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
454
    &lt;span class="caret"&gt;&lt;/span&gt;
455
  &lt;/button&gt;
456
457
458
459
460
  &lt;ul class="dropdown-menu"&gt;
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>
461
462
463
464
      <h3>Dropup menus</h3>
      <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>
      <div class="btn-toolbar" style="margin-top: 9px;">
        <div class="btn-group dropup">
465
466
          <button class="btn">Dropup</button>
          <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
467
468
469
470
471
472
473
474
475
          <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 dropup">
476
477
          <button class="btn primary">Right dropup</button>
          <button class="btn primary dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
478
479
480
481
482
483
484
485
          <ul class="dropdown-menu pull-right">
            <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 -->
486
      </div>
487
488
<pre class="prettyprint linenums">
&lt;div class="btn-group dropup"&gt;
489
490
  &lt;button class="btn"&gt;Dropup&lt;/button&gt;
  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
491
    &lt;span class="caret"&gt;&lt;/span&gt;
492
  &lt;/button&gt;
493
494
495
496
497
498
  &lt;ul class="dropdown-menu"&gt;
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>

499
    </div>
Mark Otto's avatar
Mark Otto committed
500
501
  </div>
</section>
502

503
504


505
<!-- Nav, Tabs, & Pills
506
================================================== -->
507
<section id="navs">
508
  <div class="page-header">
509
    <h1>Nav, tabs, and pills <small>Highly customizable list-style navigation</small></h1>
510
  </div>
511

512
  <h2>Lightweight defaults <small>Same markup, different classes</small></h2>
513
  <div class="row">
514
515
516
    <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>
517
518
519
520
      <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>
521
522
523
    </div>
    <div class="span4">
      <h3>Basic tabs</h3>
nkryptic's avatar
nkryptic committed
524
      <p>Take a regular <code>&lt;ul&gt;</code> of links and add <code>.nav-tabs</code>:</p>
525
      <ul class="nav nav-tabs">
526
527
528
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
529
      </ul>
530
<pre class="prettyprint linenums">
531
&lt;ul class="nav nav-tabs"&gt;
532
533
534
535
536
537
538
  &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>
539
    </div>
540
541
    <div class="span4">
      <h3>Basic pills</h3>
nkryptic's avatar
nkryptic committed
542
      <p>Take that same HTML, but use <code>.nav-pills</code> instead:</p>
543
      <ul class="nav nav-pills">
544
545
546
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
547
      </ul>
548
<pre class="prettyprint linenums">
549
&lt;ul class="nav nav-pills"&gt;
550
551
552
553
554
555
556
  &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>
557
558
559
    </div>
  </div>

560
  <h2>Stackable <small>Make tabs or pills vertical</small></h2>
561
562
  <div class="row">
    <div class="span4">
563
      <h3>How to stack 'em</h3>
nkryptic's avatar
nkryptic committed
564
      <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>
565
566
    </div>
    <div class="span4">
567
      <h3>Stacked tabs</h3>
568
      <ul class="nav nav-tabs nav-stacked">
569
570
571
572
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
      </ul>
573
<pre class="prettyprint linenums">
574
&lt;ul class="nav nav-tabs nav-stacked"&gt;
575
576
577
  ...
&lt;/ul&gt;
</pre>
578
579
580
    </div>
    <div class="span4">
      <h3>Stacked pills</h3>
581
      <ul class="nav nav-pills nav-stacked">
582
583
584
585
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
      </ul>
586
<pre class="prettyprint linenums">
587
&lt;ul class="nav nav-pills nav-stacked"&gt;
588
589
590
591
  ...
&lt;/ul&gt;
</pre>
    </div>
592
593
  </div>

594
  <h2>Dropdowns <small>For advanced nav components</small></h2>
595
  <div class="row">
596
597
598
599
    <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>
600
    </div>
601
602
    <div class="span4">
      <h3>Tabs with dropdowns</h3>
603
      <ul class="nav nav-tabs">
604
        <li class="active"><a href="#">Home</a></li>
Burak Tuyan's avatar
Burak Tuyan committed
605
        <li><a href="#">Help</a></li>
606
607
608
609
610
611
612
613
614
615
        <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>
616
617
618
619
620
621
622
623
624
625
        <li class="dropdown">
          <a class="dropdown-toggle" data-toggle="dropdown" href="#">Dropup <b class="caret bottom-up"></b></a>
          <ul class="dropdown-menu bottom-up pull-right">
            <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>
626
      </ul>
627
<pre class="prettyprint linenums">
628
&lt;ul class="nav nav-tabs"&gt;
629
  &lt;li class="dropdown"&gt;
630
    &lt;a class="dropdown-toggle"
631
632
633
634
635
636
637
638
639
640
       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;
641
</pre>
642
643
644
    </div>
    <div class="span4">
      <h3>Pills with dropdowns</h3>
645
      <ul class="nav nav-pills">
646
        <li class="active"><a href="#">Home</a></li>
Burak Tuyan's avatar
Burak Tuyan committed
647
        <li><a href="#">Help</a></li>
648
649
650
651
652
653
654
655
656
657
        <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>
658
659
660
661
662
663
664
665
666
667
        <li class="dropdown">
          <a class="dropdown-toggle" data-toggle="dropdown" href="#">Dropup <b class="caret bottom-up"></b></a>
          <ul class="dropdown-menu bottom-up pull-right">
            <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>
668
      </ul>
669
<pre class="prettyprint linenums">
670
&lt;ul class="nav nav-pills"&gt;
671
  &lt;li class="dropdown"&gt;
672
    &lt;a class="dropdown-toggle"
673
674
675
676
677
678
679
680
681
682
       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;
683
684
</pre>
    </div>
685
686
  </div>

687
688
689
690
691
692
  <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>
693
      <hr>
694
695
      <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>
696
697
698
699
700
701
702
703
704
      <h4>Horizontal dividers</h4>
      <p>Add a horizontal divider by creating an empty list item with the class <code>.divider</code>, like so:</p>
<pre class="prettyprint linenums">
&lt;ul class="nav nav-list"&gt;
  ...
  &lt;li class="divider"&gt;&lt;/li&gt;
  ...
&lt;/ul&gt;
</pre>
705
706
    </div>
    <div class="span4">
707
      <h3>Example nav list</h3>
nkryptic's avatar
nkryptic committed
708
      <p>Take a list of links and add <code>class="nav nav-list"</code>:</p>
709
      <div class="well" style="padding: 8px 0;">
710
        <ul class="nav nav-list">
711
          <li class="nav-header">List header</li>
712
          <li class="active"><a href="#">Home</a></li>
713
714
715
716
717
          <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>
718
          <li class="divider"></li>
719
          <li><a href="#">Help</a></li>
720
        </ul>
721
      </div> <!-- /well -->
722
<pre class="prettyprint linenums">
723
&lt;ul class="nav nav-list"&gt;
724
725
726
  &lt;li class="nav-header"&gt;
    List header
  &lt;/li&gt;
727
  &lt;li class="active"&gt;
728
    &lt;a href="#"&gt;Home&lt;/a&gt;
729
  &lt;/li&gt;
730
731
  &lt;li&gt;
    &lt;a href="#"&gt;Library&lt;/a&gt;
732
  &lt;/li&gt;
733
  ...
734
&lt;/ul&gt;
735
736
737
738
739
740
</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;">
741
        <ul class="nav nav-list">
742
          <li class="nav-header">List header</li>
Mark Otto's avatar
Mark Otto committed
743
744
745
          <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>
746
          <li class="nav-header">Another list header</li>
Mark Otto's avatar
Mark Otto committed
747
748
          <li><a href="#"><i class="icon-user"></i> Profile</a></li>
          <li><a href="#"><i class="icon-cog"></i> Settings</a></li>
749
          <li class="divider"></li>
Mark Otto's avatar
Mark Otto committed
750
          <li><a href="#"><i class="icon-flag"></i> Help</a></li>
751
752
753
        </ul>
      </div> <!-- /well -->
<pre class="prettyprint linenums">
754
&lt;ul class="nav nav-list"&gt;
755
756
757
  ...
  &lt;li&gt;
    &lt;a href="#"&gt;
Mark Otto's avatar
Mark Otto committed
758
      &lt;i class="icon-book"&gt;&lt;/i&gt;
759
760
761
762
763
      Library
    &lt;/a&gt;
  &lt;/li&gt;
  ...
&lt;/ul&gt;
764
</pre>
765
766
    </div>
  </div>
767

768

769
  <h2>Tabbable nav <small>Bring tabs to life via javascript</small></h2>
770
771
772
  <div class="row">
    <div class="span4">
      <h3>What's included</h3>
773
      <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>
774
775
      <p>Changing between them is easy and only requires changing very little markup.</p>
    </div>
776
    <div class="span4">
777
      <h3>Tabbable example</h3>
nkryptic's avatar
nkryptic committed
778
      <p>To make tabs tabbable, wrap the <code>.nav-tabs</code> in another div with class <code>.tabbable</code>.</p>
779
      <div class="tabbable" style="margin-bottom: 9px;">
780
        <ul class="nav nav-tabs">
781
782
783
          <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>
784
785
786
        </ul>
        <div class="tab-content">
          <div class="tab-pane active" id="1">
787
            <p>I'm in Section 1.</p>
788
789
          </div>
          <div class="tab-pane" id="2">
790
            <p>Howdy, I'm in Section 2.</p>
791
792
          </div>
          <div class="tab-pane" id="3">
793
            <p>What up girl, this is Section 3.</p>
794
795
          </div>
        </div>
796
      </div> <!-- /tabbable -->
797
798
799
800
    </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
801
      <p><a class="btn" href="./javascript.html#tabs">Get the javascript &rarr;</a></p>
802
803
    </div>
  </div>
804

805
806
  <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>
807
808
<pre class="prettyprint linenums">
&lt;div class="tabbable"&gt;
809
  &lt;ul class="nav nav-tabs"&gt;
810
811
812
813
814
815
816
817
818
819
820
821
822
    &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>
823

824
825
826
827
828
829
830
831
832
  <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>
833
          </div>
834
835
836
837
838
          <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>
839
840
          </div>
        </div>
841
        <ul class="nav nav-tabs">
842
843
844
845
846
          <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 -->
847
<pre class="prettyprint linenums" style="margin-top: 11px;">
Mark Otto's avatar
Mark Otto committed
848
&lt;div class="tabbable tabs-below"&gt;
849
850
851
  &lt;div class="tab-content"&gt;
    ...
  &lt;/div&gt;
852
853
854
  &lt;ul class="nav nav-tabs"&gt;
    ...
  &lt;/ul&gt;
855
856
&lt;/div&gt;
</pre>
857
858
859
860
861
    </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">
862
        <ul class="nav nav-tabs">
863
864
865
866
          <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>
867
        <div class="tab-content">
868
869
          <div class="tab-pane active" id="lA">
            <p>I'm in Section A.</p>
870
          </div>
871
872
          <div class="tab-pane" id="lB">
            <p>Howdy, I'm in Section B.</p>
873
          </div>
874
875
          <div class="tab-pane" id="lC">
            <p>What up girl, this is Section C.</p>
876
877
          </div>
        </div>
878
      </div> <!-- /tabbable -->
879
880
<pre class="prettyprint linenums">
&lt;div class="tabbable tabs-left"&gt;
881
  &lt;ul class="nav nav-tabs"&gt;
882
883
884
885
886
887
888
    ...
  &lt;/ul&gt;
  &lt;div class="tab-content"&gt;
    ...
  &lt;/div&gt;
&lt;/div&gt;
</pre>
889
890
891
892
893
    </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">
894
        <ul class="nav nav-tabs">
895
896
897
          <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>
898
        </ul>
899
900
901
902
903
904
905
906
907
908
909
910
        <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 -->
911
912
<pre class="prettyprint linenums">
&lt;div class="tabbable tabs-right"&gt;
913
  &lt;ul class="nav nav-tabs"&gt;
914
915
916
917
918
919
920
    ...
  &lt;/ul&gt;
  &lt;div class="tab-content"&gt;
    ...
  &lt;/div&gt;
&lt;/div&gt;
</pre>
921
922
    </div>
  </div>
923

924
925
926
927
928
929
930
931
932
933
934
935
</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>
936
  <div class="navbar">
937
    <div class="navbar-inner">
938
      <div class="container">
939
        <a class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse">
Mark Otto's avatar
Mark Otto committed
940
941
942
          <span class="icon-bar"></span>
          <span class="icon-bar"></span>
          <span class="icon-bar"></span>
943
        </a>
944
        <a class="brand" href="#">Project name</a>
945
946
947
948
949
950
951
952
953
954
955
956
957
        <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>
958
                <li class="nav-header">Nav header</li>
959
                <li><a href="#">Separated link</a></li>
960
                <li><a href="#">One more separated link</a></li>
961
962
963
964
965
966
967
968
              </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>
969
            <li class="divider-vertical"></li>
970
971
972
973
974
975
976
977
978
979
980
981
            <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 -->
982
983
984
985
986
987
988
989
990
      </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">
991
&lt;div class="navbar"&gt;
992
  &lt;div class="navbar-inner"&gt;
993
    &lt;div class="container"&gt;
994
995
996
997
998
      ...
    &lt;/div&gt;
  &lt;/div&gt;
&lt;/div&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
999
      <h3>Fixed navbar</h3>
1000
      <p>Fix the navbar to the top or bottom of the viewport with an additional class on the outermost div, <code>.navbar</code>.</p>
For faster browsing, not all history is shown. View entire blame