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

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

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

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

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


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

    <div class="container">

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


112

Mark Otto's avatar
Mark Otto committed
113
114
115
116
117
118
119
120
121
122
<!-- Button Groups
================================================== -->
<section id="buttonGroups">
  <div class="page-header">
    <h1>Button groups <small>Join buttons for more toolbar-like functionality</small></h1>
  </div>
  <div class="row">
    <div class="span4">
      <h3>Button groups</h3>
      <p>Use button groups to join multiple buttons together as one composite component. Build them with a series of <code>&lt;a&gt;</code> or <code>&lt;button&gt;</code> elements.</p>
123
124
125
126
127
128
129
130
131
132
133
134
135
136
      <h3>Best practices</h3>
      <p>We recommend the following guidelines for using button groups and toolbars:</p>
      <ul>
        <li>Always use the same element in a single button group, <code>&lt;a&gt;</code> or <code>&lt;button&gt;</code>.</li>
        <li>Don't mix buttons of different colors in the same button group.</li>
        <li>Use icons in addition to or instead of text, but be sure include alt and title text where appropriate.</li>
      </ul>
      <p><span class="label label-info">Related</span> Button groups with dropdowns (see below) should be called out separately and always include a dropdown caret to indicate intended behavior.</p>
    </div>
    <div class="span4">
      <h3>Default example</h3>
      <p>Here's how the HTML looks for a standard button group built with anchor tag buttons:</p>
      <div class="">
        <div class="btn-group" style="margin: 9px 0;">
137
138
139
          <button class="btn">Left</button>
          <button class="btn">Middle</button>
          <button class="btn">Right</button>
Mark Otto's avatar
Mark Otto committed
140
141
        </div>
      </div>
142
143
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
144
145
146
  &lt;button class="btn"&gt;1&lt;/button&gt;
  &lt;button class="btn"&gt;2&lt;/button&gt;
  &lt;button class="btn"&gt;3&lt;/button&gt;
147
148
149
150
&lt;/div&gt;
</pre>
      <h3>Toolbar example</h3>
      <p>Combine sets of <code>&lt;div class="btn-group"&gt;</code> into a <code>&lt;div class="btn-toolbar"&gt;</code> for more complex components.</p>
151
152
      <div class="btn-toolbar">
        <div class="btn-group">
153
154
155
156
          <button class="btn">1</button>
          <button class="btn">2</button>
          <button class="btn">3</button>
          <button class="btn">4</button>
157
158
        </div>
        <div class="btn-group">
159
160
161
          <button class="btn">5</button>
          <button class="btn">6</button>
          <button class="btn">7</button>
162
163
        </div>
        <div class="btn-group">
164
          <button class="btn">8</button>
165
166
167
168
169
170
171
172
173
174
        </div>
      </div>
<pre class="prettyprint linenums">
&lt;div class="btn-toolbar"&gt;
  &lt;div class="btn-group"&gt;
    ...
  &lt;/div&gt;
&lt;/div&gt;
</pre>
    </div>
Mark Otto's avatar
Mark Otto committed
175
176
177
178
    <div class="span4">
      <h3>Checkbox and radio flavors</h3>
      <p>Button groups can also function as radios, where only one button may be active, or checkboxes, where any number of buttons may be active. View <a href="./javascript.html#buttons">the Javascript docs</a> for that.</p>
      <p><a class="btn js-btn" href="./javascript.html#buttons">Get the javascript &raquo;</a></p>
Mark Otto's avatar
Mark Otto committed
179
180
      <h3>Dropdowns in button groups</h3>
      <p><span class="label label-info">Heads up!</span> Buttons with dropdowns must be individually wrapped in their own <code>.btn-group</code> within a <code>.btn-toolbar</code> for proper rendering.</p>
Mark Otto's avatar
Mark Otto committed
181
182
183
    </div>
  </div>
</section>
184
185
186



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

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

335
  <h2>Split button dropdowns</h2>
Mark Otto's avatar
Mark Otto committed
336
337
  <div class="row">
    <div class="span4">
338
      <h3>Overview and examples</h3>
Mark Otto's avatar
Mark Otto committed
339
      <p>Building on the button group styles and markup, we can easily create a split button. Split buttons feature a standard action on the left and a dropdown toggle on the right with contextual links.</p>
340
341
      <div class="btn-toolbar" style="margin-top: 18px;">
        <div class="btn-group">
342
343
          <button class="btn">Action</button>
          <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
