components.html 74.4 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>

Mark Otto's avatar
Mark Otto committed
30
  <body data-spy="scroll" data-target=".subnav" data-offset="50">
31

Mark Otto's avatar
Mark Otto committed
32
33
34
35
    <!-- Navbar
    ================================================== -->
    <div class="navbar navbar-fixed-top">
      <div class="navbar-inner">
Mark Otto's avatar
Mark Otto committed
36
        <div class="bs-docs-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
60
61
62
63
64
65
66
              </li>
              <li class="divider-vertical"></li>
              <li class="">
                <a href="./download.html">Customize</a>
              </li>
              <li class="">
                <a href="./examples.html">Examples</a>
              </li>
67
68
69
              <li class="">
                <a href="./extend.html">Extend</a>
              </li>
Mark Otto's avatar
Mark Otto committed
70
71
72
73
74
75
            </ul>
          </div>
        </div>
      </div>
    </div>

76
    <div class="bs-docs-container">
77

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

115
116
117
118


<!-- Dropdowns
================================================== -->
119
<section id="dropdowns">
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
  <div class="page-header">
    <h1>Dropdown menus <small>Dropdown and dropup menus for contextual actions</small></h1>
  </div>

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


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


  <h2>Markup</h2>
  <p>Dropdowns require...</p>

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


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


  <h2>Options</h2>
  <p>...</p>

  <h3>Dropup menus</h3>
  <p>...</p>

  <h3>Aligning the menus</h3>
  <p>...</p>


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


  <h2>Usage</h2>
  <p>...</p>


</section>


197

Mark Otto's avatar
Mark Otto committed
198

Mark Otto's avatar
Mark Otto committed
199
200
201
202
203
204
<!-- Button Groups
================================================== -->
<section id="buttonGroups">
  <div class="page-header">
    <h1>Button groups <small>Join buttons for more toolbar-like functionality</small></h1>
  </div>
205

Mark Otto's avatar
Mark Otto committed
206
207
208

  <h2>Description and best practices</h2>
  <p>Use button groups to join multiple buttons together as one composite component. Build them with a series of <code>&lt;a&gt;</code> or <code>&lt;button&gt;</code> elements. We recommend the following guidelines for using button groups and toolbars:</p>
209
210
211
212
213
214
215
  <ul>
    <li>Always use the same element in a single button group, <code>&lt;a&gt;</code> or <code>&lt;button&gt;</code>.</li>
    <li>Don't mix buttons of different colors in the same button group.</li>
    <li>Use icons in addition to or instead of text, but be sure include alt and title text where appropriate.</li>
  </ul>
  <p><span class="label label-info">Related</span> Button groups with dropdowns (see below) should be called out separately and always include a dropdown caret to indicate intended behavior.</p>

Mark Otto's avatar
Mark Otto committed
216
217
218
219
220
221
222
223
224
225
226

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


  <h2>Examples and variations</h2>
  <p>Two basic options, along with two more specific variations.</p>

  <h3>Basic 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;">
227
228
229
      <button class="btn">Left</button>
      <button class="btn">Middle</button>
      <button class="btn">Right</button>
230
    </div>
231
  </div>
232
233
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
234
235
236
  &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;
237
238
&lt;/div&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
239

240
241
  <h3>Toolbar example</h3>
  <p>Combine sets of <code>&lt;div class="btn-group"&gt;</code> into a <code>&lt;div class="btn-toolbar"&gt;</code> for more complex components.</p>
Mark Otto's avatar
Mark Otto committed
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
  <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>
258
259
    </div>
  </div>
260
261
262
263
264
265
266
<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
267

268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291

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


  <h2>Vertical button groups</h2>
  <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>
  </div>
<pre class="prettyprint linenums">
&lt;div class="btn-group btn-group-vertical"&gt;
  ...
&lt;/div&gt;
</pre>


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


292
293
  <h3>Checkbox and radio flavors</h3>
  <p>Button groups can also function as radios, where only one button may be active, or checkboxes, where any number of buttons may be active. View <a href="./javascript.html#buttons">the Javascript docs</a> for that.</p>
Mark Otto's avatar
Mark Otto committed
294

295
296
  <h3>Dropdowns in button groups</h3>
  <p><span class="label label-info">Heads up!</span> Buttons with dropdowns must be individually wrapped in their own <code>.btn-group</code> within a <code>.btn-toolbar</code> for proper rendering.</p>
Mark Otto's avatar
Mark Otto committed
297
</section>
298
299
300



