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
1001
1002
1003
1004
      ...
    &lt;/div&gt;
  &lt;/div&gt;
&lt;/div&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
1005
      <h3>Fixed navbar</h3>
1006
1007
1008
      <p>Fix the navbar to the top or bottom of the viewport with an additional class on the outermost div, <code>.navbar</code>.</p>
      <div class="row">
        <div class="span4">
1009
<pre class="prettyprint linenums">
1010
&lt;div class="navbar navbar-fixed-top"&gt;
1011
1012
1013
  ...
&lt;/div&gt;
</pre>
1014
1015
1016
1017
1018
1019
1020
1021
1022
        </div><!--/span-->
        <div class="span4">
<pre class="prettyprint linenums">
&lt;div class="navbar navbar-fixed-bottom"&gt;
  ...
&lt;/div&gt;
</pre>
        </div><!--/span-->
      </div><!--/row-->
Mark's avatar
Mark committed
1023
      <p>When you affix the navbar, remember to account for the hidden area underneath. Add 40px or more of padding to the <code>&lt;body&gt;</code>. Be sure to add this after the core Bootstrap CSS and before the optional responsive CSS.</p>
1024
1025
1026
1027
1028
1029
1030
      <h3>Brand name</h3>
      <p>A simple link to show your brand or project name only requires an anchor tag.</p>
<pre class="prettyprint linenums">
&lt;a class="brand" href="#"&gt;
  Project name
&lt;/a&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
1031
1032
1033
1034
1035
1036
1037
      <h3>Forms in navbar</h3>
      <p>To properly style and position a form within the navbar, add the appropriate classes as shown below. For a default form, include <code>.navbar-form</code> and either <code>.pull-left</code> or <code>.pull-right</code> to properly align it.</p>
<pre class="prettyprint linenums">
&lt;form class="navbar-form pull-left"&gt;
  &lt;input type="text" class="span2"&gt;
&lt;/form&gt;
</pre>
1038
      <p>For a more customized search form, add <code>.navbar-search</code> to the <code>form</code> and <code>.search-query</code> to the input for specialized styles in the navbar.</p>
1039
<pre class="prettyprint linenums">
1040
1041
&lt;form class="navbar-search pull-left"&gt;
  &lt;input type="text" class="search-query" placeholder="Search"&gt;
1042
1043
&lt;/form&gt;
</pre>
1044
      <h3>Optional responsive variation</h3>
1045
      <p>Depending on the amount of content in your topbar, you might want to implement the responsive options. To do so, wrap your nav content in a containing div, <code>.nav-collapse.collapse</code>, and add the navbar toggle button, <code>.btn-navbar</code>.</p>
1046
<pre class="prettyprint linenums">
1047
&lt;div class="navbar"&gt;
1048
1049
  &lt;div class="navbar-inner"&gt;
    &lt;div class="container"&gt;
Jacob Thornton's avatar
Jacob Thornton committed
1050

1051
1052
      &lt;!-- .btn-navbar is used as the toggle for collapsed navbar content --&gt;
      &lt;a class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse"&gt;
Mark Otto's avatar
Mark Otto committed
1053
1054
1055
        &lt;span class="icon-bar"&gt;&lt;/span&gt;
        &lt;span class="icon-bar"&gt;&lt;/span&gt;
        &lt;span class="icon-bar"&gt;&lt;/span&gt;
1056
      &lt;/a&gt;
Jacob Thornton's avatar
Jacob Thornton committed
1057

1058
1059
1060
1061
      &lt;!-- Be sure to leave the brand out there if you want it shown --&gt;
      &lt;a class="brand" href="#"&gt;Project name&lt;/a&gt;

      &lt;!-- Everything you want hidden at 940px or less, place within here --&gt;
1062
      &lt;div class="nav-collapse"&gt;
1063
1064
1065
1066
1067
1068
1069
        &lt;!-- .nav, .navbar-search, .navbar-form, etc --&gt;
      &lt;/div&gt;

    &lt;/div&gt;
  &lt;/div&gt;
&lt;/div&gt;
</pre>
1070
1071
1072
      <div class="alert alert-info">
        <strong>Heads up!</strong> The responsive navbar requires the <a href="./javascript.html#collapse">collapse plugin</a>.
      </div>
1073

1074
    </div><!-- /.span -->
1075
1076
1077
    <div class="span4">
      <h3>Nav links</h3>
      <p>Nav items are simple to add via unordered lists.</p>
1078
<pre class="prettyprint linenums">
1079
1080
1081
1082
1083
1084
1085
&lt;ul class="nav"&gt;
  &lt;li class="active"&gt;
    &lt;a href="#">Home&lt;/a&gt;
  &lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Link&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Link&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
1086
1087
1088
1089
1090
1091
1092
1093
</pre>
      <p>You can easily add dividers to your nav links with an empty list item and a simple class. Just add this between links:</p>