344
345
346
347
348
349
350
351
352
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
353
354
          <button class="btn btn-primary">Action</button>
          <button class="btn btn-primary dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
355
356
357
358
359
360
361
362
363
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
364
365
          <button class="btn btn-danger">Danger</button>
          <button class="btn btn-danger dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
366
367
368
369
370
371
372
373
374
375
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
      </div>
      <div class="btn-toolbar">
376
        <div class="btn-group">
377
378
          <button class="btn btn-warning">Warning</button>
          <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
379
380
381
382
383
384
385
386
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
387
        <div class="btn-group">
388
389
          <button class="btn btn-success">Success</button>
          <button class="btn btn-success dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
390
391
392
393
394
395
396
397
398
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
399
400
          <button class="btn btn-info">Info</button>
          <button class="btn btn-info dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
401
402
403
404
405
406
407
408
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
409
410
      </div>
      <div class="btn-toolbar">
411
        <div class="btn-group">
412
413
          <button class="btn btn-inverse">Inverse</button>
          <button class="btn btn-inverse dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
414
415
416
417
418
419
420
421
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
422
      </div><!-- /btn-toolbar -->
Mark Otto's avatar
Mark Otto committed
423
424
      <h3>Sizes</h3>
      <p>Utilize the extra button classe <code>.btn-mini</code>, <code>.btn-small</code>, or <code>.btn-large</code> for sizing.</p>
425
426
      <div class="btn-toolbar">
        <div class="btn-group">
Mark Otto's avatar
Mark Otto committed
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
          <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">
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
      </div><!-- /btn-toolbar -->
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
  ...
  &lt;ul class="dropdown-menu pull-right"&gt;
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>
472
    </div>
Mark Otto's avatar
Mark Otto committed
473
474
    <div class="span8">
      <h3>Example markup</h3>
475
      <p>We expand on the normal button dropdowns to provide a second button action that operates as a separate dropdown trigger.</p>
476
477
<pre class="prettyprint linenums">
&lt;div class="btn-group"&gt;
478
479
  &lt;button class="btn"&gt;Action&lt;/button&gt;
  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
480
    &lt;span class="caret"&gt;&lt;/span&gt;
481
  &lt;/button&gt;
482
483
484
485
486
  &lt;ul class="dropdown-menu"&gt;
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>
487
488
489
490
      <h3>Dropup menus</h3>
      <p>Dropdown menus can also be toggled from the bottom up by adding a single class to the immediate parent of <code>.dropdown-menu</code>. It will flip the direction of the <code>.caret</code> and reposition the menu itself to move from the bottom up instead of top down.</p>
      <div class="btn-toolbar" style="margin-top: 9px;">
        <div class="btn-group dropup">
491
492
          <button class="btn">Dropup</button>
          <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
493
494
495
496
497
498
499
500
501
          <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">
502
503
          <button class="btn primary">Right dropup</button>
          <button class="btn primary dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
504
505
506
507
508
509
510
511
          <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 -->
512
      </div>
513
514
<pre class="prettyprint linenums">
&lt;div class="btn-group dropup"&gt;
515
516
  &lt;button class="btn"&gt;Dropup&lt;/button&gt;
  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
517
    &lt;span class="caret"&gt;&lt;/span&gt;
518
  &lt;/button&gt;
519
520
521
522
523
524
  &lt;ul class="dropdown-menu"&gt;
    &lt;!-- dropdown menu links --&gt;
  &lt;/ul&gt;
&lt;/div&gt;
</pre>

525
    </div>
Mark Otto's avatar
Mark Otto committed
526
527
  </div>
</section>
528

529
530


531
<!-- Nav, Tabs, & Pills
532
================================================== -->
533
<section id="navs">
534
  <div class="page-header">
535
    <h1>Nav, tabs, and pills <small>Highly customizable list-style navigation</small></h1>
536
  </div>
537

538
  <h2>Lightweight defaults <small>Same markup, different classes</small></h2>
539
  <div class="row">
540
541
542
    <div class="span4">
      <h3>Powerful base class</h3>
      <p>All nav components here&mdash;tabs, pills, and lists&mdash;<strong>share the same base markup and styles</strong> through the <code>.nav</code> class.</p>
543
544
545
546
      <h3>When to use</h3>
      <p>Tabs and pills are great for sections of content or navigating between pages of related content.</p>
      <h3>Component alignment</h3>
      <p>To align nav links, use the <code>.pull-left</code> or <code>.pull-right</code> utility classes. Both classes will add a CSS float in the specified direction.</p>
