components.html 83.8 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
48
49
50
51
52
53
54
55
56
57
              </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="">
Mark Otto's avatar
Mark Otto committed
58
                <a href="./javascript.html">Javascript</a>
Mark Otto's avatar
Mark Otto committed
59
              </li>
60
61
62
              <li class="">
                <a href="./extend.html">Extend</a>
              </li>
Mark Otto's avatar
Mark Otto committed
63
64
65
66
67
68
            </ul>
          </div>
        </div>
      </div>
    </div>

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

78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
<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">
102

103
104


105
106
107
108
109
110
      <!-- Dropdowns
      ================================================== -->
      <section id="dropdowns">
        <div class="page-header">
          <h1>Dropdown menus</h1>
        </div>
111

112
113
114
115
116
117
118
119
120
121
122
123
        <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>
124
        </div>
125
126
127
128
129
130
131
132
133
134
135
<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>


136
        <hr class="bs-docs-separator">
137
138


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

<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>


162
        <hr class="bs-docs-separator">
163
164


165
166
        <h2>Options</h2>
        <p>...</p>
167

168
169
        <h3>Dropup menus</h3>
        <p>...</p>
170

171
172
        <h3>Aligning the menus</h3>
        <p>...</p>
173
174


175
        <hr class="bs-docs-separator">
176
177


178
179
        <h2>Usage</h2>
        <p>...</p>
180
181


182
      </section>
183
184


185

Mark Otto's avatar
Mark Otto committed
186

187
188
189
190
191
192
      <!-- Button Groups
      ================================================== -->
      <section id="buttonGroups">
        <div class="page-header">
          <h1>Button groups</h1>
        </div>
193

194
195
        <h2>Examples</h2>
        <p>Two basic options, along with two more specific variations.</p>
Mark Otto's avatar
Mark Otto committed
196

197
198
199
200
201
202
203
204
        <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>
205
        </div>
206
207
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
208
209
210
  &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;
211
212
&lt;/div&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
213

214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
        <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>
232
233
          </div>
        </div>
234
235
236
237
238
239
240
<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
241

242
243
244
245
246
247
248
249
250
        <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>
251
        </div>
252
253
254
255
256
257
258
<pre class="prettyprint linenums">
&lt;div class="btn-group btn-group-vertical"&gt;
  ...
&lt;/div&gt;
</pre>


259
        <hr class="bs-docs-separator">
260
261


262
263
        <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
264

265
266
267
        <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>
268
269
270



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

278

279
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
        <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>
355
356
357
358
359
360
361
362
363
364
365
<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>
366

367
368
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
        <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>
403

404
405
406
        <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>
407

408

409
        <hr class="bs-docs-separator">
410

411

412
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
        <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>
495
496
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
497
498
499
500
501
  &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;
502
503
504
505
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>
506

507
508
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
        <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>
550
551
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
552
553
  &lt;button class="btn btn-mini"&gt;Action&lt;/button&gt;
  &lt;button class="btn btn-mini dropdown-toggle" data-toggle="dropdown"&gt;
554
    &lt;span class="caret"&gt;&lt;/span&gt;
555
  &lt;/button&gt;
556
557
558
559
560
  &lt;ul class="dropdown-menu"&gt;
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>
561

562
563
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
        <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>
589
        </div>
590
591
<pre class="prettyprint linenums">
&lt;div class="btn-group dropup"&gt;
592
593
  &lt;button class="btn"&gt;Dropup&lt;/button&gt;
  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
594
    &lt;span class="caret"&gt;&lt;/span&gt;
595
  &lt;/button&gt;
596
597
598
599
600
601
  &lt;ul class="dropdown-menu"&gt;
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>

602
      </section>
603

604
605


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

613
614
        <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
615

616
617
618
619
620
621
622
623
624
        <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>
625
<pre class="prettyprint linenums">
626
&lt;ul class="nav nav-tabs"&gt;
627
628
629
630
631
632
633
  &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
634

635
636
637
638
639
640
641
642
643
        <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>
644
<pre class="prettyprint linenums">
645
&lt;ul class="nav nav-pills"&gt;
646
647
648
649
650
651
  &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;
652
653
</pre>

654
655
656
657
658
659
660
661
662
        <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>
663
664
665
666
667
668
<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;
669
</pre>
Mark Otto's avatar
Mark Otto committed
670

671
672
        <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>
673

Mark Otto's avatar
Mark Otto committed
674

675
        <hr class="bs-docs-separator">
676
677


678
679
        <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
680

681
682
683
684
685
686
687
688
        <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>
689
<pre class="prettyprint linenums">
690
&lt;ul class="nav nav-tabs nav-stacked"&gt;
691
692
693
  ...
