components.html 83.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">
Mark Otto's avatar
Mark Otto committed
23
    <link rel="apple-touch-icon-precomposed" sizes="144x144" href="assets/ico/apple-touch-icon-144-precomposed.png">
24
    <link rel="apple-touch-icon-precomposed" sizes="114x114" href="assets/ico/apple-touch-icon-114-precomposed.png">
25
26
    <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">
27

28
29
  </head>

30
  <body data-spy="scroll" data-target=".bs-docs-sidebar" data-offset="10">
31

Mark Otto's avatar
Mark Otto committed
32
33
34
35
    <!-- Navbar
    ================================================== -->
    <div class="navbar navbar-fixed-top">
      <div class="navbar-inner">
36
        <div class="container">
Purwandi's avatar
Purwandi committed
37
          <button type="button" class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse">
Mark Otto's avatar
Mark Otto committed
38
39
40
41
42
43
44
45
            <span class="icon-bar"></span>
            <span class="icon-bar"></span>
            <span class="icon-bar"></span>
          </button>
          <a class="brand" href="./index.html">Bootstrap</a>
          <div class="nav-collapse collapse">
            <ul class="nav">
              <li class="">
Mark Otto's avatar
Mark Otto committed
46
                <a href="./index.html">Home</a>
Mark Otto's avatar
Mark Otto committed
47
              </li>
48
49
50
              <li class="">
                <a href="./getting-started.html">Get started</a>
              </li>
Mark Otto's avatar
Mark Otto committed
51
52
53
54
55
56
57
58
59
60
              <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="">
Mark Otto's avatar
Mark Otto committed
61
                <a href="./javascript.html">Javascript</a>
Mark Otto's avatar
Mark Otto committed
62
              </li>
63
64
65
              <li class="">
                <a href="./extend.html">Extend</a>
              </li>
Mark Otto's avatar
Mark Otto committed
66
67
68
69
70
71
            </ul>
          </div>
        </div>
      </div>
    </div>

72
<!-- Subhead
Mark Otto's avatar
Mark Otto committed
73
74
================================================== -->
<header class="jumbotron subhead" id="overview">
75
76
77
78
  <div class="container">
    <h1>Components</h1>
    <p class="lead">Dozens of reusable components built to provide navigation, alerts, popovers, and more.</p>
  </div>
79
80
</header>

81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
<div class="container">


  <!-- Docs nav
  ================================================== -->
  <div class="row">
    <div class="span3 bs-docs-sidebar">
      <ul class="nav nav-list bs-docs-sidenav">
        <li><a href="#dropdowns">Dropdowns <i class="icon-chevron-right"></i></a></li>
        <li><a href="#buttonGroups">Button groups <i class="icon-chevron-right"></i></a></li>
        <li><a href="#buttonDropdowns">Button dropdowns <i class="icon-chevron-right"></i></a></li>
        <li><a href="#navs">Navs <i class="icon-chevron-right"></i></a></li>
        <li><a href="#navbar">Navbar <i class="icon-chevron-right"></i></a></li>
        <li><a href="#breadcrumbs">Breadcrumbs <i class="icon-chevron-right"></i></a></li>
        <li><a href="#pagination">Pagination <i class="icon-chevron-right"></i></a></li>
        <li><a href="#labels-badges">Labels and badges <i class="icon-chevron-right"></i></a></li>
        <li><a href="#typography">Typography <i class="icon-chevron-right"></i></a></li>
        <li><a href="#thumbnails">Thumbnails <i class="icon-chevron-right"></i></a></li>
        <li><a href="#alerts">Alerts <i class="icon-chevron-right"></i></a></li>
        <li><a href="#progress">Progress bars <i class="icon-chevron-right"></i></a></li>
        <li><a href="#misc">Misc <i class="icon-chevron-right"></i></a></li>
      </ul>
    </div>
    <div class="span9">
105

106
107