547
548
549
    </div>
    <div class="span4">
      <h3>Basic tabs</h3>
nkryptic's avatar
nkryptic committed
550
      <p>Take a regular <code>&lt;ul&gt;</code> of links and add <code>.nav-tabs</code>:</p>
551
      <ul class="nav nav-tabs">
552
553
554
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
555
      </ul>
556
<pre class="prettyprint linenums">
557
&lt;ul class="nav nav-tabs"&gt;
558
559
560
561
562
563
564
  &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>
565
    </div>
566
567
    <div class="span4">
      <h3>Basic pills</h3>
nkryptic's avatar
nkryptic committed
568
      <p>Take that same HTML, but use <code>.nav-pills</code> instead:</p>
569
      <ul class="nav nav-pills">
570
571
572
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
573
      </ul>
574
<pre class="prettyprint linenums">
575
&lt;ul class="nav nav-pills"&gt;
576
577
578
579
580
581
582
  &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>
583
584
585
    </div>
  </div>

586
  <h2>Stackable <small>Make tabs or pills vertical</small></h2>
587
588
  <div class="row">
    <div class="span4">
589
      <h3>How to stack 'em</h3>
nkryptic's avatar
nkryptic committed
590
      <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>
591
592
    </div>
    <div class="span4">
593
      <h3>Stacked tabs</h3>
594
      <ul class="nav nav-tabs nav-stacked">
595
596
597
598
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
      </ul>
599
<pre class="prettyprint linenums">
600
&lt;ul class="nav nav-tabs nav-stacked"&gt;
601
602
603
  ...
&lt;/ul&gt;
</pre>
604
605
606
    </div>
    <div class="span4">
      <h3>Stacked pills</h3>
607
      <ul class="nav nav-pills nav-stacked">
608
609
610
611
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
      </ul>
612
<pre class="prettyprint linenums">
613
&lt;ul class="nav nav-pills nav-stacked"&gt;
614
615
616
617
  ...
&lt;/ul&gt;
</pre>
    </div>
618
619
  </div>

620
  <h2>Dropdowns <small>For advanced nav components</small></h2>
621
  <div class="row">
622
623
624
625
    <div class="span4">
      <h3>Rich menus made easy</h3>
      <p>Dropdown menus in Bootstrap tabs and pills are super easy and require only a little extra HTML and a lightweight jQuery plugin.</p>
      <p>Head over to the Javascript page to read the docs on <a href="./javascript.html#tabs">initializing dropdowns</a> in Bootstrap.</p>
626
    </div>
627
628
    <div class="span4">
      <h3>Tabs with dropdowns</h3>
629
      <ul class="nav nav-tabs">
630
        <li class="active"><a href="#">Home</a></li>
Burak Tuyan's avatar
Burak Tuyan committed
631
        <li><a href="#">Help</a></li>
632
633
634
635
636
637
638
639
640
641
642
        <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>
643
<pre class="prettyprint linenums">
644
&lt;ul class="nav nav-tabs"&gt;
645
  &lt;li class="dropdown"&gt;
646
    &lt;a class="dropdown-toggle"
647
648
649
650
651
652
653
654
655
656
       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;
657
</pre>
658
659
660
    </div>
    <div class="span4">
      <h3>Pills with dropdowns</h3>
661
      <ul class="nav nav-pills">
662
        <li class="active"><a href="#">Home</a></li>
Burak Tuyan's avatar
Burak Tuyan committed
663
        <li><a href="#">Help</a></li>
664
665
666
667
668
669
670
671
672
673
674
        <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>
675
<pre class="prettyprint linenums">
676
&lt;ul class="nav nav-pills"&gt;
677
  &lt;li class="dropdown"&gt;
678
    &lt;a class="dropdown-toggle"
679
680
681
682
683
684
685
686
687
688
       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;
689
690
</pre>
    </div>
691
692
  </div>

693
694
695
696
697
698
  <h2>Nav lists <small>Build simple stacked navs, great for sidebars</small></h2>
  <div class="row">
    <div class="span4">
      <h3>Application-style navigation</h3>
      <p>Nav lists provide a simple and easy way to build groups of nav links with optional headers. They're best used in sidebars like the Finder in OS X.</p>
      <p>Structurally, they're built on the same core nav styles as tabs and pills, so usage and customization are straightforward.</p>
699
      <hr>
700
701
      <h4>With icons</h4>
      <p>Nav lists are also easy to equip with icons. Add the proper <code>&lt;i&gt;</code> tag with class and you're set.</p>