<pre class="prettyprint linenums">
&lt;ul class="nav"&gt;
  ...
  &lt;li class="divider-vertical"&gt;&lt;/li&gt;
  ...
&lt;/ul&gt;
1094
</pre>
1095
1096
      <h3>Component alignment</h3>
      <p>To align a nav, search form, or text, 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>
1097
      <h3>Adding dropdown menus</h3>
Mark's avatar
Mark committed
1098
      <p>Adding dropdowns and dropups to the nav is super simple, but does require the use of <a href="./javascript.html#dropdowns">our javascript plugin</a>.</p>
1099
1100
1101
1102
1103
1104
1105
<pre class="prettyprint linenums">
&lt;ul class="nav"&gt;
  &lt;li class="dropdown"&gt;
    &lt;a href="#"
          class="dropdown-toggle"
          data-toggle="dropdown">
          Account
1106
          &lt;b class="caret"&gt;&lt;/b&gt;
1107
1108
1109
1110
1111
    &lt;/a&gt;
    &lt;ul class="dropdown-menu"&gt;
      ...
    &lt;/ul&gt;
  &lt;/li&gt;
1112
1113
&lt;/ul&gt;
</pre>
Jacob Thornton's avatar
Jacob Thornton committed
1114
      <p><a class="btn" href="./javascript.html#dropdowns">Get the javascript &rarr;</a></p>
1115
1116
1117
      <hr>
      <h3>Text in the navbar</h3>
      <p>Wrap strings of text in a <code>&lt;p&gt;</code> tag for proper leading and color.</p>
1118
1119
    </div><!-- /.span -->
  </div><!-- /.row -->
1120

1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
</section>



<!-- Breadcrumbs
================================================== -->
<section id="breadcrumbs">
  <div class="page-header">
    <h1>Breadcrumbs <small></small></h1>
  </div>

1132
  <div class="row">
1133
1134
1135
1136
1137
1138
    <div class="span6">
      <h3>Why use them</h3>
      <p>Breadcrumb navigation is used as a way to show users where they are within an app or a site, but not for primary navigation. Keep their use sparse and succinct to be most effective.</p>

      <h3>Examples</h3>
      <p>A single example shown as it might be displayed across multiple pages.</p>
1139
1140
1141
1142
1143
      <ul class="breadcrumb">
        <li class="active">Home</li>
      </ul>
      <ul class="breadcrumb">
        <li><a href="#">Home</a> <span class="divider">/</span></li>
1144
        <li class="active">Library</li>
1145
1146
1147
      </ul>
      <ul class="breadcrumb">
        <li><a href="#">Home</a> <span class="divider">/</span></li>
1148
1149
        <li><a href="#">Library</a> <span class="divider">/</span></li>
        <li class="active">Data</li>
1150
      </ul>
1151
1152
1153
1154
    </div>
    <div class="span6">
      <h3>Markup</h3>
      <p>HTML is your standard unordered list with links.</p>
1155
1156
<pre class="prettyprint linenums">
&lt;ul class="breadcrumb"&gt;
1157
1158
1159
1160
1161
1162
  &lt;li&gt;
    &lt;a href="#"&gt;Home&lt;/a&gt; &lt;span class="divider"&gt;/&lt;/span&gt;
  &lt;/li&gt;
  &lt;li&gt;
    &lt;a href="#"&gt;Library&lt;/a&gt; &lt;span class="divider"&gt;/&lt;/span&gt;
  &lt;/li&gt;
1163
  &lt;li class="active"&gt;Data&lt;/li&gt;
1164
1165
1166
1167
1168
&lt;/ul&gt;
</pre>
    </div>
  </div>

1169
1170
1171
1172
1173
1174
</section>



<!-- Pagination
================================================== -->
Chris Gunther's avatar
Chris Gunther committed
1175
<section id="pagination">
1176
  <div class="page-header">
1177
    <h1>Pagination <small>Two options for paging through content</small></h1>
1178
1179
  </div>

Mark Otto's avatar
Mark Otto committed
1180
  <h2>Multicon-page pagination</h2>
1181
  <div class="row">
1182
1183
1184
1185
1186
1187
1188
    <div class="span4">
      <h3>When to use</h3>
      <p>Ultra simplistic and minimally styled pagination inspired by Rdio, great for apps and search results. The large block is hard to miss, easily scalable, and provides large click areas.</p>
      <h3>Stateful page links</h3>
      <p>Links are customizable and work in a number of circumstances with the right class. <code>.disabled</code> for unclickable links and <code>.active</code> for current page.</p>
      <h3>Flexible alignment</h3>
      <p>Add either of two optional classes to change the alignment of pagination links: <code>.pagination-centered</code> and <code>.pagination-right</code>.</p>
1189
    </div>
1190
1191
1192
    <div class="span4">
      <h3>Examples</h3>
      <p>The default pagination component is flexible and works in a number of variations.</p>
1193
1194
      <div class="pagination">
        <ul>
1195
          <li class="disabled"><a href="#">&laquo;</a></li>