&lt;/ul&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
694

695
696
697
698
699
700
701
702
        <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>
703
<pre class="prettyprint linenums">
704
&lt;ul class="nav nav-pills nav-stacked"&gt;
705
706
707
  ...
&lt;/ul&gt;
</pre>
708

Mark Otto's avatar
Mark Otto committed
709

710
        <hr class="bs-docs-separator">
711
712


713
714
        <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
715

716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
        <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>
733
<pre class="prettyprint linenums">
734
&lt;ul class="nav nav-tabs"&gt;
735
  &lt;li class="dropdown"&gt;
736
    &lt;a class="dropdown-toggle"
737
738
739
740
741
742
743
744
745
746
       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;
747
</pre>
Mark Otto's avatar
Mark Otto committed
748

749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
        <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>
766
<pre class="prettyprint linenums">
767
&lt;ul class="nav nav-pills"&gt;
768
  &lt;li class="dropdown"&gt;
769
    &lt;a class="dropdown-toggle"
770
771
772
773
774
775
776
777
778
779
       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;
780
</pre>
781

Mark Otto's avatar
Mark Otto committed
782

783
        <hr class="bs-docs-separator">
784
785


786
787
        <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
788

789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
        <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>
806
<pre class="prettyprint linenums">
807
&lt;ul class="nav nav-list"&gt;
808
809
810
  &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;
811
  ...
812
813
&lt;/ul&gt;
</pre>
814
815
816
817
        <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>
818

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


830
        <hr class="bs-docs-separator">
831

Mark Otto's avatar
Mark Otto committed
832

833
834
        <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
835

836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
        <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>
855
            </div>
856
857
          </div> <!-- /tabbable -->
        </div>
858
<pre class="prettyprint linenums">
859
&lt;div class="tabbable"&gt; &lt;!-- Only required for left/right tabs --&gt;
860
  &lt;ul class="nav nav-tabs"&gt;
861
862
    &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;
863
864
  &lt;/ul&gt;
  &lt;div class="tab-content"&gt;
865
    &lt;div class="tab-pane active" id="tab1"&gt;
866
867
      &lt;p&gt;I'm in Section 1.&lt;/p&gt;
    &lt;/div&gt;
868
    &lt;div class="tab-pane" id="tab2"&gt;
869
870
871
872
873
      &lt;p&gt;Howdy, I'm in Section 2.&lt;/p&gt;
    &lt;/div&gt;
  &lt;/div&gt;
&lt;/div&gt;
</pre>
874

875
876
        <h4>Fade in tabs</h4>
        <p>To make tabs fade in, add <code>.fade</code> to each <code>.tab-pane</code>.</p>
877

878
879
        <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>
880

881
        <h3>Tabbable in any direction</h3>
882

883
884
885
886
887
888
889
890
891
892
893
894
895
896
        <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>
897
            </div>
898
899
900
901
902
903
904
            <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>
905
<pre class="prettyprint linenums">
Mark Otto's avatar
Mark Otto committed
906
&lt;div class="tabbable tabs-below"&gt;
907
908
909
  &lt;div class="tab-content"&gt;
    ...
  &lt;/div&gt;
910
911
912
  &lt;ul class="nav nav-tabs"&gt;
    ...
  &lt;/ul&gt;
913
914
&lt;/div&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
915

916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
        <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>
935
            </div>
936
937
          </div> <!-- /tabbable -->
        </div>
938
939
<pre class="prettyprint linenums">
&lt;div class="tabbable tabs-left"&gt;
940
  &lt;ul class="nav nav-tabs"&gt;
941
942
943
944
945
946
947
    ...
  &lt;/ul&gt;
  &lt;div class="tab-content"&gt;
    ...
  &lt;/div&gt;
&lt;/div&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
948

949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
        <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>
968
            </div>
969
970
          </div> <!-- /tabbable -->
        </div>
971
972
<pre class="prettyprint linenums">
&lt;div class="tabbable tabs-right"&gt;
973
  &lt;ul class="nav nav-tabs"&gt;
974
975
976
977
978
979
980
    ...
  &lt;/ul&gt;
  &lt;div class="tab-content"&gt;
    ...
  &lt;/div&gt;
&lt;/div&gt;
</pre>
981

982
      </section>
983
984
985



986
987
988
989
990
991
      <!-- Navbar
      ================================================== -->
      <section id="navbar">
        <div class="page-header">
          <h1>Navbar</h1>
        </div>
992

993

994
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">
            <div class="navbar-inner">
              <a class="brand" href="#">Title</a>
              <ul class="nav">
For faster browsing, not all history is shown. View entire blame