702
703
704
705
706
707
708
709
710
      <h4>Horizontal dividers</h4>
      <p>Add a horizontal divider by creating an empty list item with the class <code>.divider</code>, like so:</p>
<pre class="prettyprint linenums">
&lt;ul class="nav nav-list"&gt;
  ...
  &lt;li class="divider"&gt;&lt;/li&gt;
  ...
&lt;/ul&gt;
</pre>
711
712
    </div>
    <div class="span4">
713
      <h3>Example nav list</h3>
nkryptic's avatar
nkryptic committed
714
      <p>Take a list of links and add <code>class="nav nav-list"</code>:</p>
715
      <div class="well" style="padding: 8px 0;">
716
        <ul class="nav nav-list">
717
          <li class="nav-header">List header</li>
718
          <li class="active"><a href="#">Home</a></li>
719
720
721
722
723
          <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>
724
          <li class="divider"></li>
725
          <li><a href="#">Help</a></li>
726
        </ul>
727
      </div> <!-- /well -->
728
<pre class="prettyprint linenums">
729
&lt;ul class="nav nav-list"&gt;
730
731
732
  &lt;li class="nav-header"&gt;
    List header
  &lt;/li&gt;
733
  &lt;li class="active"&gt;
734
    &lt;a href="#"&gt;Home&lt;/a&gt;
735
  &lt;/li&gt;
736
737
  &lt;li&gt;
    &lt;a href="#"&gt;Library&lt;/a&gt;
738
  &lt;/li&gt;
739
  ...
740
&lt;/ul&gt;
741
742
743
744
745
746
</pre>
    </div>
    <div class="span4">
      <h3>Example with icons</h3>
      <p>Same example, but with <code>&lt;i&gt;</code> tags for icons.</p>
      <div class="well" style="padding: 8px 0;">
747
        <ul class="nav nav-list">
748
          <li class="nav-header">List header</li>
Mark Otto's avatar
Mark Otto committed
749
750
751
          <li class="active"><a href="#"><i class="icon-white icon-home"></i> Home</a></li>
          <li><a href="#"><i class="icon-book"></i> Library</a></li>
          <li><a href="#"><i class="icon-pencil"></i> Applications</a></li>
752
          <li class="nav-header">Another list header</li>
Mark Otto's avatar
Mark Otto committed
753
754
          <li><a href="#"><i class="icon-user"></i> Profile</a></li>
          <li><a href="#"><i class="icon-cog"></i> Settings</a></li>
755
          <li class="divider"></li>
Mark Otto's avatar
Mark Otto committed
756
          <li><a href="#"><i class="icon-flag"></i> Help</a></li>
757
758
759
        </ul>
      </div> <!-- /well -->
<pre class="prettyprint linenums">
760
&lt;ul class="nav nav-list"&gt;
761
762
763
  ...
  &lt;li&gt;
    &lt;a href="#"&gt;
Mark Otto's avatar
Mark Otto committed
764
      &lt;i class="icon-book"&gt;&lt;/i&gt;
765
766
767
768
769
      Library
    &lt;/a&gt;
  &lt;/li&gt;
  ...
&lt;/ul&gt;
770
</pre>
771
772
    </div>
  </div>
773

774

775
  <h2>Tabbable nav <small>Bring tabs to life via javascript</small></h2>
776
777
778
  <div class="row">
    <div class="span4">
      <h3>What's included</h3>
779
      <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>
780
781
      <p>Changing between them is easy and only requires changing very little markup.</p>
    </div>
782
    <div class="span4">
783
      <h3>Tabbable example</h3>
nkryptic's avatar
nkryptic committed
784
      <p>To make tabs tabbable, wrap the <code>.nav-tabs</code> in another div with class <code>.tabbable</code>.</p>
785
      <div class="tabbable" style="margin-bottom: 9px;">
786
        <ul class="nav nav-tabs">
787
788
789
          <li class="active"><a href="#1" data-toggle="tab">Section 1</a></li>
          <li><a href="#2" data-toggle="tab">Section 2</a></li>
          <li><a href="#3" data-toggle="tab">Section 3</a></li>
790
791
792
        </ul>
        <div class="tab-content">
          <div class="tab-pane active" id="1">
793
            <p>I'm in Section 1.</p>
794
795
          </div>
          <div class="tab-pane" id="2">
796
            <p>Howdy, I'm in Section 2.</p>
797
798
          </div>
          <div class="tab-pane" id="3">
799
            <p>What up girl, this is Section 3.</p>
800
801
          </div>
        </div>