1196
1197
1198
1199
          <li class="active"><a href="#">1</a></li>
          <li><a href="#">2</a></li>
          <li><a href="#">3</a></li>
          <li><a href="#">4</a></li>
1200
          <li><a href="#">&raquo;</a></li>
1201
1202
1203
1204
        </ul>
      </div>
      <div class="pagination">
        <ul>
1205
          <li><a href="#">&laquo;</a></li>
1206
          <li><a href="#">10</a></li>
1207
1208
1209
          <li class="active"><a href="#">11</a></li>
          <li><a href="#">12</a></li>
          <li><a href="#">&raquo;</a></li>
1210
1211
1212
1213
1214
        </ul>
      </div>
      <div class="pagination">
        <ul>
          <li><a href="#">&larr;</a></li>
1215
          <li class="active"><a href="#">10</a></li>
1216
          <li class="disabled"><a href="#">...</a></li>
1217
          <li><a href="#">20</a></li>
1218
          <li><a href="#">&rarr;</a></li>
1219
1220
        </ul>
      </div>
1221
      <div class="pagination pagination-centered">
1222
        <ul>
1223
1224
1225
1226
1227
          <li class="active"><a href="#">1</a></li>
          <li><a href="#">2</a></li>
          <li><a href="#">3</a></li>
          <li><a href="#">4</a></li>
          <li><a href="#">5</a></li>
1228
1229
        </ul>
      </div>
1230
1231
1232
1233
    </div>
    <div class="span4">
      <h3>Markup</h3>
      <p>Wrapped in a <code>&lt;div&gt;</code>, pagination is just a <code>&lt;ul&gt;</code>.</p>
1234
1235
1236
<pre class="prettyprint linenums">
&lt;div class="pagination"&gt;
  &lt;ul&gt;
1237
1238
1239
1240
    &lt;li&gt;&lt;a href="#"&gt;Prev&lt;/a&gt;&lt;/li>
    &lt;li class="active"&gt;
      &lt;a href="#"&gt;1&lt;/a&gt;
    &lt;/li&gt;
1241
1242
1243
    &lt;li&gt;&lt;a href="#"&gt;2&lt;/a&gt;&lt;/li&gt;
    &lt;li&gt;&lt;a href="#"&gt;3&lt;/a&gt;&lt;/li&gt;
    &lt;li&gt;&lt;a href="#"&gt;4&lt;/a&gt;&lt;/li&gt;
1244
    &lt;li&gt;&lt;a href="#"&gt;Next&lt;/a&gt;&lt;/li>
1245
1246
1247
1248
1249
1250
  &lt;/ul&gt;
&lt;/div&gt;
</pre>
    </div>
  </div><!-- /row -->

1251
1252
1253
1254
  <h2>Pager <small>For quick previous and next links</small></h2>
  <div class="row">
    <div class="span4">
      <h3>About pager</h3>
Kyle Robinson Young's avatar
Kyle Robinson Young committed
1255
      <p>The pager component is a set of links for simple pagination implementations with light markup and even lighter styles. It's great for simple sites like blogs or magazines.</p>
1256
1257
      <h4>Optional disabled state</h4>
      <p>Pager links also use the general <code>.disabled</code> class from the pagination.</p>
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
    </div>
    <div class="span4">
      <h3>Default example</h3>
      <p>By default, the pager centers links.</p>
      <ul class="pager">
        <li><a href="#">Previous</a></li>
        <li><a href="#">Next</a></li>
      </ul>
<pre class="prettyprint linenums">
&lt;ul class="pager"&gt;
  &lt;li&gt;
    &lt;a href="#"&gt;Previous&lt;/a&gt;
  &lt;/li&gt;
  &lt;li&gt;
    &lt;a href="#"&gt;Next&lt;/a&gt;
  &lt;/li&gt;
&lt;/ul&gt;
</pre>
    </div>
    <div class="span4">
      <h3>Aligned links</h3>
      <p>Alternatively, you can align each link to the sides:</p>
      <ul class="pager">
        <li class="previous"><a href="#">&larr; Older</a></li>
        <li class="next"><a href="#">Newer &rarr;</a></li>
      </ul>
<pre class="prettyprint linenums">
&lt;ul class="pager"&gt;
1286
  &lt;li class="previous"&gt;
1287
1288
    &lt;a href="#"&gt;&amp;larr; Older&lt;/a&gt;
  &lt;/li&gt;
1289
  &lt;li class="next"&gt;
1290
1291
1292
1293
1294
1295
    &lt;a href="#"&gt;Newer &amp;rarr;&lt;/a&gt;
  &lt;/li&gt;
&lt;/ul&gt;
</pre>
    </div>
  </div><!-- /row -->
1296
1297
1298
1299
</section>



1300
1301
1302
1303
1304
1305
1306
1307
1308
<!-- Labels
================================================== -->
<section id="labels">
  <div class="page-header">
    <h1>Inline labels <small>Label and annotate text</small></h1>
  </div>
  <table class="table table-bordered table-striped">
    <thead>
      <tr>