Mark Otto's avatar
Mark Otto committed
301
302
<!-- Split button dropdowns
================================================== -->
303
<section id="buttonDropdowns">
Mark Otto's avatar
Mark Otto committed
304
  <div class="page-header">
305
    <h1>Button dropdown menus <small>Built on button groups to provide contextual menus</small></h1>
Mark Otto's avatar
Mark Otto committed
306
  </div>
307

308

309
  <h2>Overview and examples</h2>
310
  <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>
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
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
  <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 -->
384
  </div>
385
386
387
388
389
390
391
392
393
394
395
<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>
396
397
398

  <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>
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
  <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>
433
434
435
436
437

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

438

439
440
  <hr class="bs-docs-separator">

441

442
  <h2>Split button dropdowns</h2>
443
  <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>
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
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
  <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 -->
524
  </div>
525
526
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
527
528
529
530
531
  &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;
532
533
534
535
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>
536

537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
  <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>
580
581
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
582
583
  &lt;button class="btn btn-mini"&gt;Action&lt;/button&gt;
  &lt;button class="btn btn-mini dropdown-toggle" data-toggle="dropdown"&gt;
584
    &lt;span class="caret"&gt;&lt;/span&gt;
585
  &lt;/button&gt;
586
587
588
589
590
  &lt;ul class="dropdown-menu"&gt;
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>
591

592
593
  <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>
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
  <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>
619
  </div>
620
621
<pre class="prettyprint linenums">
&lt;div class="btn-group dropup"&gt;
622
623
  &lt;button class="btn"&gt;Dropup&lt;/button&gt;
  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
624
    &lt;span class="caret"&gt;&lt;/span&gt;
625
  &lt;/button&gt;
626
627
628
629
630
631
  &lt;ul class="dropdown-menu"&gt;
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>

Mark Otto's avatar
Mark Otto committed
632
</section>
633

634
635


636
<!-- Nav, Tabs, & Pills
637
================================================== -->
638
<section id="navs">
639
  <div class="page-header">
640
    <h1>Nav, tabs, and pills <small>Highly customizable list-style navigation</small></h1>
641
  </div>
642

643
  <h2>Lightweight defaults <small>Same markup, different classes</small></h2>
Mark Otto's avatar
Mark Otto committed
644
645
646
647
  <p>All nav components here&mdash;tabs, pills, and lists&mdash;<strong>share the same base markup and styles</strong> through the <code>.nav</code> class.</p>

  <h3>Basic tabs</h3>
  <p>Take a regular <code>&lt;ul&gt;</code> of links and add <code>.nav-tabs</code>:</p>
648
649
650
651
652
653
654
  <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>
655
<pre class="prettyprint linenums">
656
&lt;ul class="nav nav-tabs"&gt;
657
658
659
660
661
662
663
  &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
664
665
666

  <h3>Basic pills</h3>
  <p>Take that same HTML, but use <code>.nav-pills</code> instead:</p>
667
668
669
670
671
672
673
  <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>
674
<pre class="prettyprint linenums">
675
&lt;ul class="nav nav-pills"&gt;
676
677
678
679
680
681
  &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;
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
</pre>

  <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>
<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;
699
</pre>
Mark Otto's avatar
Mark Otto committed
700

701
702
  <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>
703

Mark Otto's avatar
Mark Otto committed
704

705
706
707
708
  <hr class="bs-docs-separator">


  <h2>Stackable</h2>
Mark Otto's avatar
Mark Otto committed
709
710
711
  <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>

  <h3>Stacked tabs</h3>
712
713
714
715
716
717
718
  <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>
719
<pre class="prettyprint linenums">
720
&lt;ul class="nav nav-tabs nav-stacked"&gt;
721
722
723
  ...
&lt;/ul&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
724
725

  <h3>Stacked pills</h3>
726
727
728
729
730
731
732
  <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>
733
<pre class="prettyprint linenums">
734
&lt;ul class="nav nav-pills nav-stacked"&gt;
735
736
737
  ...
&lt;/ul&gt;
</pre>
738

Mark Otto's avatar
Mark Otto committed
739

740
741
742
743
744
  <hr class="bs-docs-separator">


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

  <h3>Tabs with dropdowns</h3>
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
  <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>
763
<pre class="prettyprint linenums">
764
&lt;ul class="nav nav-tabs"&gt;
765
  &lt;li class="dropdown"&gt;
766
    &lt;a class="dropdown-toggle"
767
768
769
770
771
772
773
774
775
776
       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;