108
109
110
111
112
113
      <!-- Dropdowns
      ================================================== -->
      <section id="dropdowns">
        <div class="page-header">
          <h1>Dropdown menus</h1>
        </div>
114

115
116
117
118
119
120
121
122
123
124
125
126
        <h2>Example</h2>
        <p>An isolated (without dropdown toggle) dropdown menu example, designed to be used with the <a href="./javascript.html#dropdowns">dropdown javascript plugin</a>.</p>
        <div class="bs-docs-example">
          <div class="dropdown clearfix">
            <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu" style="display: block; position: static; margin-bottom: 5px;">
              <li><a tabindex="-1" href="#">Action</a></li>
              <li><a tabindex="-1" href="#">Another action</a></li>
              <li><a tabindex="-1" href="#">Something else here</a></li>
              <li class="divider"></li>
              <li><a tabindex="-1" href="#">Separated link</a></li>
            </ul>
          </div>
127
        </div>
128
129
130
131
132
133
134
135
136
137
138
<pre class="prettyprint linenums">
&lt;ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu"&gt;
  &lt;li&gt;&lt;a tabindex="-1" href="#"&gt;Action&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a tabindex="-1" href="#"&gt;Another action&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a tabindex="-1" href="#"&gt;Something else here&lt;/a&gt;&lt;/li&gt;
  &lt;li class="divider"&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a tabindex="-1" href="#"&gt;Separated link&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
</pre>


139
        <hr class="bs-docs-separator">
140
141


142
143
        <h2>Markup</h2>
        <p>Dropdowns require...</p>
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164

<pre class="prettyprint linenums">
&lt;ul class="nav nav-pills"&gt;
  &lt;li class="active"&gt;&lt;a href="#"&gt;Regular link&lt;/a&gt;&lt;/li&gt;
  &lt;li class="dropdown" id="menu1"&gt;
    &lt;a id="dLabel" role="button" class="dropdown-toggle" data-toggle="dropdown" href="#menu1"&gt;
      Dropdown
      &lt;b class="caret"&gt;&lt;/b&gt;
    &lt;/a&gt;
    &lt;ul class="dropdown-menu" role="menu" aria-labelledby="dLabel"&gt;
      &lt;li&gt;&lt;a tabindex="-1" href="#"&gt;Action&lt;/a&gt;&lt;/li&gt;
      &lt;li&gt;&lt;a tabindex="-1" href="#"&gt;Another action&lt;/a&gt;&lt;/li&gt;
      &lt;li&gt;&lt;a tabindex="-1" href="#"&gt;Something else here&lt;/a&gt;&lt;/li&gt;
      &lt;li class="divider"&gt;&lt;/li&gt;
      &lt;li&gt;&lt;a tabindex="-1" href="#"&gt;Separated link&lt;/a&gt;&lt;/li&gt;
    &lt;/ul&gt;
  &lt;/li&gt;
  ...
&lt;/ul&gt;</pre>


165
        <hr class="bs-docs-separator">
166
167


168
169
        <h2>Options</h2>
        <p>...</p>
170

171
172
        <h3>Dropup menus</h3>
        <p>...</p>
173

174
175
        <h3>Aligning the menus</h3>
        <p>...</p>
176
177


178
        <hr class="bs-docs-separator">
179
180


181
182
        <h2>Usage</h2>
        <p>...</p>
183
184


185
      </section>
186
187


188

Mark Otto's avatar
Mark Otto committed
189

190
191
192
193
194
195
      <!-- Button Groups
      ================================================== -->
      <section id="buttonGroups">
        <div class="page-header">
          <h1>Button groups</h1>
        </div>
196

197
198
        <h2>Examples</h2>
        <p>Two basic options, along with two more specific variations.</p>
Mark Otto's avatar
Mark Otto committed
199