1309
        <th>Labels</th>
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
        <th>Markup</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td>
          <span class="label">Default</span>
        </td>
        <td>
          <code>&lt;span class="label"&gt;Default&lt;/span&gt;</code>
        </td>
      </tr>
      <tr>
        <td>
Mark Otto's avatar
Mark Otto committed
1324
          <span class="label label-success">Success</span>
1325
1326
        </td>
        <td>
1327
          <code>&lt;span class="label label-success"&gt;Success&lt;/span&gt;</code>
1328
1329
1330
1331
        </td>
      </tr>
      <tr>
        <td>
1332
          <span class="label label-warning">Warning</span>
1333
1334
        </td>
        <td>
1335
          <code>&lt;span class="label label-warning"&gt;Warning&lt;/span&gt;</code>
1336
1337
1338
1339
        </td>
      </tr>
      <tr>
        <td>
1340
          <span class="label label-important">Important</span>
1341
1342
        </td>
        <td>
1343
          <code>&lt;span class="label label-important"&gt;Important&lt;/span&gt;</code>
1344
1345
1346
1347
        </td>
      </tr>
      <tr>
        <td>
1348
          <span class="label label-info">Info</span>
1349
1350
        </td>
        <td>
1351
          <code>&lt;span class="label label-info"&gt;Info&lt;/span&gt;</code>
1352
1353
        </td>
      </tr>
1354
1355
1356
1357
1358
1359
1360
1361
      <tr>
        <td>
          <span class="label label-inverse">Inverse</span>
        </td>
        <td>
          <code>&lt;span class="label label-inverse"&gt;Inverse&lt;/span&gt;</code>
        </td>
      </tr>
1362
1363
1364
1365
1366
1367
    </tbody>
  </table>
</section>



Mark Otto's avatar
Mark Otto committed
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
<!-- Badges
================================================== -->
<section id="badges">
  <div class="page-header">
    <h1>Badges <small>Indicators and unread counts</small></h1>
  </div>
  <div class="row">
    <div class="span4">
      <h3>About</h3>
      <p>Badges are small, simple components for displaying an indicator or count of some sort. They're commonly found in email clients like Mail.app or on mobile apps for push notifications.</p>
    </div><!-- /.span -->
    <div class="span8">
      <h3>Available classes</h3>
      <table class="table table-bordered table-striped">
        <thead>
          <tr>
            <th>Name</th>
            <th>Example</th>
            <th>Markup</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td>
              Default
            </td>
            <td>
              <span class="badge">1</span>
            </td>
            <td>
              <code>&lt;span class="badge"&gt;1&lt;/span&gt;</code>
            </td>
          </tr>
          <tr>
            <td>
              Success
            </td>
            <td>
              <span class="badge badge-success">2</span>
            </td>
            <td>
              <code>&lt;span class="badge badge-success"&gt;2&lt;/span&gt;</code>
            </td>
          </tr>
          <tr>
            <td>
              Warning
            </td>
            <td>
              <span class="badge badge-warning">4</span>
            </td>
            <td>
              <code>&lt;span class="badge badge-warning"&gt;4&lt;/span&gt;</code>
            </td>
          </tr>
          <tr>
            <td>
1425
              Important
Mark Otto's avatar
Mark Otto committed
1426
1427
            </td>
            <td>
1428
              <span class="badge badge-important">6</span>
Mark Otto's avatar
Mark Otto committed
1429
1430
            </td>
            <td>
1431
              <code>&lt;span class="badge badge-important"&gt;6&lt;/span&gt;</code>
Mark Otto's avatar
Mark Otto committed
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
            </td>
          </tr>
          <tr>
            <td>
              Info
            </td>
            <td>
              <span class="badge badge-info">8</span>
            </td>
            <td>
              <code>&lt;span class="badge badge-info"&gt;8&lt;/span&gt;</code>
            </td>
          </tr>
          <tr>
            <td>
              Inverse
            </td>
            <td>
              <span class="badge badge-inverse">10</span>
            </td>
            <td>
              <code>&lt;span class="badge badge-inverse"&gt;10&lt;/span&gt;</code>
            </td>
          </tr>
        </tbody>
      </table>
    </div><!-- /.span -->
  </div><!-- /.row -->
</section>



1464
<!-- Typographic components
Mark Otto's avatar
Mark Otto committed
1465
================================================== -->
1466
<section id="typography">
Mark Otto's avatar
Mark Otto committed
1467
  <div class="page-header">
1468
    <h1>Typographic components <small>Page header and hero unit for segmenting content</small></h1>
Mark Otto's avatar
Mark Otto committed
1469
  </div>
1470
  <h2>Hero unit</h2>