802
      </div> <!-- /tabbable -->
803
804
805
806
    </div>
    <div class="span4">
      <h3>Custom jQuery plugin</h3>
      <p>All tabbable tabs are powered by our lightweight jQuery plugin. Read more about how to bring tabbable tabs to life on the javascript docs page.</p>
Mark Otto's avatar
Mark Otto committed
807
      <p><a class="btn" href="./javascript.html#tabs">Get the javascript &rarr;</a></p>
808
809
    </div>
  </div>
810

811
812
  <h3>Straightforward markup</h3>
  <p>Using tabbable tabs requires a wrapping div, a set of tabs, and a set of tabbable panes of content.</p>
813
814
<pre class="prettyprint linenums">
&lt;div class="tabbable"&gt;
815
  &lt;ul class="nav nav-tabs"&gt;
816
817
818
819
820
821
822
823
824
825
826
827
828
    &lt;li class="active"&gt;&lt;a href="#1" data-toggle="tab"&gt;Section 1&lt;/a&gt;&lt;/li&gt;
    &lt;li&gt;&lt;a href="#2" data-toggle="tab"&gt;Section 2&lt;/a&gt;&lt;/li&gt;
  &lt;/ul&gt;
  &lt;div class="tab-content"&gt;
    &lt;div class="tab-pane active" id="1"&gt;
      &lt;p&gt;I'm in Section 1.&lt;/p&gt;
    &lt;/div&gt;
    &lt;div class="tab-pane" id="2"&gt;
      &lt;p&gt;Howdy, I'm in Section 2.&lt;/p&gt;
    &lt;/div&gt;
  &lt;/div&gt;
&lt;/div&gt;
</pre>
829

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

930
931
932
933
934
935
936
937
938
939
940
941
</section>



<!-- Navbar
================================================== -->
<section id="navbar">
  <div class="page-header">
    <h1>Navbar</h1>
  </div>
  <h2>Static navbar example</h2>
  <p>An example of a static (not fixed to the top) navbar with project name, navigation, and search form.</p>
942
  <div class="navbar">
943
    <div class="navbar-inner">
944
      <div class="container">
945
        <a class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse">
Mark Otto's avatar
Mark Otto committed
946
947
948
          <span class="icon-bar"></span>
          <span class="icon-bar"></span>
          <span class="icon-bar"></span>
949
        </a>
950
        <a class="brand" href="#">Project name</a>
951
952
953
954
955
956
957
958
959
960
961
962
963
        <div class="nav-collapse">
          <ul class="nav">
            <li class="active"><a href="#">Home</a></li>
            <li><a href="#">Link</a></li>
            <li><a href="#">Link</a></li>
            <li><a href="#">Link</a></li>
            <li class="dropdown">
              <a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown <b class="caret"></b></a>
              <ul class="dropdown-menu">
                <li><a href="#">Action</a></li>
                <li><a href="#">Another action</a></li>
                <li><a href="#">Something else here</a></li>
                <li class="divider"></li>
964
                <li class="nav-header">Nav header</li>
965
                <li><a href="#">Separated link</a></li>
966
                <li><a href="#">One more separated link</a></li>
967
968
969
970
971
972
973
974
              </ul>
            </li>
          </ul>
          <form class="navbar-search pull-left" action="">
            <input type="text" class="search-query span2" placeholder="Search">
          </form>
          <ul class="nav pull-right">
            <li><a href="#">Link</a></li>
975
            <li class="divider-vertical"></li>
976
977
978
979
980
981
982
983
984
985
986
987
            <li class="dropdown">
              <a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown <b class="caret"></b></a>
              <ul class="dropdown-menu">
                <li><a href="#">Action</a></li>
                <li><a href="#">Another action</a></li>
                <li><a href="#">Something else here</a></li>
                <li class="divider"></li>
                <li><a href="#">Separated link</a></li>
              </ul>
            </li>
          </ul>
        </div><!-- /.nav-collapse -->
988
989
990
991
992
993
994
995
996
      </div>
    </div><!-- /navbar-inner -->
  </div><!-- /navbar -->

  <div class="row">
    <div class="span8">
      <h3>Navbar scaffolding</h3>
      <p>The navbar requires only a few divs to structure it well for static or fixed display.</p>
<pre class="prettyprint linenums">
997
&lt;div class="navbar"&gt;
998
  &lt;div class="navbar-inner"&gt;
999
    &lt;div class="container"&gt;
1000
      ...
For faster browsing, not all history is shown. View entire blame