200
201
202
203
204
205
206
207
        <h3>Single button group</h3>
        <p>Wrap a series of buttons with <code>.btn</code> in <code>.btn-group</code>.</p>
        <div class="bs-docs-example">
          <div class="btn-group" style="margin: 9px 0 5px;">
            <button class="btn">Left</button>
            <button class="btn">Middle</button>
            <button class="btn">Right</button>
          </div>
208
        </div>
209
210
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
211
212
213
  &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;
214
215
&lt;/div&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
216

217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
        <h3>Multiple button groups</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>
        <div class="bs-docs-example">
          <div class="btn-toolbar" style="margin: 0;">
            <div class="btn-group">
              <button class="btn">1</button>
              <button class="btn">2</button>
              <button class="btn">3</button>
              <button class="btn">4</button>
            </div>
            <div class="btn-group">
              <button class="btn">5</button>
              <button class="btn">6</button>
              <button class="btn">7</button>
            </div>
            <div class="btn-group">
              <button class="btn">8</button>
            </div>
235
236
          </div>
        </div>
237
238
239
240
241
242
243
<pre class="prettyprint linenums">
&lt;div class="btn-toolbar"&gt;
  &lt;div class="btn-group"&gt;
    ...
  &lt;/div&gt;
&lt;/div&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
244

245
246
247
248
249
250
251
252
253
        <h3>Vertical button groups</h3>
        <p>Make a set of buttons appear vertically stacked rather than horizontally.</p>
        <div class="bs-docs-example">
          <div class="btn-group btn-group-vertical">
            <button type="button" class="btn"><i class="icon-align-left"></i></button>
            <button type="button" class="btn"><i class="icon-align-center"></i></button>
            <button type="button" class="btn"><i class="icon-align-right"></i></button>
            <button type="button" class="btn"><i class="icon-align-justify"></i></button>
          </div>
254
        </div>
255
256
257
258
259
260
261
<pre class="prettyprint linenums">
&lt;div class="btn-group btn-group-vertical"&gt;
  ...
&lt;/div&gt;
</pre>


262
        <hr class="bs-docs-separator">
263
264


265
266
        <h4>Checkbox and radio flavors</h4>
        <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>
Mark Otto's avatar
Mark Otto committed
267

268
269
270
        <h4>Dropdowns in button groups</h4>
        <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>
      </section>
271
272
273



274
275
276
277
278
279
      <!-- Split button dropdowns
      ================================================== -->
      <section id="buttonDropdowns">
        <div class="page-header">
          <h1>Button dropdown menus</h1>
        </div>
280

281

282
283
284
285
286
287
288
289
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
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
        <h2>Overview and examples</h2>
        <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="bs-docs-example">
          <div class="btn-toolbar" style="margin: 0;">
            <div class="btn-group">
              <button class="btn dropdown-toggle" data-toggle="dropdown">Action <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-primary dropdown-toggle" data-toggle="dropdown">Action <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-danger dropdown-toggle" data-toggle="dropdown">Danger <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-warning dropdown-toggle" data-toggle="dropdown">Warning <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-success dropdown-toggle" data-toggle="dropdown">Success <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-info dropdown-toggle" data-toggle="dropdown">Info <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-inverse dropdown-toggle" data-toggle="dropdown">Inverse <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>
358
359
360
361
362
363
364
365
366
367
368
<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>
369

370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
        <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="bs-docs-example">
          <div class="btn-toolbar" style="margin: 0;">
            <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>
406

407
408
409
        <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>
410

411

412
        <hr class="bs-docs-separator">
413

414

415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
        <h2>Split button dropdowns</h2>
        <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>
        <div class="bs-docs-example">
          <div class="btn-toolbar" style="margin: 0;">
            <div class="btn-group">
              <button class="btn">Action</button>
              <button class="btn dropdown-toggle" data-toggle="dropdown"><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-primary">Action</button>
              <button class="btn btn-primary dropdown-toggle" data-toggle="dropdown"><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-danger">Danger</button>
              <button class="btn btn-danger dropdown-toggle" data-toggle="dropdown"><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-warning">Warning</button>
              <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown"><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-success">Success</button>
              <button class="btn btn-success dropdown-toggle" data-toggle="dropdown"><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-info">Info</button>
              <button class="btn btn-info dropdown-toggle" data-toggle="dropdown"><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-inverse">Inverse</button>
              <button class="btn btn-inverse dropdown-toggle" data-toggle="dropdown"><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>