Mark Otto's avatar
Mark Otto committed
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
  <div class="row">
    <div class="span4">
      <p>Bootstrap provides a lightweight, flexible component called a hero unit to showcase content on your site. It works well on marketing and content-heavy sites.</p>
      <h3>Markup</h3>
      <p>Wrap your content in a <code>div</code> like so:</p>
<pre class="prettyprint linenums">
&lt;div class="hero-unit"&gt;
  &lt;h1&gt;Heading&lt;/h1&gt;
  &lt;p&gt;Tagline&lt;/p&gt;
  &lt;p&gt;
    &lt;a class="btn btn-primary btn-large"&gt;
      Learn more
    &lt;/a&gt;
  &lt;/p&gt;
&lt;/div&gt;
</pre>
    </div>
    <div class="span8">
      <div class="hero-unit">
        <h1>Hello, world!</h1>
        <p>This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.</p>
        <p><a class="btn btn-primary btn-large">Learn more</a></p>
      </div>
    </div>
1495
1496
1497
1498
  </div><!-- /row -->
  <h2>Page header</h2>
  <div class="row">
    <div class="span4">
Mark's avatar
Mark committed
1499
      <p>A simple shell for an <code>h1</code> to appropriately space out and segment sections of content on a page. It can utilize the <code>h1</code>'s default <code>small</code>, element as well most other components (with additional styles).</p>
1500
1501
    </div>
    <div class="span8">
1502
1503
1504
      <div class="page-header">
        <h1>Example page header <small>Subtext for header</small></h1>
      </div>
1505
<pre class="prettyprint linenums">
1506
&lt;div class="page-header"&gt;
1507
1508
1509
1510
1511
  &lt;h1&gt;Example page header&lt;/h1&gt;
&lt;/div&gt;
</pre>
    </div>
  </div><!-- /row -->
Mark Otto's avatar
Mark Otto committed
1512
1513
1514
1515
</section>



Chris Gunther's avatar
Chris Gunther committed
1516
<!-- Thumbnails
1517
================================================== -->
Chris Gunther's avatar
Chris Gunther committed
1518
<section id="thumbnails">
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
  <div class="page-header">
    <h1>Thumbnails <small>Grids of images, videos, text, and more</small></h1>
  </div>

  <div class="row">
    <div class="span6">
      <h2>Default thumbnails</h2>
      <p>By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.</p>
      <ul class="thumbnails">
        <li class="span3">
          <a href="#" class="thumbnail">
1530
            <img src="http://placehold.it/260x180" alt="">
1531
1532
1533
1534
          </a>
        </li>
        <li class="span3">
          <a href="#" class="thumbnail">
1535
            <img src="http://placehold.it/260x180" alt="">
1536
1537
1538
1539
          </a>
        </li>
        <li class="span3">
          <a href="#" class="thumbnail">
1540
            <img src="http://placehold.it/260x180" alt="">
1541
1542
1543
1544
          </a>
        </li>
        <li class="span3">
          <a href="#" class="thumbnail">
1545
            <img src="http://placehold.it/260x180" alt="">
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
          </a>
        </li>
      </ul>
    </div>
    <div class="span6">
      <h2>Highly customizable</h2>
      <p>With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.</p>
      <ul class="thumbnails">
        <li class="span3">
          <div class="thumbnail">
1556
            <img src="http://placehold.it/260x180" alt="">
1557
1558
1559
            <div class="caption">
              <h5>Thumbnail label</h5>
              <p>Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.</p>
1560
              <p><a href="#" class="btn btn-primary">Action</a> <a href="#" class="btn">Action</a></p>
1561
1562
1563
1564
1565
            </div>
          </div>
        </li>
        <li class="span3">
          <div class="thumbnail">
1566
            <img src="http://placehold.it/260x180" alt="">
1567
1568
1569
            <div class="caption">
              <h5>Thumbnail label</h5>
              <p>Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.</p>
1570
              <p><a href="#" class="btn btn-primary">Action</a> <a href="#" class="btn">Action</a></p>
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
            </div>
          </div>
        </li>
      </ul>
    </div>
  </div>

  <div class="row">
    <div class="span4">
      <h3>Why use thumbnails</h3>
      <p>Thumbnails (previously <code>.media-grid</code> up until v1.4) are great for grids of photos or videos, image search results, retail products, portfolios, and much more. They can be links or static content.</p>
    </div>
    <div class="span4">
      <h3>Simple, flexible markup</h3>
      <p>Thumbnail markup is simple&mdash;a <code>ul</code> with any number of <code>li</code> elements is all that is required. It's also super flexible, allowing for any type of content with just a bit more markup to wrap your contents.</p>
    </div>
    <div class="span4">
      <h3>Uses grid column sizes</h3>
      <p>Lastly, the thumbnails component uses existing grid system classes&mdash;like <code>.span2</code> or <code>.span3</code>&mdash;for control of thumbnail dimensions.</p>
    </div>
  </div>

  <div class="row">
    <div class="span6">
      <h2>The markup</h2>
      <p>As mentioned previously, the required markup for thumbnails is light and straightforward. Here's a look at the default setup <strong>for linked images</strong>:</p>