777
</pre>
Mark Otto's avatar
Mark Otto committed
778
779

  <h3>Pills with dropdowns</h3>
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
  <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>
796
<pre class="prettyprint linenums">
797
&lt;ul class="nav nav-pills"&gt;
798
  &lt;li class="dropdown"&gt;
799
    &lt;a class="dropdown-toggle"
800
801
802
803
804
805
806
807
808
809
       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;
810
</pre>
811

Mark Otto's avatar
Mark Otto committed
812

813
814
815
816
817
  <hr class="bs-docs-separator">


  <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
818
819
820

  <h3>Example nav list</h3>
  <p>Take a list of links and add <code>class="nav nav-list"</code>:</p>
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
  <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>
836
<pre class="prettyprint linenums">
837
&lt;ul class="nav nav-list"&gt;
838
839
840
  &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;
841
  ...
842
843
&lt;/ul&gt;
</pre>
844
845
846
847
  <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>
848

849
850
851
852
853
854
855
856
857
858
859
860
  <h3>Horizontal dividers</h3>
  <p>Add a horizontal divider by creating an empty list item with the class <code>.divider</code>, like so:</p>
<pre class="prettyprint linenums">
&lt;ul class="nav nav-list"&gt;
  ...
  &lt;li class="divider"&gt;&lt;/li&gt;
  ...
&lt;/ul&gt;
</pre>


  <hr class="bs-docs-separator">
861

Mark Otto's avatar
Mark Otto committed
862

863
  <h2>Tabbable nav</h2>
Mark Otto's avatar
Mark Otto committed
864
865
866
867
  <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>

  <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>
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
  <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>
Mark Otto's avatar
Mark Otto committed
885
      </div>
886
887
    </div> <!-- /tabbable -->
  </div>
888
<pre class="prettyprint linenums">
889
&lt;div class="tabbable"&gt; &lt;!-- Only required for left/right tabs --&gt;
890
  &lt;ul class="nav nav-tabs"&gt;
891
892
    &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;
893
894
  &lt;/ul&gt;
  &lt;div class="tab-content"&gt;
895
    &lt;div class="tab-pane active" id="tab1"&gt;
896
897
      &lt;p&gt;I'm in Section 1.&lt;/p&gt;
    &lt;/div&gt;
898
    &lt;div class="tab-pane" id="tab2"&gt;
899
900
901
902
903
      &lt;p&gt;Howdy, I'm in Section 2.&lt;/p&gt;
    &lt;/div&gt;
  &lt;/div&gt;
&lt;/div&gt;
</pre>
904

905
906
907
908
909
  <h4>Fade in tabs</h4>
  <p>To make tabs fade in, add <code>.fade</code> to each <code>.tab-pane</code>.</p>

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

911
  <h3>Tabbable in any direction</h3>
Mark Otto's avatar
Mark Otto committed
912
913
914

  <h4>Tabs on the bottom</h4>
  <p>Flip the order of the HTML and add a class to put tabs on the bottom.</p>
915
916
917
918
919
920
921
922
923
924
925
926
  <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>
Mark Otto's avatar
Mark Otto committed
927
      </div>
928
929
930
931
932
933
934
935
      <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>
<pre class="prettyprint linenums">
Mark Otto's avatar
Mark Otto committed
936
&lt;div class="tabbable tabs-below"&gt;
937
938
939
  &lt;div class="tab-content"&gt;
    ...
  &lt;/div&gt;
940
941
942
  &lt;ul class="nav nav-tabs"&gt;
    ...
  &lt;/ul&gt;
943
944
&lt;/div&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
945
946
947

  <h4>Tabs on the left</h4>
  <p>Swap the class to put tabs on the left.</p>
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
  <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>
Mark Otto's avatar
Mark Otto committed
965
      </div>
966
967
    </div> <!-- /tabbable -->
  </div>
968
969
<pre class="prettyprint linenums">
&lt;div class="tabbable tabs-left"&gt;
970
  &lt;ul class="nav nav-tabs"&gt;
971
972
973
974
975
976
977
    ...
  &lt;/ul&gt;
  &lt;div class="tab-content"&gt;
    ...
  &lt;/div&gt;
&lt;/div&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
978
979
980

  <h4>Tabs on the right</h4>
  <p>Swap the class to put tabs on the right.</p>
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
  <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>
Mark Otto's avatar
Mark Otto committed
998
      </div>
999
1000
    </div> <!-- /tabbable -->
  </div>
For faster browsing, not all history is shown. View entire blame