498
499
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
500
501
502
503
504
  &lt;button class="btn"&gt;Action&lt;/button&gt;
  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
    &lt;span class="caret"&gt;&lt;/span&gt;
  &lt;/button&gt;
  &lt;ul class="dropdown-menu"&gt;
505
506
507
508
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>
509

510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
        <h3>Sizes</h3>
        <p>Utilize the extra button classes <code>.btn-mini</code>, <code>.btn-small</code>, or <code>.btn-large</code> for sizing.</p>
        <div class="bs-docs-example">
          <div class="btn-toolbar">
            <div class="btn-group">
              <button class="btn btn-large">Large action</button>
              <button class="btn btn-large dropdown-toggle" data-toggle="dropdown"><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 class="btn-toolbar">
            <div class="btn-group">
              <button class="btn btn-small">Small action</button>
              <button class="btn btn-small dropdown-toggle" data-toggle="dropdown"><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 class="btn-toolbar">
            <div class="btn-group">
              <button class="btn btn-mini">Mini action</button>
              <button class="btn btn-mini dropdown-toggle" data-toggle="dropdown"><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>
553
554
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
555
556
  &lt;button class="btn btn-mini"&gt;Action&lt;/button&gt;
  &lt;button class="btn btn-mini dropdown-toggle" data-toggle="dropdown"&gt;
557
    &lt;span class="caret"&gt;&lt;/span&gt;
558
  &lt;/button&gt;
559
560
561
562
563
  &lt;ul class="dropdown-menu"&gt;
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>
564

565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
        <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="bs-docs-example">
          <div class="btn-toolbar" style="margin: 0;">
            <div class="btn-group dropup">
              <button class="btn">Dropup</button>
              <button class="btn dropdown-toggle" data-toggle="dropdown"><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 dropup">
              <button class="btn primary">Right dropup</button>
              <button class="btn primary dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
              <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>
592
        </div>
593
594
<pre class="prettyprint linenums">
&lt;div class="btn-group dropup"&gt;
595
596
  &lt;button class="btn"&gt;Dropup&lt;/button&gt;
  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
597
    &lt;span class="caret"&gt;&lt;/span&gt;
598
  &lt;/button&gt;
599
600
601
602
603
604
  &lt;ul class="dropdown-menu"&gt;
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>

605
      </section>
606

607
608


609
610
611
612
613
614
      <!-- Nav, Tabs, & Pills
      ================================================== -->
      <section id="navs">
        <div class="page-header">
          <h1>Nav: tabs, pills, and lists</small></h1>
        </div>
615

616
617
        <h2>Lightweight defaults <small>Same markup, different classes</small></h2>
        <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>
Mark Otto's avatar
Mark Otto committed
618

619
620
621
622
623
624
625
626
627
        <h3>Basic tabs</h3>
        <p>Take a regular <code>&lt;ul&gt;</code> of links and add <code>.nav-tabs</code>:</p>
        <div class="bs-docs-example">
          <ul class="nav nav-tabs">
            <li class="active"><a href="#">Home</a></li>
            <li><a href="#">Profile</a></li>
            <li><a href="#">Messages</a></li>
          </ul>
        </div>
628
<pre class="prettyprint linenums">
629
&lt;ul class="nav nav-tabs"&gt;
630
631
632
633
634
635
636
  &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>
Mark Otto's avatar
Mark Otto committed
637