<pre class="prettyprint linenums">
&lt;ul class="thumbnails"&gt;
  &lt;li class="span3"&gt;
    &lt;a href="#" class="thumbnail"&gt;
1601
      &lt;img src="http://placehold.it/260x180" alt=""&gt;
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
    &lt;/a&gt;
  &lt;/li&gt;
  ...
&lt;/ul&gt;
</pre>
      <p>For custom HTML content in thumbnails, the markup changes slightly. To allow block level content anywhere, we swap the <code>&lt;a&gt;</code> for a <code>&lt;div&gt;</code> like so:</p>
<pre class="prettyprint linenums">
&lt;ul class="thumbnails"&gt;
  &lt;li class="span3"&gt;
    &lt;div class="thumbnail"&gt;
1612
      &lt;img src="http://placehold.it/260x180" alt=""&gt;
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
      &lt;h5&gt;Thumbnail label&lt;/h5&gt;
      &lt;p&gt;Thumbnail caption right here...&lt;/p&gt;
    &lt;/div&gt;
  &lt;/li&gt;
  ...
&lt;/ul&gt;
</pre>
    </div>
    <div class="span6">
      <h2>More examples</h2>
      <p>Explore all your options with the various grid classes available to you. You can also mix and match different sizes.</p>
      <ul class="thumbnails">
        <li class="span4">
          <a href="#" class="thumbnail">
1627
            <img src="http://placehold.it/360x268" alt="">
1628
1629
1630
1631
          </a>
        </li>
        <li class="span2">
          <a href="#" class="thumbnail">
1632
            <img src="http://placehold.it/160x120" alt="">
1633
1634
1635
1636
          </a>
        </li>
        <li class="span2">
          <a href="#" class="thumbnail">
1637
            <img src="http://placehold.it/160x120" alt="">
1638
1639
1640
1641
          </a>
        </li>
        <li class="span2">
          <a href="#" class="thumbnail">
1642
            <img src="http://placehold.it/160x120" alt="">
1643
1644
1645
1646
          </a>
        </li>
        <li class="span2">
          <a href="#" class="thumbnail">
1647
            <img src="http://placehold.it/160x120" alt="">
1648
1649
1650
1651
          </a>
        </li>
        <li class="span2">
          <a href="#" class="thumbnail">
1652
            <img src="http://placehold.it/160x120" alt="">
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
          </a>
        </li>
      </ul>
    </div>
  </div>

</section>



1663
1664
1665
1666
<!-- Alerts & Messages
================================================== -->
<section id="alerts">
  <div class="page-header">
1667
    <h1>Alerts <small>Styles for success, warning, and error messages</small></h1>
1668
  </div>
1669
1670

  <h2>Lightweight defaults</h2>
1671
  <div class="row">
1672
1673
    <div class="span4">
      <h3>Rewritten base class</h3>
Kyle Robinson Young's avatar
Kyle Robinson Young committed
1674
      <p>With Bootstrap 2, we've simplified the base class: <code>.alert</code> instead of <code>.alert-message</code>. We've also reduced the minimum required markup&mdash;no <code>&lt;p&gt;</code> is required by default, just the outer <code>&lt;div&gt;</code>.</p>
1675
      <h3>Single alert message</h3>
Olivier Laviale's avatar
Olivier Laviale committed
1676
      <p>For a more durable component with less code, we've removed the differentiating look for block alerts, messages that come with more padding and typically more text. The class also has changed to <code>.alert-block</code>.</p>
1677
1678
1679
1680
      <hr>
      <h3>Goes great with javascript</h3>
      <p>Bootstrap comes with a great jQuery plugin that supports alert messages, making dismissing them quick and easy.</p>
      <p><a class="btn js-btn" href="./javascript.html#alerts">Get the plugin &raquo;</a></p>
1681
    </div>
1682
1683
1684
1685
    <div class="span8">
      <h3>Example alerts</h3>
      <p>Wrap your message and an optional close icon in a div with simple class.</p>
      <div class="alert">
1686
        <a class="close" data-dismiss="alert">&times;</a>
Mark Otto's avatar
Mark Otto committed
1687
        <strong>Warning!</strong> Best check yo self, you're not looking too good.
1688
      </div>
1689
1690
<pre class="prettyprint linenums">
&lt;div class="alert"&gt;
1691
  &lt;a class="close" data-dismiss="alert"&gt;&times;&lt;/a&gt;
Mark Otto's avatar
Mark Otto committed
1692
  &lt;strong&gt;Warning!&lt;/strong&gt; Best check yo self, you're not looking too good.
1693
1694
&lt;/div&gt;
</pre>
1695
1696
      <p>Easily extend the standard alert message with two optional classes: <code>.alert-block</code> for more padding and text controls and <code>.alert-heading</code> for a matching heading.</p>
      <div class="alert alert-block">
1697
        <a class="close" data-dismiss="alert">&times;</a>