638
639
640
641
642
643
644
645
646
        <h3>Basic pills</h3>
        <p>Take that same HTML, but use <code>.nav-pills</code> instead:</p>
        <div class="bs-docs-example">
          <ul class="nav nav-pills">
            <li class="active"><a href="#">Home</a></li>
            <li><a href="#">Profile</a></li>
            <li><a href="#">Messages</a></li>
          </ul>
        </div>
647
<pre class="prettyprint linenums">
648
&lt;ul class="nav nav-pills"&gt;
649
650
651
652
653
654
  &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;
655
656
</pre>

657
658
659
660
661
662
663
664
665
        <h3>Disabled state</h3>
        <p>For any nav component (tabs, pills, or list), add <code>.disabled</code> for <strong>gray links and no hover effects</strong>. Links will remain clickable, however, unless custom javascript is implemented to prevent those clicks.</p>
        <div class="bs-docs-example">
          <ul class="nav nav-pills">
            <li><a href="#">Clickable link</a></li>
            <li><a href="#">Clickable link</a></li>
            <li class="disabled"><a href="#">Disabled link</a></li>
          </ul>
        </div>
666
667
668
669
670
671
<pre class="prettyprint linenums">
&lt;ul class="nav nav-pills"&gt;
  ...
  &lt;li class="disabled"&gt;&lt;a href="#"&gt;Home&lt;/a&gt;&lt;/li&gt;
  ...
&lt;/ul&gt;
672
</pre>
Mark Otto's avatar
Mark Otto committed
673

674
675
        <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>
676

Mark Otto's avatar
Mark Otto committed
677

678
        <hr class="bs-docs-separator">
679
680


681
682
        <h2>Stackable</h2>
        <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>
Mark Otto's avatar
Mark Otto committed
683

684
685
686
687
688
689
690
691
        <h3>Stacked tabs</h3>
        <div class="bs-docs-example">
          <ul class="nav nav-tabs nav-stacked">
            <li class="active"><a href="#">Home</a></li>
            <li><a href="#">Profile</a></li>
            <li><a href="#">Messages</a></li>
          </ul>
        </div>
692
<pre class="prettyprint linenums">
693
&lt;ul class="nav nav-tabs nav-stacked"&gt;
694
695
696
  ...
&lt;/ul&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
697

698
699
700
701
702
703
704
705
        <h3>Stacked pills</h3>
        <div class="bs-docs-example">
          <ul class="nav nav-pills nav-stacked">
            <li class="active"><a href="#">Home</a></li>
            <li><a href="#">Profile</a></li>
            <li><a href="#">Messages</a></li>
          </ul>
        </div>
706
<pre class="prettyprint linenums">
707
&lt;ul class="nav nav-pills nav-stacked"&gt;
708
709
710
  ...
&lt;/ul&gt;
</pre>
711

Mark Otto's avatar
Mark Otto committed
712

713
        <hr class="bs-docs-separator">
714
715


716
717
        <h2>Dropdowns</h2>
        <p>Add dropdown menus with a little extra HTML and the <a href="./javascript.html#dropdowns">dropdowns javascript plugin</a>.</p>
Mark Otto's avatar
Mark Otto committed
718

719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
        <h3>Tabs with dropdowns</h3>
        <div class="bs-docs-example">
          <ul class="nav nav-tabs">
            <li class="active"><a href="#">Home</a></li>
            <li><a href="#">Help</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>
        </div>
736
<pre class="prettyprint linenums">
737
&lt;ul class="nav nav-tabs"&gt;
738
  &lt;li class="dropdown"&gt;
739
    &lt;a class="dropdown-toggle"
740
741
742
743
744
745
746
747
748
749
       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;
750
</pre>
Mark Otto's avatar
Mark Otto committed
751

752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
        <h3>Pills with dropdowns</h3>
        <div class="bs-docs-example">
          <ul class="nav nav-pills">
            <li class="active"><a href="#">Home</a></li>
            <li><a href="#">Help</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>
        </div>
769
<pre class="prettyprint linenums">
770
&lt;ul class="nav nav-pills"&gt;
771
  &lt;li class="dropdown"&gt;
772
    &lt;a class="dropdown-toggle"
773
774
775
776
777
778
779
780
781
782
       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;
783
</pre>
784

Mark Otto's avatar
Mark Otto committed
785

786
        <hr class="bs-docs-separator">
787
788


789
790
        <h2>Nav lists</h2>
        <p>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>
Mark Otto's avatar
Mark Otto committed
791

792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
        <h3>Example nav list</h3>
        <p>Take a list of links and add <code>class="nav nav-list"</code>:</p>
        <div class="bs-docs-example">
          <div class="well" style="max-width: 340px; padding: 8px 0;">
            <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>
              <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 class="divider"></li>
              <li><a href="#">Help</a></li>
            </ul>
          </div> <!-- /well -->
        </div>
809
<pre class="prettyprint linenums">
810
&lt;ul class="nav nav-list"&gt;
811
812
813
  &lt;li class="nav-header"&gt;List header&lt;/li&gt;
  &lt;li class="active"&gt;&lt;a href="#"&gt;Home&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Library&lt;/a&gt;&lt;/li&gt;
814
  ...
815
816
&lt;/ul&gt;
</pre>
817
818
819
820
        <p>
          <span class="label label-info">Note</span>
          For nesting within a nav list, include <code>class="nav nav-list"</code> on any nested <code>&lt;ul&gt;</code>.
        </p>
821

822
823
        <h3>Horizontal dividers</h3>
        <p>Add a horizontal divider by creating an empty list item with the class <code>.divider</code>, like so:</p>
824
825
826
827
828
829
<pre class="prettyprint linenums">
&lt;ul class="nav nav-list"&gt;
  ...
  &lt;li class="divider"&gt;&lt;/li&gt;
  ...
&lt;/ul&gt;
830
</pre>
831
832


833
        <hr class="bs-docs-separator">
834

Mark Otto's avatar
Mark Otto committed
835

836
837
        <h2>Tabbable nav</h2>
        <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>
Mark Otto's avatar
Mark Otto committed
838

839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
        <h3>Tabbable example</h3>
        <p>To make tabs tabbable, create a <code>.tab-pane</code> with unique ID for every tab and wrap them in <code>.tab-content</code>.</p>
        <div class="bs-docs-example">
          <div class="tabbable" style="margin-bottom: 18px;">
            <ul class="nav nav-tabs">
              <li class="active"><a href="#tab1" data-toggle="tab">Section 1</a></li>
              <li><a href="#tab2" data-toggle="tab">Section 2</a></li>
              <li><a href="#tab3" data-toggle="tab">Section 3</a></li>
            </ul>
            <div class="tab-content" style="padding-bottom: 9px; border-bottom: 1px solid #ddd;">
              <div class="tab-pane active" id="tab1">
                <p>I'm in Section 1.</p>
              </div>
              <div class="tab-pane" id="tab2">
                <p>Howdy, I'm in Section 2.</p>
              </div>
              <div class="tab-pane" id="tab3">
                <p>What up girl, this is Section 3.</p>
              </div>
858
            </div>
859
860
          </div> <!-- /tabbable -->
        </div>
861
<pre class="prettyprint linenums">
862
&lt;div class="tabbable"&gt; &lt;!-- Only required for left/right tabs --&gt;
863
  &lt;ul class="nav nav-tabs"&gt;
864
865
    &lt;li class="active"&gt;&lt;a href="#tab1" data-toggle="tab"&gt;Section 1&lt;/a&gt;&lt;/li&gt;
    &lt;li&gt;&lt;a href="#tab2" data-toggle="tab"&gt;Section 2&lt;/a&gt;&lt;/li&gt;
866
867
  &lt;/ul&gt;
  &lt;div class="tab-content"&gt;
868
    &lt;div class="tab-pane active" id="tab1"&gt;
869
870
      &lt;p&gt;I'm in Section 1.&lt;/p&gt;
    &lt;/div&gt;