1698
        <h4 class="alert-heading">Warning!</h4>
Mark Otto's avatar
Mark Otto committed
1699
        <p>Best check yo self, you're not looking too good. Nulla vitae elit libero, a pharetra augue. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.</p>
1700
1701
      </div>
<pre class="prettyprint linenums">
1702
&lt;div class="alert alert-block"&gt;
1703
  &lt;a class="close" data-dismiss="alert"&gt;&times;&lt;/a&gt;
1704
  &lt;h4 class="alert-heading"&gt;Warning!&lt;/h4&gt;
Mark Otto's avatar
Mark Otto committed
1705
  Best check yo self, you're not...
1706
1707
1708
&lt;/div&gt;
</pre>
    </div>
1709
  </div>
1710

1711
  <h2>Contextual alternatives <small>Add optional classes to change an alert's connotation</small></h2>
1712
  <div class="row">
1713
1714
    <div class="span4">
      <h3>Error or danger</h3>
1715
      <div class="alert alert-error">
1716
        <a class="close" data-dismiss="alert">&times;</a>
1717
        <strong>Oh snap!</strong> Change a few things up and try submitting again.
1718
      </div>
1719
<pre class="prettyprint linenums">
1720
&lt;div class="alert alert-error"&gt;
1721
1722
1723
1724
1725
1726
  ...
&lt;/div&gt;
</pre>
    </div>
    <div class="span4">
      <h3>Success</h3>
1727
      <div class="alert alert-success">
1728
        <a class="close" data-dismiss="alert">&times;</a>
1729
        <strong>Well done!</strong> You successfully read this important alert message.
1730
      </div>
1731
<pre class="prettyprint linenums">
1732
&lt;div class="alert alert-success"&gt;
1733
1734
1735
1736
1737
1738
  ...
&lt;/div&gt;
</pre>
    </div>
    <div class="span4">
      <h3>Information</h3>
1739
      <div class="alert alert-info">
1740
        <a class="close" data-dismiss="alert">&times;</a>
Mark Otto's avatar
Mark Otto committed
1741
        <strong>Heads up!</strong> This alert needs your attention, but it's not super important.
1742
1743
      </div>
<pre class="prettyprint linenums">
1744
&lt;div class="alert alert-info"&gt;
1745
  ...
1746
1747
1748
&lt;/div&gt;
</pre>
    </div>
1749
1750
  </div>

1751
1752
1753
1754
</section>



Piotrek Okoński's avatar
Piotrek Okoński committed
1755
1756
<!-- Progress bars
================================================== -->
1757
1758
1759
1760
<section id="progress">
  <div class="page-header">
    <h1>Progress bars <small>For loading, redirecting, or action status</small></h1>
  </div>
1761

1762
1763
1764
1765
1766
1767
1768
1769
  <h2>Examples and markup</h2>
  <div class="row">
    <div class="span4">
      <h3>Basic</h3>
      <p>Default progress bar with a vertical gradient.</p>
      <div class="progress">
        <div class="bar" style="width: 60%;"></div>
      </div>
1770
1771
1772
1773
1774
1775
<pre class="prettyprint linenums">
&lt;div class="progress"&gt;
  &lt;div class="bar"
       style="width: 60%;"&gt;&lt;/div&gt;
&lt;/div&gt;
</pre>
1776
1777
1778
    </div>
    <div class="span4">
      <h3>Striped</h3>
1779
      <p>Uses a gradient to create a striped effect (no IE).</p>
1780
      <div class="progress progress-striped">
1781
1782
        <div class="bar" style="width: 20%;"></div>
      </div>
1783
<pre class="prettyprint linenums">
1784
&lt;div class="progress progress-striped"&gt;
1785
1786
1787
1788
  &lt;div class="bar"
       style="width: 20%;"&gt;&lt;/div&gt;
&lt;/div&gt;
</pre>
1789
1790
1791
    </div>
    <div class="span4">
      <h3>Animated</h3>
1792
      <p>Takes the striped example and animates it (no IE).</p>
1793
      <div class="progress progress-striped active">
1794
1795
        <div class="bar" style="width: 45%"></div>
      </div>
1796
<pre class="prettyprint linenums">
1797
1798
&lt;div class="progress progress-striped
     active"&gt;
1799
1800
1801
1802
  &lt;div class="bar"
       style="width: 40%;"&gt;&lt;/div&gt;
&lt;/div&gt;
</pre>
1803
1804
1805
1806
1807
    </div>
  </div>

  <h2>Options and browser support</h2>
  <div class="row">
1808
    <div class="span3">
1809
      <h3>Additional colors</h3>
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
      <p>Progress bars use some of the same button and alert classes for consistent styles.</p>
      <div class="progress progress-info" style="margin-bottom: 9px;">
        <div class="bar" style="width: 20%"></div>
      </div>
      <div class="progress progress-success" style="margin-bottom: 9px;">
        <div class="bar" style="width: 40%"></div>
      </div>
      <div class="progress progress-warning" style="margin-bottom: 9px;">
        <div class="bar" style="width: 60%"></div>
      </div>
      <div class="progress progress-danger" style="margin-bottom: 9px;">
        <div class="bar" style="width: 80%"></div>
      </div>