871
    &lt;div class="tab-pane" id="tab2"&gt;
872
873
874
875
876
      &lt;p&gt;Howdy, I'm in Section 2.&lt;/p&gt;
    &lt;/div&gt;
  &lt;/div&gt;
&lt;/div&gt;
</pre>
877

878
879
        <h4>Fade in tabs</h4>
        <p>To make tabs fade in, add <code>.fade</code> to each <code>.tab-pane</code>.</p>
880

881
882
        <h4>Requires jQuery plugin</h4>
        <p>All tabbable tabs are powered by our lightweight jQuery plugin. Read more about how to bring tabbable tabs to life <a href="./javascript.html#tabs">on the javascript docs page</a>.</p>
883

884
        <h3>Tabbable in any direction</h3>
885

886
887
888
889
890
891
892
893
894
895
896
897
898
899
        <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="bs-docs-example">
          <div class="tabbable tabs-below">
            <div class="tab-content">
              <div class="tab-pane active" id="A">
                <p>I'm in Section A.</p>
              </div>
              <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>
              </div>
900
            </div>
901
902
903
904
905
906
907
            <ul class="nav nav-tabs">
              <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 -->
        </div>
908
<pre class="prettyprint linenums">
Mark Otto's avatar
Mark Otto committed
909
&lt;div class="tabbable tabs-below"&gt;
910
911
912
  &lt;div class="tab-content"&gt;
    ...
  &lt;/div&gt;
913
914
915
  &lt;ul class="nav nav-tabs"&gt;
    ...
  &lt;/ul&gt;
916
917
&lt;/div&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
918

919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
        <h4>Tabs on the left</h4>
        <p>Swap the class to put tabs on the left.</p>
        <div class="bs-docs-example">
          <div class="tabbable tabs-left">
            <ul class="nav nav-tabs">
              <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>
            <div class="tab-content">
              <div class="tab-pane active" id="lA">
                <p>I'm in Section A.</p>
              </div>
              <div class="tab-pane" id="lB">
                <p>Howdy, I'm in Section B.</p>
              </div>
              <div class="tab-pane" id="lC">
                <p>What up girl, this is Section C.</p>
              </div>
938
            </div>
939
940
          </div> <!-- /tabbable -->
        </div>
941
942
<pre class="prettyprint linenums">
&lt;div class="tabbable tabs-left"&gt;
943
  &lt;ul class="nav nav-tabs"&gt;
944
945
946
947
948
949
950
    ...
  &lt;/ul&gt;
  &lt;div class="tab-content"&gt;
    ...
  &lt;/div&gt;
&lt;/div&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
951

952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
        <h4>Tabs on the right</h4>
        <p>Swap the class to put tabs on the right.</p>
        <div class="bs-docs-example">
          <div class="tabbable tabs-right">
            <ul class="nav nav-tabs">
              <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>
            </ul>
            <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>
971
            </div>
972
973
          </div> <!-- /tabbable -->
        </div>
974
975
<pre class="prettyprint linenums">
&lt;div class="tabbable tabs-right"&gt;
976
  &lt;ul class="nav nav-tabs"&gt;
977
978
979
980
981
982
983
    ...
  &lt;/ul&gt;
  &lt;div class="tab-content"&gt;
    ...
  &lt;/div&gt;
&lt;/div&gt;
</pre>
984

985
      </section>
986
987
988



989
990
991
992
993
994
      <!-- Navbar
      ================================================== -->
      <section id="navbar">
        <div class="page-header">
          <h1>Navbar</h1>
        </div>
995

996

997
998
999
1000
        <h2>Basic navbar</h2>
        <p>To start, navbars are static (not fixed to the top) and include support for a project name and basic navigation. Place one anywhere within a <code>.container</code>, which sets the width of your site and content.</p>
        <div class="bs-docs-example">
          <div class="navbar">
For faster browsing, not all history is shown. View entire blame