1823
    </div>
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
     <div class="span3">
      <h3>Striped bars</h3>
      <p>Similar to the solid colors, we have varied striped progress bars.</p>
      <div class="progress progress-info progress-striped" style="margin-bottom: 9px;">
        <div class="bar" style="width: 20%"></div>
      </div>
      <div class="progress progress-success progress-striped" style="margin-bottom: 9px;">
        <div class="bar" style="width: 40%"></div>
      </div>
      <div class="progress progress-warning progress-striped" style="margin-bottom: 9px;">
        <div class="bar" style="width: 60%"></div>
      </div>
      <div class="progress progress-danger progress-striped" style="margin-bottom: 9px;">
        <div class="bar" style="width: 80%"></div>
      </div>
    </div>
    <div class="span3">
1841
1842
      <h3>Behavior</h3>
      <p>Progress bars use CSS3 transitions, so if you dynamically adjust the width via javascript, it will smoothly resize.</p>
1843
      <p>If you use the <code>.active</code> class, your <code>.progress-striped</code> progress bars will animate the stripes left to right.</p>
1844
    </div>
1845
    <div class="span3">
1846
      <h3>Browser support</h3>
1847
1848
      <p>Progress bars use CSS3 gradients, transitions, and animations to achieve all their effects. These features are not supported in IE7-9 or older versions of Firefox.</p>
      <p>Opera and IE do not support animations at this time.</p>
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
    </div>
  </div>

</section>





<!-- Miscellaneous
================================================== -->
<section id="misc">
  <div class="page-header">
Mark Otto's avatar
Mark Otto committed
1862
    <h1>Miscellaneous <small>Lightweight utility components</small></h1>
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
  </div>
  <div class="row">
    <div class="span4">
      <h2>Wells</h2>
      <p>Use the well as a simple effect on an element to give it an inset effect.</p>
      <div class="well">
        Look, I'm in a well!
      </div>
<pre class="prettyprint linenums">
&lt;div class="well"&gt;
  ...
&lt;/div&gt;
</pre>
    </div><!--/span-->
    <div class="span4">
      <h2>Close icon</h2>
      <p>Use the generic close icon for dismissing content like modals and alerts.</p>
      <p><a class="close" style="float: none;">&times;</a></p>
<pre class="prettyprint linenums">&lt;a class="close"&gt;&amp;times;&lt;/a&gt;</pre>
    </div><!--/span-->
  </div><!--/row-->
</section>


Jacob Thornton's avatar
Jacob Thornton committed
1887
     <!-- Footer
1888
1889
1890
      ================================================== -->
      <footer class="footer">
        <p class="pull-right"><a href="#">Back to top</a></p>
Mark Otto's avatar
Mark Otto committed
1891
1892
1893
        <p>Designed and built with all the love in the world <a href="http://twitter.com/twitter" target="_blank">@twitter</a> by <a href="http://twitter.com/mdo" target="_blank">@mdo</a> and <a href="http://twitter.com/fat" target="_blank">@fat</a>.</p>
        <p>Code licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="_blank">Apache License v2.0</a>. Documentation licensed under <a href="http://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a>.</p>
        <p>Icons from <a href="http://glyphicons.com">Glyphicons Free</a>, licensed under <a href="http://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a>.</p>
1894
      </footer>
1895

1896
    </div><!-- /container -->
1897

1898

1899
1900
1901

    <!-- Le javascript
    ================================================== -->
1902
    <!-- Placed at the end of the document so the pages load faster -->
1903
    <script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script>
Jacob Thornton's avatar
Jacob Thornton committed
1904
    <script src="assets/js/jquery.js"></script>
1905
    <script src="assets/js/google-code-prettify/prettify.js"></script>
Jacob Thornton's avatar
Jacob Thornton committed
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
    <script src="assets/js/bootstrap-transition.js"></script>
    <script src="assets/js/bootstrap-alert.js"></script>
    <script src="assets/js/bootstrap-modal.js"></script>
    <script src="assets/js/bootstrap-dropdown.js"></script>
    <script src="assets/js/bootstrap-scrollspy.js"></script>
    <script src="assets/js/bootstrap-tab.js"></script>
    <script src="assets/js/bootstrap-tooltip.js"></script>
    <script src="assets/js/bootstrap-popover.js"></script>
    <script src="assets/js/bootstrap-button.js"></script>
    <script src="assets/js/bootstrap-collapse.js"></script>
    <script src="assets/js/bootstrap-carousel.js"></script>
    <script src="assets/js/bootstrap-typeahead.js"></script>
1918
    <script src="assets/js/application.js"></script>
1919
1920


1921
1922
  </body>
</html>