index.html 77.3 KB
Newer Older
1
2
3
4
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
5
    <title>Bootstrap, from Twitter</title>
6
7
    <meta name="description" content="">
    <meta name="author" content="">
8

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

14
    <!-- Le styles -->
15
    <link href="../bootstrap.css" rel="stylesheet">
Jacob Thornton's avatar
Jacob Thornton committed
16
    <link href="assets/css/docs.css" rel="stylesheet">
17
    <link href="assets/js/google-code-prettify/prettify.css" rel="stylesheet">
18

19
    <!-- Le javascript -->
Jacob Thornton's avatar
Jacob Thornton committed
20
    <script src="http://code.jquery.com/jquery-1.5.2.min.js"></script>
Jacob Thornton's avatar
Jacob Thornton committed
21
    <script src="http://autobahn.tablesorter.com/jquery.tablesorter.min.js"></script>
Mark Otto's avatar
Mark Otto committed
22
    <script src="assets/js/google-code-prettify/prettify.js"></script>
23
    <script>$(function () { prettyPrint() })</script>
Jacob Thornton's avatar
Jacob Thornton committed
24
    <script src="../js/bootstrap-dropdown.js"></script>
25
    <script src="../js/bootstrap-twipsy.js"></script>
Jacob Thornton's avatar
Jacob Thornton committed
26
    <script src="../js/bootstrap-scrollspy.js"></script>
Jacob Thornton's avatar
Jacob Thornton committed
27
    <script src="assets/js/application.js"></script>
28
29

    <!-- Le fav and touch icons -->
30
31
32
33
    <link rel="shortcut icon" type="image/x-icon" href="assets/ico/favicon.ico">
    <link rel="apple-touch-icon" href="assets/ico/bootstrap-apple-57x57.png">
    <link rel="apple-touch-icon" sizes="72x72" href="assets/ico/bootstrap-apple-72x72.png">
    <link rel="apple-touch-icon" sizes="114x114" href="assets/ico/bootstrap-apple-114x114.png">
34
35
  </head>

36
  <body>
37

Mark Otto's avatar
Mark Otto committed
38
39
    <!-- Topbar
    ================================================== -->
40
41
    <div class="navbar navbar-fixed" data-scrollspy="scrollspy">
      <div class="navbar-inner">
Jacob Thornton's avatar
Jacob Thornton committed
42
        <div class="container">
43
          <a class="brand" href="#">Bootstrap</a>
44
          <ul class="nav">
Mark Otto's avatar
Mark Otto committed
45
            <li class="active"><a href="#overview">Overview</a></li>
Jacob Thornton's avatar
Jacob Thornton committed
46
            <li><a href="#about">About</a></li>
47
48
            <li class="dropdown">
              <a href="#" class="dropdown-toggle" data-dropdown="true">Scaffolding</a>
49
50
51
52
53
              <ul class="dropdown-menu">
                <li><a href="#grid-system">Grid</a></li>
                <li><a href="#layouts">Layouts</a></li>
              </ul>
            </li>
54
55
            <li class="dropdown">
              <a href="#" class="dropdown-toggle" data-dropdown="true">CSS</a>
56
57
58
59
60
61
              <ul class="dropdown-menu">
                <li><a href="#typography">Type</a></li>
                <li><a href="#tables">Tables</a></li>
                <li><a href="#forms">Forms</a></li>
              </ul>
            </li>
62
63
            <li class="dropdown">
              <a href="#" class="dropdown-toggle" data-dropdown="true">Patterns</a>
64
65
66
67
68
69
70
              <ul class="dropdown-menu">
                <li><a href="#media">Media</a></li>
                <li><a href="#navigation">Navigation</a></li>
                <li><a href="#alerts">Alerts</a></li>
                <li><a href="#popovers">Popovers</a></li>
              </ul>
            </li>
71
            <li><a href="#javascript">Javascript</a></li>
Jacob Thornton's avatar
Jacob Thornton committed
72
73
74
            <li><a href="#less">Less</a></li>
          </ul>
        </div>
75
76
77
      </div>
    </div>

78
79
80
81
82
83
84
85
86
87
88
89
90
  <div class="container">

    <div id="overview">
      <!-- Masthead (blueprinty thing)
      ================================================== -->
      <header class="jumbotron masthead">
        <div class="inner">
          <h1>Bootstrap, from Twitter</h1>
          <a href="#" class="btn btn-large pull-right">Download on GitHub</a>
          <p class="lead">Bootstrap is a frontend toolkit from Twitter designed to kickstart web development, complete with core HTML, CSS, and JS for grids, type, forms, navigation, and many more components.</p>
          <p><strong>Nerd alert:</strong> Bootstrap is <a href="#less" title="Read about using Bootstrap with Less">built with Less</a> and was designed with modern browsers in mind.</p>
        </div>
      </header>
91

92
93
94
      <!-- Quickstart options
      ================================================== -->
      <div class="quickstart" style="display: none;">
95
        <div class="row">
96
          <div class="span4">
97
98
99
            <h6>Hotlink the CSS</h6>
            <p>For the quickest and easiest start, just copy this snippet into your webpage.</p>
            <form>
100
              <textarea class="copy-code" rows="1">&lt;link rel="stylesheet" href="http://twitter.github.com/bootstrap/assets/css/bootstrap.min.css"></textarea>
101
102
            </form>
          </div>
103
          <div class="span4">
104
105
            <h6>Use it with Less</h6>
            <p>A fan of using Less? No problem, just clone the repo and add these lines:</p>
106
            <form>
Jacob Thornton's avatar
Jacob Thornton committed
107
              <textarea class="copy-code" rows="2">&lt;link rel="stylesheet/less" href="/path/to/bootstrap.less"&gt;
108
  &lt;script src="/path/to/less.js"&gt;&lt;/script&gt;</textarea>
109
110
            </form>
          </div>
111
          <div class="span4">
112
            <h6>Fork on GitHub</h6>
113
            <p>Download, fork, pull, file issues, and more with the official Bootstrap repo on Github.</p>
Jacob Thornton's avatar
Jacob Thornton committed
114
            <p><a target="_blank" href="https://github.com/twitter/bootstrap" class="btn primary">Bootstrap on GitHub &raquo;</a></p>
Mark Otto's avatar
Mark Otto committed
115
            <p class="current-version">Currently <a href="https://github.com/twitter/bootstrap/wiki/Changelog">v1.3.0</a></p>
116
          </div>
117
        </div><!-- /row -->
118
119
      </div>

120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
      <!-- About Bootstrap
      ================================================== -->
      <div class="row">
        <div class="span4">
          <h2>Built for and by nerds</h2>
          <p>Engineers at Twitter have historically used almost any library they were familiar with to meet front-end requirements. Bootstrap began as an answer to the challenges that presented. With the help of many awesome folks, Bootstrap has grown significantly.</p>
          <p>Read more on <a href="https://dev.twitter.com/blog/bootstrap-twitter">dev.twitter.com &rsaquo;</a></p>
        </div>
        <div class="span4">
          <h2>Cross-everything</h2>
          <p>Bootstrap is tested and supported in major modern browsers like Chrome, Safari, Internet Explorer, and Firefox.</p>
          <img src="assets/img/browsers.png" alt="Tested and supported in Chrome, Safari, Internet Explorer, and Firefox">
          <ul>
            <li>Latest Safari</li>
            <li>Latest Google Chrome</li>
            <li>Firefox 4+</li>
            <li>Internet Explorer 7+</li>
            <li>Opera 11</li>
          </ul>
        </div>
        <div class="span4">
          <h2>What's included</h2>
          <p>Bootstrap comes complete with compiled CSS, uncompiled, and example templates.</p>
          <ul>
            <li><span class="label">New in 1.3</span> <a href="./javascript.html">Javascript plugins</a></li>
            <li>All original .less files</li>
            <li>Fully <a href="../bootstrap.css">compiled</a> and <a href="../bootstrap.min.css">minified</a> CSS</li>
            <li>Complete styleguide documentation</li>
            <li>Three example pages with different layouts</li>
          </ul>
        </div>
      </div><!-- /row -->
152
153
154

      <h3>Quick-start examples</h3>
      <p>Need some quick templates? Check out these basic examples we've put together:</p>
155
156
157
158
159
160
161
162
163
164
165
      <ul class="media-grid">
        <li>
          <a href="../examples/hero.html"><img src="assets/img/example-diagram-01.png" alt="Simple three-column layout with hero unit"></a>
        </li>
        <li>
          <a href="../examples/fluid.html"><img src="assets/img/example-diagram-02.png" alt="Fluid layout with static sidebar"></a>
        </li>
        <li>
          <a href="../examples/container-app.html"><img src="assets/img/example-diagram-03.png" alt="Simple hanging container for apps"></a>
        </li>
      </ul>
166

167
    </div><!-- /#overview -->
Mark Otto's avatar
Mark Otto committed
168
169
170
171


<!-- Grid system
================================================== -->
172
<section id="grid-system">
173
174
  <div class="page-header">
    <h1>Grid system <small>Rock the standard 940px or roll your own</small></h1>
175
  </div>
176
  <div class="row">
177
    <div class="span3">
178
179
180
      <h2>Default grid</h2>
      <p>The default grid system provided as part of Bootstrap is a 940px wide 16-column grid. It’s a flavor of the popular 960 grid system, but without the additional margin/padding on the left and right sides.</p>
    </div>
181
    <div class="span9">
182
183
      <h3>Example grid markup</h3>
      <p>As shown here, a basic layout can be created with two "columns," each spanning a number of the 16 foundational columns we defined as part of our grid system. See the examples below for more variations.</p>
184
<pre class="prettyprint linenums">
185
&lt;div class="row"&gt;
Mark Otto's avatar
Mark Otto committed
186
  &lt;div class="span6"&gt;
187
188
    ...
  &lt;/div&gt;
Mark Otto's avatar
Mark Otto committed
189
  &lt;div class="span10"&gt;
190
191
    ...
  &lt;/div&gt;
192
193
&lt;/div&gt;
</pre>
194
    </div>
195
  </div><!-- /row -->
196
  <div class="row show-grid">
197
198
199
200
201
202
203
204
205
206
207
208
    <div class="span1">1</div>
    <div class="span1">1</div>
    <div class="span1">1</div>
    <div class="span1">1</div>
    <div class="span1">1</div>
    <div class="span1">1</div>
    <div class="span1">1</div>
    <div class="span1">1</div>
    <div class="span1">1</div>
    <div class="span1">1</div>
    <div class="span1">1</div>
    <div class="span1">1</div>
209
210
  </div>
  <div class="row show-grid">
Mark Otto's avatar
Mark Otto committed
211
212
213
    <div class="span4">4</div>
    <div class="span4">4</div>
    <div class="span4">4</div>
214
215
  </div>
  <div class="row show-grid">
Mark Otto's avatar
Mark Otto committed
216
    <div class="span4">4</div>
217
218
219
    <div class="span8">8</div>
  </div>
  <div class="row show-grid">
Mark Otto's avatar
Mark Otto committed
220
221
    <div class="span6">6</div>
    <div class="span6">6</div>
222
223
224
225
  </div>
  <div class="row show-grid">
    <div class="span12">12</div>
  </div>
226
227
228
229

  <br>

  <h2>Offsetting columns</h2>
230
  <div class="row show-grid">
Mark Otto's avatar
Mark Otto committed
231
    <div class="span4">4</div>
232
    <div class="span8 offset4">8 offset 4</div>
233
  </div><!-- /row -->
Mark Otto's avatar
Mark Otto committed
234
  <div class="row show-grid">
235
236
    <div class="span3 offset3">3 offset 3</div>
    <div class="span3 offset3">3 offset 3</div>
Mark Otto's avatar
Mark Otto committed
237
  </div><!-- /row -->
238
  <div class="row show-grid">
239
    <div class="span8 offset4">8 offset 4</div>
240
  </div><!-- /row -->
241

242
243
244
245
246
247
248
249
250
  <br>

  <div class="row">
    <div class="span4">
      <h2>Nesting columns</h2>
      <p>Nest your content if you must by creating a <code>.row</code> within an existing column.</p>
    </div>
    <div class="span12">
      <h4>Example of nested columns</h4>
251
      <div class="row show-grid">
252
253
254
255
256
257
258
259
260
261
        <div class="span12">
          Level 1 of column
          <div class="row show-grid">
            <div class="span6">
              Level 2
            </div>
            <div class="span6">
              Level 2
            </div>
          </div>
262
263
        </div>
      </div>
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
<pre class="prettyprint linenums">
&lt;div class="row"&gt;
  &lt;div class="span12"&gt;
    Level 1 of column
    &lt;div class="row"&gt;
      &lt;div class="span6"&gt;
        Level 2
      &lt;/div&gt;
      &lt;div class="span6"&gt;
        Level 2
      &lt;/div&gt;
    &lt;/div&gt;
  &lt;/div&gt;
&lt;/div&gt;
</pre>
279
    </div>
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
  </div>

  <br>

  <div class="row">
    <div class="span4">
      <h2>Roll your own grid</h2>
      <p>Built into Bootstrap are a handful of variables for customizing the default 940px grid system. With a bit of customization, you can modify the size of columns, their gutters, and the container they reside in.</p>
    </div>
    <div class="span12">
      <h3>Inside the grid</h3>
      <p>The variables needed to modify the grid system currently all reside in <code>preboot.less</code>.</p>
      <table class="zebra-striped">
        <thead>
          <tr>
            <th>Variable</th>
            <th>Default value</th>
            <th>Description</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td><code>@gridColumns</code></td>
            <td>16</td>
            <td>The number of columns within the grid</td>
          </tr>
          <tr>
            <td><code>@gridColumnWidth</code></td>
            <td>40px</td>
            <td>The width of each column within the grid</td>
          </tr>
          <tr>
            <td><code>@gridGutterWidth</code></td>
            <td>20px</td>
            <td>The negative space between each column</td>
          </tr>
          <tr>
            <td><code>@siteWidth</code></td>
            <td><em>Computed sum of all columns and gutters</em></td>
            <td>We use some basic match to count the number of columns and gutters and set the width of the <code>.fixed-container()</code> mixin.</td>
          </tr>
        </tbody>
      </table>
323
324
325
      <h3>Now to customize</h3>
      <p>Modifying the grid means changing the three <code>@grid-*</code> variables and recompiling the Less files.</p>
      <p>Bootstrap comes equipped to handle a grid system with up to 24 columns; the default is just 16. Here's how your grid variables would look customized to a 24-column grid.</p>
326
      <pre class="prettyprint linenums">@gridColumns:       24;
327
328
329
@gridColumnWidth:   20px;
@gridGutterWidth:   20px;</pre>
      <p>Once recompiled, you'll be set!</p>
330
331
    </div>
  </div>
332
333
334
335
</section>



Mark Otto's avatar
Mark Otto committed
336
337
<!-- Layouts (Default and fluid)
================================================== -->
338
339
340
341
<section id="layouts">
  <div class="page-header">
    <h1>Layouts <small>Basic templates to create webpages</small></h1>
  </div>
Mark Otto's avatar
Mark Otto committed
342

343
  <div class="row">
Mark Otto's avatar
Mark Otto committed
344
    <div class="span8">
345
      <h2>Fixed layout</h2>
346
      <p>The default and simple 940px-wide, centered layout for just about any website or page provided by a single <code>&lt;div.container&gt;</code>.</p>
347
348
349
      <div class="mini-layout">
        <div class="mini-layout-body"></div>
      </div>
350
<pre class="prettyprint linenums">
351
352
353
354
355
356
&lt;body&gt;
  &lt;div class="container"&gt;
    ...
  &lt;/div&gt;
&lt;/body&gt;
</pre>
357
    </div><!-- /col -->
Mark Otto's avatar
Mark Otto committed
358
    <div class="span8">
359
      <h2>Fluid layout</h2>
360
      <p>An alternative, flexible fluid page structure with min- and max-widths and a left-hand sidebar. Great for apps and docs.</p>
361
362
363
364
      <div class="mini-layout fluid">
        <div class="mini-layout-sidebar"></div>
        <div class="mini-layout-body"></div>
      </div>
365
<pre class="prettyprint linenums">
366
367
368
369
370
371
372
373
374
375
376
&lt;body&gt;
  &lt;div class="container-fluid"&gt;
    &lt;div class="sidebar"&gt;
      ...
    &lt;/div&gt;
    &lt;div class="content"&gt;
      ...
    &lt;/div&gt;
  &lt;/div&gt;
&lt;/body&gt;
</pre>
377
378
    </div><!-- /col -->
  </div><!-- /row -->
379
380
381
382
</section>



Mark Otto's avatar
Mark Otto committed
383
384
<!-- Typography
================================================== -->
385
<section id="typography">
Mark Otto's avatar
Mark Otto committed
386
387
  <div class="page-header">
    <h1>Typography <small>Headings, paragraphs, lists, and other inline type elements</small></h1>
388
  </div>
389

Mark Otto's avatar
Mark Otto committed
390
391
  <!-- Headings & Paragraph Copy -->
  <div class="row">
Mark Otto's avatar
Mark Otto committed
392
    <div class="span4">
393
      <h2>Headings &amp; copy</h2>
Mark Otto's avatar
Mark Otto committed
394
      <p>A standard typographic hierarchy for structuring your webpages.</p>
395
396
      <p>The entire typographic grid is based on two Less variables in our preboot.less file: <code>@basefont</code> and <code>@baseline</code>. The first is the base font-size used throughout and the second is the base line-height.</p>
      <p>We use those variables, and some math, to create the margins, paddings, and line-heights of all our type and more.</p>
Mark Otto's avatar
Mark Otto committed
397
    </div>
Mark Otto's avatar
Mark Otto committed
398
    <div class="span4">
Mark Otto's avatar
Mark Otto committed
399
400
401
402
403
404
405
      <h1>h1. Heading 1</h1>
      <h2>h2. Heading 2</h2>
      <h3>h3. Heading 3</h3>
      <h4>h4. Heading 4</h4>
      <h5>h5. Heading 5</h5>
      <h6>h6. Heading 6</h6>
    </div>
Mark Otto's avatar
Mark Otto committed
406
    <div class="span8">
Mark Otto's avatar
Mark Otto committed
407
408
409
410
      <h3>Example paragraph</h3>
      <p>Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Nullam id dolor id nibh ultricies vehicula ut id elit.</p>
      <h1>Example heading <small>Has sub-heading&hellip;</small></h1>
    </div>
411
412
  </div>

Mark Otto's avatar
Mark Otto committed
413
414
  <!-- Misc Elements -->
  <div class="row">
Mark Otto's avatar
Mark Otto committed
415
    <div class="span4">
Mark Otto's avatar
Mark Otto committed
416
417
418
419
420
421
422
423
424
      <h2>Misc. elements</h2>
      <p>Using emphasis, addresses, &amp; abbreviations</p>
      <p>
        <code>&lt;strong&gt;</code>
        <code>&lt;em&gt;</code>
        <code>&lt;address&gt;</code>
        <code>&lt;abbr&gt;</code>
      </p>
    </div>
Mark Otto's avatar
Mark Otto committed
425
    <div class="span12">
426
      <h3>When to use</h3>
Mark Otto's avatar
Mark Otto committed
427
428
429
      <p>Emphasis tags (<code>&lt;strong&gt;</code> and <code>&lt;em&gt;</code>) should be used to indicate additional importance or emphasis of a word or phrase relative to its surrounding copy. Use <code>&lt;strong&gt;</code> for importance and <code>&lt;em&gt;</code> for <em>stress</em> emphasis.</p>
      <h3>Emphasis in a paragraph</h3>
      <p><a href="#">Fusce dapibus</a>, <strong>tellus ac cursus commodo</strong>, <em>tortor mauris condimentum nibh</em>, ut fermentum massa justo sit amet risus. Maecenas faucibus mollis interdum. Nulla vitae elit libero, a pharetra augue.</p>
430
      <p><strong>Note:</strong> It's still okay to use <code>&lt;b&gt;</code> and <code>&lt;i&gt;</code> tags in HTML5 and they don't have to be styled bold and italic, respectively (although if there is a more semantic element, use it). <code>&lt;b&gt;</code> is meant to highlight words or phrases without conveying additional importance, while <code>&lt;i&gt;</code> is mostly for voice, technical terms, etc.</p>
Mark Otto's avatar
Mark Otto committed
431
      <h3>Addresses</h3>
Mark Otto's avatar
Mark Otto committed
432
433
434
435
436
      <p>The <code>&lt;address&gt;</code> element is used for contact information for its nearest ancestor, or the entire body of work. Here are two examples of how it could be used:</p>

      <div class="row">
        <div class="span4">
          <address>
437
438
439
            <strong>Twitter, Inc.</strong><br>
            795 Folsom Ave, Suite 600<br>
            San Francisco, CA 94107<br>
Mark Otto's avatar
Mark Otto committed
440
441
442
443
444
            <abbr title="Phone">P:</abbr> (123) 456-7890
          </address>
        </div>
        <div class="span4">
          <address>
445
            <strong>Full Name</strong><br>
Mark Otto's avatar
Mark Otto committed
446
447
448
449
450
            <a mailto="">first.last@gmail.com</a>
          </address>
        </div>
      </div>

Mark Otto's avatar
Mark Otto committed
451
452
453
454
      <p><strong>Note:</strong> Each line in an <code>&lt;address&gt;</code> must end with a line-break (<code>&lt;br /&gt;</code>) or be wrapped in a block-level tag (e.g., <code>&lt;p&gt;</code>) to properly structure the content.</p>
      <h3>Abbreviations</h3>
      <p>For abbreviations and acronyms, use the <code>&lt;abbr&gt;</code> tag (<code>&lt;acronym&gt;</code> is deprecated in <abbr title="HyperText Markup Langugage 5">HTML5</abbr>). Put the shorthand form within the tag and set a title for the complete name.</p>
    </div>
455
  </div><!-- /row -->
456

Mark Otto's avatar
Mark Otto committed
457
458
  <!-- Blockquotes -->
  <div class="row">
Mark Otto's avatar
Mark Otto committed
459
    <div class="span4">
Mark Otto's avatar
Mark Otto committed
460
461
462
463
464
465
466
      <h2>Blockquotes</h2>
      <p>
        <code>&lt;blockquote&gt;</code>
        <code>&lt;p&gt;</code>
        <code>&lt;small&gt;</code>
      </p>
    </div>
Mark Otto's avatar
Mark Otto committed
467
    <div class="span12">
468
      <h3>How to quote</h3>
Mark Otto's avatar
Mark Otto committed
469
      <p>To include a blockquote, wrap <code>&lt;blockquote&gt;</code> around <code>&lt;p&gt;</code> and <code>&lt;small&gt;</code> tags. Use the <code>&lt;small&gt;</code> element to cite your source and you'll get an em dash <code>&amp;mdash;</code> before it.</p>
Mark Otto's avatar
Mark Otto committed
470
      <blockquote>
Mark Otto's avatar
Mark Otto committed
471
        <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante venenatis dapibus posuere velit aliquet.</p>
Mark Otto's avatar
Mark Otto committed
472
473
        <small>Dr. Julius Hibbert</small>
      </blockquote>
474
475
476
477
478
479
<pre class="prettyprint linenums">
&lt;blockquote&gt;
  &lt;p&gt;Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante venenatis dapibus posuere velit aliquet.&lt;/p&gt;
  &lt;small&gt;Dr. Julius Hibbert&lt;/small&gt;
&lt;/blockquote&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
480
    </div>
481
  </div><!-- /row -->
482

Mark Otto's avatar
Mark Otto committed
483
484
  <h2>Lists</h2>
  <div class="row">
Mark Otto's avatar
Mark Otto committed
485
    <div class="span4">
Mark Otto's avatar
Mark Otto committed
486
487
      <h4>Unordered <code>&lt;ul&gt;</code></h4>
      <ul>
Mark Otto's avatar
Mark Otto committed
488
489
490
491
492
        <li>Lorem ipsum dolor sit amet</li>
        <li>Consectetur adipiscing elit</li>
        <li>Integer molestie lorem at massa</li>
        <li>Facilisis in pretium nisl aliquet</li>
        <li>Nulla volutpat aliquam velit
Mark Otto's avatar
Mark Otto committed
493
          <ul>
Mark Otto's avatar
Mark Otto committed
494
495
496
497
            <li>Phasellus iaculis neque</li>
            <li>Purus sodales ultricies</li>
            <li>Vestibulum laoreet porttitor sem</li>
            <li>Ac tristique libero volutpat at</li>
Mark Otto's avatar
Mark Otto committed
498
499
          </ul>
        </li>
Mark Otto's avatar
Mark Otto committed
500
501
502
        <li>Faucibus porta lacus fringilla vel</li>
        <li>Aenean sit amet erat nunc</li>
        <li>Eget porttitor lorem</li>
Mark Otto's avatar
Mark Otto committed
503
504
      </ul>
    </div>
Mark Otto's avatar
Mark Otto committed
505
    <div class="span4">
Mark Otto's avatar
Mark Otto committed
506
507
      <h4>Unstyled <code>&lt;ul.unstyled&gt;</code></h4>
      <ul class="unstyled">
Mark Otto's avatar
Mark Otto committed
508
509
510
511
512
        <li>Lorem ipsum dolor sit amet</li>
        <li>Consectetur adipiscing elit</li>
        <li>Integer molestie lorem at massa</li>
        <li>Facilisis in pretium nisl aliquet</li>
        <li>Nulla volutpat aliquam velit
Mark Otto's avatar
Mark Otto committed
513
          <ul>
Mark Otto's avatar
Mark Otto committed
514
515
516
517
            <li>Phasellus iaculis neque</li>
            <li>Purus sodales ultricies</li>
            <li>Vestibulum laoreet porttitor sem</li>
            <li>Ac tristique libero volutpat at</li>
Mark Otto's avatar
Mark Otto committed
518
519
          </ul>
        </li>
Mark Otto's avatar
Mark Otto committed
520
521
522
        <li>Faucibus porta lacus fringilla vel</li>
        <li>Aenean sit amet erat nunc</li>
        <li>Eget porttitor lorem</li>
Mark Otto's avatar
Mark Otto committed
523
524
      </ul>
    </div>
Mark Otto's avatar
Mark Otto committed
525
    <div class="span4">
Mark Otto's avatar
Mark Otto committed
526
527
      <h4>Ordered <code>&lt;ol&gt;</code></h4>
      <ol>
Mark Otto's avatar
Mark Otto committed
528
529
530
531
532
533
534
535
        <li>Lorem ipsum dolor sit amet</li>
        <li>Consectetur adipiscing elit</li>
        <li>Integer molestie lorem at massa</li>
        <li>Facilisis in pretium nisl aliquet</li>
        <li>Nulla volutpat aliquam velit</li>
        <li>Faucibus porta lacus fringilla vel</li>
        <li>Aenean sit amet erat nunc</li>
        <li>Eget porttitor lorem</li>
Mark Otto's avatar
Mark Otto committed
536
537
      </ol>
    </div>
Mark Otto's avatar
Mark Otto committed
538
    <div class="span4">
Mark Otto's avatar
Mark Otto committed
539
540
541
542
543
544
545
546
547
548
549
      <h4>Description <code>dl</code></h4>
      <dl>
        <dt>Description lists</dt>
        <dd>A description list is perfect for defining terms.</dd>
        <dt>Euismod</dt>
        <dd>Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.</dd>
        <dd>Donec id elit non mi porta gravida at eget metus.</dd>
        <dt>Malesuada porta</dt>
        <dd>Etiam porta sem malesuada magna mollis euismod.</dd>
      </dl>
    </div>
550
  </div><!-- /row -->
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565


  <!-- Code -->
  <div class="row">
    <div class="span4">
      <h2>Code</h2>
      <p>
        <code>&lt;code&gt;</code>
        <code>&lt;pre&gt;</code>
      </p>
      <p>Pimp your code in style with two simple tags. For even more awesomeness through javascript, drop in Google's code prettify library and you're set.</p>
    </div>
    <div class="span12">
      <h3>Presenting code</h3>
      <p>Code, blocks of or just snippets inline, can be displayed with style just by wrapping in the right tag. For blocks of code spanning multiple lines, use the <code>&lt;pre&gt;</code> element. For inline code, use the <code>&lt;code&gt;</code> element.</p>
Mark Otto's avatar
Mark Otto committed
566
      <table class="zebra-striped">
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
        <thead>
          <tr>
            <th style="width: 190px;">Element</th>
            <th>Result</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td><code>&lt;code&gt;</code></td>
            <td>In a line of text like this, your wrapped code will look like this <code>&gt;html&lt;</code> element.</td>
          </tr>
          <tr>
            <td><code>&lt;pre&gt;</code></td>
            <td>
<pre>&lt;div&gt;
  &lt;h1&gt;Heading&lt;/h1&gt;
  &lt;p&gt;Something right here...&lt;/p&gt;
&lt;/div&gt;</pre>
              <p><strong>Note:</strong> Be sure to keep code within <code>pre</code> tags as close to the left as possible; it will render all tabs.</p>
            </td>
          </tr>
          <tr>
            <td><code>&lt;pre class="prettyprint"&gt;</code></td>
            <td>
              <p>Using the google-code-prettify library, you're blocks of code get a slightly different visual style and automatic syntax highlighting.</p>
<pre class="prettyprint">&lt;div&gt;
  &lt;h1&gt;Heading&lt;/h1&gt;
  &lt;p&gt;Something right here...&lt;/p&gt;
&lt;/div&gt;</pre>
              <p><a href="http://code.google.com/p/google-code-prettify/">Download google-code-prettify</a> and view the readme for <a href="http://google-code-prettify.googlecode.com/svn/trunk/README.html">how to use</a>.</p>
            </td>
          </tr>
        </tbody>
      </table>
    </div>
  </div><!-- /row -->

  <!-- Labels -->
  <div class="row">
    <div class="span4">
Mark Otto's avatar
Mark Otto committed
607
      <h2>Inline labels</h2>
608
609
610
      <p>
        <code>&lt;span class="label"&gt;</code>
      </p>
611
      <p>Call attention to or flag any phrase in your body text.</p>
612
613
614
615
    </div>
    <div class="span12">
      <h3>Label anything</h3>
      <p>Ever needed one of those fancy <span class="label success">New!</span> or <span class="label important">Important</span> flags when writing code? Well, now you have them. Here's what's included by default:</p>
Mark Otto's avatar
Mark Otto committed
616
      <table class="zebra-striped">
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
        <thead>
          <tr>
            <th style="width: 50%;">Label</th>
            <th>Result</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td>
              <code>&lt;span class="label"&gt;Default&lt;/span&gt;</code>
            </td>
            <td>
              <span class="label">Default</span>
            </td>
          </tr>
          <tr>
            <td>
              <code>&lt;span class="label success"&gt;New&lt;/span&gt;</code>
            </td>
            <td>
              <span class="label success">New</span>
            </td>
          </tr>
          <tr>
            <td>
              <code>&lt;span class="label warning"&gt;Warning&lt;/span&gt;</code>
            </td>
            <td>
              <span class="label warning">Warning</span>
            </td>
          </tr>
          <tr>
            <td>
              <code>&lt;span class="label important"&gt;Important&lt;/span&gt;</code>
            </td>
            <td>
              <span class="label important">Important</span>
            </td>
          </tr>
          <tr>
            <td>
              <code>&lt;span class="label notice"&gt;Notice&lt;/span&gt;</code>
            </td>
            <td>
              <span class="label notice">Notice</span>
            </td>
          </tr>
        </tbody>
      </table>
    </div>
  </div><!-- /row -->

669
670
671
672
</section>



Mark Otto's avatar
Mark Otto committed
673
674
<!-- Tables
================================================== -->
675
<section id="tables">
Mark Otto's avatar
Mark Otto committed
676
677
  <div class="page-header">
    <h1>Tables <small>For, you guessed it, tabular data</small></h1>
678
  </div>
Mark Otto's avatar
Mark Otto committed
679
680
  <!-- Table structure -->
  <div class="row">
Mark Otto's avatar
Mark Otto committed
681
    <div class="span4">
Mark Otto's avatar
Mark Otto committed
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
      <h2>Building tables</h2>
      <p>
        <code>&lt;table&gt;</code>
        <code>&lt;thead&gt;</code>
        <code>&lt;tbody&gt;</code>
        <code>&lt;tr&gt;</code>
        <code>&lt;th&gt;</code>
        <code>&lt;td&gt;</code>
        <code>&lt;colspan&gt;</code>
        <code>&lt;caption&gt;</code>
      </p>
      <p>Tables are great&mdash;for a lot of things. Great tables, however, need a bit of markup love to be useful, scalable, and readable (at the code level). Here are a few tips to help.</p>
      <p>Always wrap your column headers in a <code>&lt;thead&gt;</code> such that hierarchy is <code>&lt;thead&gt;</code> > <code>&lt;tr&gt;</code> > <code>&lt;th&gt;</code>.</p>
      <p>Similar to the column headers, all your table’s body content should be wrapped in a <code>&lt;tbody&gt;</code> so your hierarchy is <code>&lt;tbody&gt;</code> > <code>&lt;tr&gt;</code> > <code>&lt;td&gt;</code>.</p>
    </div>
Mark Otto's avatar
Mark Otto committed
697
    <div class="span12">
Mark Otto's avatar
Mark Otto committed
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
      <h3>Example: Default table styles</h3>
      <p>All tables will be automatically styled with only the essential borders to ensure readability and maintain structure. No need to add extra classes or attributes.</p>
      <table>
        <thead>
          <tr>
            <th>#</th>
            <th>First Name</th>
            <th>Last Name</th>
            <th>Language</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td>1</td>
            <td>Some</td>
            <td>One</td>
            <td>English</td>
          </tr>
          <tr>
            <td>2</td>
            <td>Joe</td>
            <td>Sixpack</td>
            <td>English</td>
          </tr>
          <tr>
            <td>3</td>
            <td>Stu</td>
            <td>Dent</td>
            <td>Code</td>
          </tr>
        </tbody>
      </table>
730
<pre class="prettyprint linenums">
Mark Otto's avatar
Mark Otto committed
731
&lt;table&gt;
732
733
  ...
&lt;/table&gt;</pre>
Mark Otto's avatar
Mark Otto committed
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
      <h3>Example: Zebra-striped</h3>
      <p>Get a little fancy with your tables by adding zebra-striping&mdash;just add the <code>.zebra-striped</code> class.</p>
      <table class="zebra-striped">
        <thead>
          <tr>
            <th>#</th>
            <th>First Name</th>
            <th>Last Name</th>
            <th>Language</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td>1</td>
            <td>Some</td>
            <td>One</td>
            <td>English</td>
          </tr>
          <tr>
            <td>2</td>
            <td>Joe</td>
            <td>Sixpack</td>
            <td>English</td>
          </tr>
          <tr>
            <td>3</td>
            <td>Stu</td>
            <td>Dent</td>
            <td>Code</td>
          </tr>
        </tbody>
      </table>
766
      <p><strong>Note:</strong> Zebra-striping is a progressive enhancement not available for older browsers like IE8 and below.</p>
767
<pre class="prettyprint linenums">
Mark Otto's avatar
Mark Otto committed
768
&lt;table class="zebra-striped"&gt;
769
770
...
&lt;/table&gt;</pre>
Mark Otto's avatar
Mark Otto committed
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
      <h3>Example: Zebra-striped w/ TableSorter.js</h3>
      <p>Taking the previous example, we improve the usefulness of our tables by providing sorting functionality via <a href="http://jquery.com">jQuery</a> and the <a href="http://tablesorter.com/docs/">Tablesorter</a> plugin. <strong>Click any column’s header to change the sort.</strong></p>
      <table class="zebra-striped" id="sortTableExample">
        <thead>
          <tr>
            <th>#</th>
            <th class="yellow">First Name</th>
            <th class="blue">Last Name</th>
            <th class="green">Language</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td>1</td>
            <td>Your</td>
            <td>One</td>
            <td>English</td>
          </tr>
          <tr>
            <td>2</td>
            <td>Joe</td>
            <td>Sixpack</td>
            <td>English</td>
          </tr>
          <tr>
            <td>3</td>
            <td>Stu</td>
            <td>Dent</td>
            <td>Code</td>
          </tr>
        </tbody>
      </table>
803
<pre class="prettyprint linenums">
Jacob Thornton's avatar
Jacob Thornton committed
804
805
806
807
&lt;script src="js/jquery/jquery.tablesorter.min.js"&gt;&lt;/script&gt;
&lt;script &gt;
  $(function() {
    $("table#sortTableExample").tablesorter({ sortList: [[1,0]] });
808
809
  });
&lt;/script&gt;
Mark Otto's avatar
Mark Otto committed
810
&lt;table class="zebra-striped"&gt;
811
812
  ...
&lt;/table&gt;</pre>
Mark Otto's avatar
Mark Otto committed
813
    </div>
814
  </div><!-- /row -->
815
816
817
818
</section>



Mark Otto's avatar
Mark Otto committed
819
820
<!-- Forms
================================================== -->
821
<section id="forms">
Mark Otto's avatar
Mark Otto committed
822
823
  <div class="page-header">
    <h1>Forms</h1>
824
  </div>
825
826
827
828
829
830
831
832
833
834
835
836
837
838
  <div class="row">
    <div class="span-one-third">
      <h3>Four types of forms</h3>
      <p>With 2.0, we now have four types of forms to choose from:</p>
      <ul>
        <li>Search form for a super-rounded input and optional button</li>
        <li>Inline form for a series of elements on one line</li>
        <li>Horizontal form for left-aligned labels</li>
        <li>Vertical form for stacked labels and inputs</li>
      </ul>
    </div>
    <div class="span-one-third">
      <h3></h3>
    </div>
839
  </div><!-- /row -->
Mark Otto's avatar
Mark Otto committed
840
  <div class="row">
Mark Otto's avatar
Mark Otto committed
841
    <div class="span4">
842
      <h2>Search form</h2>
Mark Otto's avatar
Mark Otto committed
843
    </div>
Mark Otto's avatar
Mark Otto committed
844
    <div class="span12">
845
846
847
848
849
850
      <div class="well">
        <form class="form-search">
          <input type="text" class="search-query">
          <button type="submit" class="btn">Search</button>
        </form>
      </div><!--/well-->
851
    </div>
852
  </div><!-- /row -->
Mark Otto's avatar
Mark Otto committed
853
  <div class="row">
Mark Otto's avatar
Mark Otto committed
854
    <div class="span4">
855
      <h2>Inline form</h2>
856
    </div>
Mark Otto's avatar
Mark Otto committed
857
    <div class="span12">
858
859
860
861
862
863
864
865
866
867
      <div class="well">
        <form class="form-inline">
          <h4>Some directional text</h4>
          <p>And maybe some kind of optional supporting text right here.</p>
          <input type="text" class="input-medium">
          <input type="text" class="input-medium">
          <input type="text" class="input-medium">
          <button type="submit" class="btn">Search</button>
        </form>
      </div><!--/well-->
868
    </div>
869
  </div><!-- /row -->
870
871
  <div class="row">
    <div class="span4">
872
      <h2>Horizontal form</h2>
873
874
    </div>
    <div class="span12">
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
      <form class="form-horizontal">
        <legend>Example form</legend>
        <fieldset class="control-group">
          <label class="control-label" for="input01">Text input</label>
          <div class="controls">
            <input type="text" class="xlarge" name="input01">
            <p class="help-text">Help text here. Be sure to fill this out like so, or else!</p>
          </div>
        </fieldset>
        <fieldset class="control-group">
          <label class="control-label" for="select01">Select list</label>
          <div class="controls">
            <select name="select01">
              <option>1</option>
              <option>2</option>
              <option>3</option>
              <option>4</option>
              <option>5</option>
            </select>
          </div>
        </fieldset>
        <fieldset class="control-group">
          <label class="control-label" for="multiSelect">Multi-select</label>
          <div class="controls">
            <select multiple="multiple" name="multiSelect">
              <option>1</option>
              <option>2</option>
              <option>3</option>
              <option>4</option>
              <option>5</option>
            </select>
          </div>
        </fieldset>
        <legend>Example form</legend>
        <fieldset class="control-group">
          <label class="control-label" for="fileInput">File input</label>
          <div class="controls">
912
            <input class="input-file" id="fileInput" name="fileInput" type="file">
913
914
915
916
917
918
919
920
921
922
923
          </div>
        </fieldset>
        <fieldset class="control-group has-error">
          <label class="control-label" for="inputError">Input with error</label>
          <div class="controls">
            <input type="text" name="inputError">
          </div>
        </fieldset>
        <fieldset class="control-group has-error">
          <label class="control-label" for="textareaError">Textarea with error</label>
          <div class="controls">
924
            <textarea class="input-xlarge" rows="3"></textarea>
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
          </div>
        </fieldset>
        <fieldset class="control-group">
          <label class="control-label" for="optionsCheckboxes">Checkboxes</label>
          <div class="controls">
            <div class="control-list">
              <label class="checkbox">
                <input type="checkbox" name="optionsCheckboxes" value="option1">
                Option one is this and that&mdash;be sure to include why it’s great
              </label>
              <label class="checkbox">
                <input type="checkbox" name="optionsCheckboxes" value="option2">
                Option two can also be checked and included in form results
              </label>
              <label class="checkbox">
                <input type="checkbox" name="optionsCheckboxes" value="option3">
                Option three can&mdash;yes, you guessed it&mdash;also be checked and included in form results
              </label>
              <label class="checkbox">
                <input type="checkbox" name="optionsCheckboxes" value="option4">
                Option four cannot be checked as it is disabled
              </label>
            </div>
            <p class="help-text"><strong>Note:</strong> Labels surround all the options for much larger click areas and a more usable form.</p>
          </div>
        </fieldset>
        <fieldset class="control-group">
          <label class="control-label" for="optionsRadios">Radio buttons</label>
          <div class="controls">
            <div class="control-list">
              <label>
956
                <input type="radio" checked name="optionsRadios" value="option1">
957
958
959
                <span>Option one is this and that&mdash;be sure to include why it’s great</span>
              </label>
              <label>
960
                <input type="radio" name="optionsRadios" value="option2">
961
962
963
964
965
966
967
968
969
970
                <span>Option two can is something else and selecting it will deselect options 1</span>
              </label>
            </div>
            <p class="help-text"><strong>Note:</strong> Labels surround all the options for much larger click areas and a more usable form.</p>
          </div>
        </fieldset>
        <fieldset class="form-actions">
          <button type="submit" class="btn primary">Save changes</button>
          <button type="reset" class="btn">Cancel</button>
        </fieldset>
971
972
      </form>
    </div>
973
  </div><!-- /row -->
Mark Otto's avatar
Mark Otto committed
974
  <div class="row">
Mark Otto's avatar
Mark Otto committed
975
    <div class="span4">
976
      <h2>Vertical form</h2>
977
    </div>
Mark Otto's avatar
Mark Otto committed
978
    <div class="span12">
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
      <form class="form-vertical">
        <legend>Example form</legend>
        <fieldset class="control-group">
          <label class="control-label" for="input01">Label</label>
          <div class="controls">
            <input type="text" class="xlarge" name="input01">
            <p class="help-text">Be sure to fill this out like so, or else!</p>
          </div>
        </fieldset>
        <fieldset class="control-group">
          <label class="control-label" for="select01">Label</label>
          <div class="controls">
            <select name="select01"></select>
          </div>
        </fieldset>
        <fieldset class="control-group">
          <label class="control-label" for="input02">Label</label>
          <div class="controls">
            <div class="control-list">
              <label class="checkbox">
                <input type="checkbox"> Something something something something something
              </label>
              <label class="checkbox">
                <input type="checkbox"> Something something something something
              </label>
              <label class="checkbox">
                <input type="checkbox"> Something something something
              </label>
            </div>
          </div>
        </fieldset>
        <fieldset class="form-actions">
          <button type="submit" class="btn primary">Save changes</button>
          <button type="reset" class="btn">Cancel</button>
        </fieldset>
      </form>
1015
    </div>
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
  </div><!-- /row -->

  <div class="row">
    <div class="span4">
      <h2>Buttons</h2>
      <p>As a convention, buttons are used for actions while links are used for objects. For instance, "Download" could be a button and "recent activity" could be a link.</p>
      <p>All buttons default to a light gray style, but a number of functional classes can be applied for different color styles. These classes include a blue <code>.primary</code> class, a light-blue <code>.info</code> class, a green <code>.success</code> class, and a red <code>.danger</code> class.</p>
    </div>
    <div class="span12">
      <h3>Example buttons</h3>
      <p>Button styles can be applied to anything with the <code>.btn</code> applied. Typically you’ll want to apply these to only <code>&lt;a&gt;</code>, <code>&lt;button&gt;</code>, and select <code>&lt;input&gt;</code> elements. Here’s how it looks:</p>
      <div class="well" style="padding: 14px 19px;">
        <button class="btn primary">Primary</button>&nbsp;<button class="btn">Default</button>&nbsp;<button class="btn info">Info</button>&nbsp;<button class="btn success">Success</button>&nbsp;<button class="btn danger">Danger</button>
      </div>
      <h3>Alternate sizes</h3>
      <p>Fancy larger or smaller buttons? Have at it!</p>
      <div class="well">
        <a href="#" class="btn large primary">Primary action</a>
        <a href="#" class="btn large">Action</a>
      </div>
      <div class="well" style="padding: 16px 19px;">
        <a href="#" class="btn small primary">Primary action</a>
        <a href="#" class="btn small">Action</a>
      </div>
      <h3>Disabled state</h3>
      <p>For buttons that are not active or are disabled by the app for one reason or another, use the disabled state. That’s <code>.disabled</code> for links and <code>:disabled</code> for <code>&lt;button&gt;</code> elements.</p>
      <h4>Links</h4>
      <div class="well">
        <a href="#" class="btn large primary disabled">Primary action</a>
        <a href="#" class="btn large disabled">Action</a>
      </div>
      <h4>Buttons</h4>
      <div class="well">
        <button class="btn large primary disabled" disabled="disabled">Primary action</button>&nbsp;<button class="btn large" disabled>Action</button>
      </div>
    </div>
  </div><!-- /row -->

  <div class="row">
    <div class="span4">
      <h2>Button groups</h2>
    </div>
    <div class="span12">
      <h3>Example</h3>
      <div class="well">
        <div class="btn-group">
          <a class="btn" href="#">Left</a>
          <a class="btn" href="#">Middle</a>
          <a class="btn" href="#">Right</a>
        </div>
      </div>
      <div class="well">
        <div class="btn-toolbar">
          <div class="btn-group">
            <a class="btn" href="#">1</a>
            <a class="btn" href="#">2</a>
            <a class="btn" href="#">3</a>
            <a class="btn" href="#">4</a>
            <a class="btn" href="#">5</a>
          </div>
          <div class="btn-group">
            <a class="btn" href="#">6</a>
            <a class="btn" href="#">7</a>
            <a class="btn" href="#">8</a>
          </div>
          <div class="btn-group">
            <a class="btn" href="#">9</a>
          </div>
          <div class="btn-group">
            <a class="btn" href="#">10</a>
          </div>
        </div>
      </div>
    </div>
  </div><!-- /row -->

1092
1093
1094
1095
</section>



1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
<!-- Media
================================================== -->
<section id="media">
  <div class="page-header">
    <h1>Media <small>Displaying images and videos</small></h1>
  </div>
  <!-- Table structure -->
  <div class="row">
    <div class="span4">
      <h2>Media grid</h2>
      <p>Display thumbnails of varying sizes on pages with a low HTML footprint and minimal styles.</p>
    </div>
    <div class="span12">
      <h3>Example thumbnails</h3>
      <p>Thumbnails in the <code>.media-grid</code> can be any size, but they work best when mapped directly to the built-in Bootstrap grid system. Image widths like 90, 210, and 330 combine with a few pixels of padding to equal the <code>.span2</code>, <code>.span4</code>, and <code>.span6</code> column sizes.</p>
      <h4>Large</h4>
      <ul class="media-grid">
        <li>
          <a href="#">
            <img class="thumbnail" src="http://placehold.it/330x230" alt="">
          </a>
        </li>
        <li>
          <a href="#">
            <img class="thumbnail" src="http://placehold.it/330x230" alt="">
          </a>
        </li>
      </ul>
      <h4>Medium</h4>
      <ul class="media-grid">
        <li>
          <a href="#">
            <img class="thumbnail" src="http://placehold.it/210x150" alt="">
          </a>
        </li>
        <li>
          <a href="#">
            <img class="thumbnail" src="http://placehold.it/210x150" alt="">
          </a>
        </li>
        <li>
          <a href="#">
            <img class="thumbnail" src="http://placehold.it/210x150" alt="">
          </a>
        </li>
        <li>
          <a href="#">
            <img class="thumbnail" src="http://placehold.it/210x150" alt="">
          </a>
        </li>
        <li>
          <a href="#">
            <img class="thumbnail" src="http://placehold.it/210x150" alt="">
          </a>
        </li>
      </ul>
      <h4>Small</h4>
      <ul class="media-grid">
        <li>
          <a href="#">
            <img class="thumbnail" src="http://placehold.it/90x90" alt="">
          </a>
        </li>
        <li>
          <a href="#">
            <img class="thumbnail" src="http://placehold.it/90x90" alt="">
          </a>
        </li>
        <li>
          <a href="#">
            <img class="thumbnail" src="http://placehold.it/90x90" alt="">
          </a>
        </li>
      </ul>
      <h4>Coding them</h4>
      <p>Media grids are easy to use and rather simple on the markup side. Their dimensions are purely based on the size of the images included.</p>
<pre class="prettyprint linenums">
&lt;ul class="media-grid"&gt;
  &lt;li&gt;
    &lt;a href="#"&gt;
      &lt;img class="thumbnail" src="http://placehold.it/330x230" alt=""&gt;
    &lt;/a&gt;
  &lt;/li&gt;
  &lt;li&gt;
    &lt;a href="#"&gt;
      &lt;img class="thumbnail" src="http://placehold.it/330x230" alt=""&gt;
    &lt;/a&gt;
  &lt;/li&gt;
&lt;/ul&gt;
</pre>
    </div>
  </div><!-- /row -->
</section>



Mark Otto's avatar
Mark Otto committed
1192
1193
<!-- Navigation
================================================== -->
1194
<section id="navigation">
Mark Otto's avatar
Mark Otto committed
1195
1196
1197
1198
  <div class="page-header">
    <h1>Navigation</h1>
  </div>
  <h2>Fixed topbar</h2>
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
  <div class="navbar navbar-static" data-dropdown="dropdown">
    <div class="navbar-inner">
      <div class="container">
        <a class="brand" href="#">Project Name</a>
        <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">Dropdown</a>
            <ul class="dropdown-menu">
              <li><a href="#">Secondary link</a></li>
              <li><a href="#">Something else here</a></li>
              <li class="divider"></li>
              <li><a href="#">Another link</a></li>
            </ul>
          </li>
        </ul>
        <form class="form-search navbar-search pull-left" action="">
Mark Otto's avatar
Mark Otto committed
1219
          <input type="text" class="search-query" placeholder="Search">
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
        </form>
        <ul class="nav secondary-nav">
          <li class="dropdown">
            <a href="#" class="dropdown-toggle">Dropdown</a>
            <ul class="dropdown-menu">
              <li><a href="#">Secondary link</a></li>
              <li><a href="#">Something else here</a></li>
              <li class="divider"></li>
              <li><a href="#">Another link</a></li>
            </ul>
          </li>
        </ul>
      </div>
    </div><!-- /topbar-inner -->
  </div><!-- /topbar -->
1235

Mark Otto's avatar
Mark Otto committed
1236
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1237
    <div class="span5">
1238
      <h4>What is it</h4>
1239
      <p>Our topbar is a fixed bar that houses a website’s logo or name, primary navigation, and search form.</p>
Mark Otto's avatar
Mark Otto committed
1240
    </div>
Mark Otto's avatar
Mark Otto committed
1241
    <div class="span5">
1242
1243
1244
      <h4>Customizable</h4>
      <p>All elements within, and the entire topbar as well, are optional. You can choose to include a logo/name, nav, search, and a secondary nav&mdash;or any combination of that.</p>
    </div>
Mark Otto's avatar
Mark Otto committed
1245
    <div class="span6">
1246
      <h4>Dropdowns included</h4>
1247
      <p>As part of the main navigation, we’ve included the ability for you to add dropdowns to your nav. Check out the secondary nav above (right aligned) to see how it’s done. Dropdowns <code>li</code> tags also support <code>.active</code> for showing current page selection.</p>
Mark Otto's avatar
Mark Otto committed
1248
1249
    </div>
  </div>
1250
  <p><strong>Note:</strong> When using the topbar on any page, be sure to account for the overlap it causes by adding <code>padding-top: 40px;</code> to your <code>body</code>.</p>
Mark Otto's avatar
Mark Otto committed
1251

1252
  <br>
1253

1254
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1255
    <div class="span4">
1256
1257
1258
1259
      <h2>Tabs and pills</h2>
      <p>Create simple secondary navigation with a <code>&lt;ul&gt;</code>. Swap between tabs or pills by adding the appropriate class.</p>
      <p>Great for sub-sections of content like our account settings pages and user timelines for toggling between pages of like content. Available in tabbed or pill styles.</p>
    </div>
Mark Otto's avatar
Mark Otto committed
1260
    <div class="span12">
1261
1262
      <h3>Basic tabs example</h3>
      <p>Tabs can be used as regular navigation (loading external pages in the same tab) or as tabbable content areas for swapping out panes of content. We have a <a href="./javascript.html#tabs">tabs plugin</a> that can be used to integrate the latter.</p>
1263
      <ul class="tabs">
Mark Otto's avatar
Mark Otto committed
1264
        <li class="active"><a href="#">Home</a></li>
1265
1266
1267
1268
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
        <li><a href="#">Settings</a></li>
        <li><a href="#">Contact</a></li>
1269
        <li class="dropdown" data-dropdown="dropdown">
1270
1271
1272
1273
1274
1275
1276
1277
          <a href="#" class="dropdown-toggle">Dropdown</a>
          <ul class="dropdown-menu">
            <li><a href="#">Secondary link</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Another link</a></li>
          </ul>
        </li>
1278
      </ul>
1279
<pre class="prettyprint linenums">
1280
&lt;ul class="tabs"&gt;
Mark Otto's avatar
Mark Otto committed
1281
1282
1283
1284
1285
  &lt;li class="active"&gt;&lt;a href="#"&gt;Home&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Profile&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Messages&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Settings&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Contact&lt;/a&gt;&lt;/li&gt;
1286
1287
&lt;/ul&gt;
</pre>
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
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
      <h3>Alternate tabs</h3>
      <p>You can also use tabs that are stacked on either side of an element, or on the bottom.</p>
      <div class="row">
        <div class="span3">
          <div class="clearfix">
            <ul class="tabs tabs-left">
              <li class="active"><a href="#">Active link</a></li>
              <li><a href="#">Link</a></li>
              <li><a href="#">Linky link</a></li>
              <li><a href="#">What up link</a></li>
            </ul>
          </div>
        </div>
        <div class="span3">
          <div class="clearfix">
            <ul class="tabs tabs-right">
              <li class="active"><a href="#">Active link</a></li>
              <li><a href="#">Link</a></li>
              <li><a href="#">Linky link</a></li>
              <li><a href="#">What up link</a></li>
            </ul>
          </div>
        </div>
        <div class="span6">
          <div class="clearfix">
            <ul class="tabs tabs-bottom">
              <li class="active"><a href="#">Active link</a></li>
              <li><a href="#">Link</a></li>
              <li><a href="#">Linky link</a></li>
            </ul>
          </div>
        </div>
      </div>
      <h3>Tabbable tabs</h3>
      <p>As mentioned above, you can bring your tabs to life with a simple plugin. Here we have integrated all four variations of the tabs&mdash;default (top), right, bottom, left&mdash;with example tab areas.</p>

      <div class="tabbable">
        <ul class="tabs" data-tabs="tabs">
          <li class="active"><a href="#1">Section 1</a></li>
          <li><a href="#2">Section 2</a></li>
          <li><a href="#3">Section 3</a></li>
          <li><a href="#4">Section 4</a></li>
        </ul>
        <div class="tab-content">
          <div class="tab-pane active" id="1">
            <p>Oh hai #1!</p>
          </div>
          <div class="tab-pane" id="2">
            <p>Oh hai #2!</p>
          </div>
          <div class="tab-pane" id="3">
            <p>Oh hai #3!</p>
          </div>
          <div class="tab-pane" id="4">
            <p>Oh hai #4!</p>
          </div>
        </div>
      </div>

       <div class="row">
        <div class="span6">
          <div class="tabbable tabs-left">
            <ul class="tabs" data-tabs="tabs">
              <li class="active"><a href="#1">Section 1</a></li>
              <li><a href="#2">Section 2</a></li>
              <li><a href="#3">Section 3</a></li>
            </ul>
            <div class="tab-content" id="myTabContent2">
              <div class="tab-pane active" id="1">
                <h4>Section 1</h4>
                <p>Oh hai!</p>
              </div>
              <div class="tab-pane" id="2">
                <h4>Section 2</h4>
                <p>Oh hai!</p>
              </div>
              <div class="tab-pane" id="3">
                <h4>Section 3</h4>
                <p>Oh hai!</p>
              </div>
            </div>
          </div>
        </div>
        <div class="span6">
          <div class="tabbable tabs-right">
            <ul class="tabs" data-tabs="tabs">
              <li class="active"><a href="#1">Section 1</a></li>
              <li><a href="#2">Section 2</a></li>
              <li><a href="#3">Section 3</a></li>
            </ul>
            <div class="tab-content" id="myTabContent3">
              <div class="tab-pane active" id="1">
                <h4>Section 1</h4>
                <p>Oh hai!</p>
              </div>
              <div class="tab-pane" id="2">
                <h4>Section 2</h4>
                <p>Oh hai!</p>
              </div>
              <div class="tab-pane" id="3">
                <h4>Section 3</h4>
                <p>Oh hai!</p>
              </div>
            </div>
          </div>
        </div>
      </div>

      <div class="tabbable tabs-bottom">
        <div class="tab-content">
          <div class="tab-pane active" id="1">
            <p>Oh hai #1!</p>
          </div>
          <div class="tab-pane" id="2">
            <p>Oh hai #2!</p>
          </div>
          <div class="tab-pane" id="3">
            <p>Oh hai #3!</p>
          </div>
          <div class="tab-pane" id="4">
            <p>Oh hai #4!</p>
          </div>
        </div>
        <ul class="tabs" data-tabs="tabs">
          <li class="active"><a href="#1">Section 1</a></li>
          <li><a href="#2">Section 2</a></li>
          <li><a href="#3">Section 3</a></li>
          <li><a href="#4">Section 4</a></li>
        </ul>
      </div>


      <p>In addition to tabs, we have pills! Though a bit more limited in functionality, they share much of the same markup.</p>
      <hr>
      <h3>Basic pills example</h3>
1423
1424
1425
1426
1427
1428
1429
      <ul class="pills">
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
        <li><a href="#">Settings</a></li>
        <li><a href="#">Contact</a></li>
      </ul>
1430
<pre class="prettyprint linenums">
1431
&lt;ul class="pills"&gt;
Mark Otto's avatar
Mark Otto committed
1432
1433
1434
1435
1436
  &lt;li class="active"&gt;&lt;a href="#"&gt;Home&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Profile&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Messages&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Settings&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Contact&lt;/a&gt;&lt;/li&gt;
1437
1438
&lt;/ul&gt;
</pre>
1439
1440
1441
1442
1443
1444
1445
1446
1447
      <h3>Vertical pill nav</h3>
      <p>With a pill-style nav, you can also stack the list items to have a simple sidebar. We don't offer left or right aligned versions here because that's easy enough to customize based on your own needs</p>
      <ul class="pills pills-vertical span4">
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
        <li><a href="#">Settings</a></li>
        <li><a href="#">Contact</a></li>
      </ul>
1448
    </div>
1449
  </div><!-- /row -->
1450

Mark Otto's avatar
Mark Otto committed
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
  <!-- Breadcrumbs -->
  <div class="row">
    <div class="span4">
      <h2>Breadcrumbs</h2>
      <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.</p>
    </div>
    <div class="span12">
      <ul class="breadcrumb">
        <li class="active">Home</li>
      </ul>
      <ul class="breadcrumb">
        <li><a href="#">Home</a> <span class="divider">/</span></li>
        <li class="active">Middle page</li>
      </ul>
      <ul class="breadcrumb">
        <li><a href="#">Home</a> <span class="divider">/</span></li>
        <li><a href="#">Middle page</a> <span class="divider">/</span></li>
        <li class="active">Another one</li>
      </ul>
      <ul class="breadcrumb">
        <li><a href="#">Home</a> <span class="divider">/</span></li>
        <li><a href="#">Middle page</a> <span class="divider">/</span></li>
        <li><a href="#">Another one</a> <span class="divider">/</span></li>
        <li class="active">You are here</li>
      </ul>
1476
1477
1478
1479
1480
1481
1482
1483
<pre class="prettyprint linenums">
&lt;ul class="breadcrumb"&gt;
  &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;Middle page&lt;/a&gt; &lt;span class="divider"&gt;/&lt;/span&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Another one&lt;/a&gt; &lt;span class="divider"&gt;/&lt;/span&gt;&lt;/li&gt;
  &lt;li class="active"&gt;You are here&lt;/li&gt;
&lt;/ul&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
1484
1485
1486
    </div>
  </div>

1487
1488
  <!-- Pagination -->
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1489
    <div class="span4">
1490
1491
      <h2>Pagination</h2>
      <p>Ultra simplistic and minimally styled pagination inspired by Rdio. The large block is hard to miss, easily scalable, and provides large click areas.</p>
1492
    </div>
Mark Otto's avatar
Mark Otto committed
1493
    <div class="span12">
1494
1495
1496
1497
1498
1499
1500
1501
      <div class="pagination">
        <ul>
          <li class="prev disabled"><a href="#">&larr; Previous</a></li>
          <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>
1502
          <li class="next"><a href="#">Next &raquo;</a></li>
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
        </ul>
      </div>
      <div class="pagination">
        <ul>
          <li class="prev"><a href="#">&larr; Previous</a></li>
          <li class="active"><a href="#">10</a></li>
          <li><a href="#">11</a></li>
          <li><a href="#">12</a></li>
          <li class="disabled"><a href="#"></a></li>
          <li><a href="#">19</a></li>
          <li><a href="#">20</a></li>
          <li><a href="#">21</a></li>
1515
          <li class="next"><a href="#">Next &raquo;</a></li>
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
        </ul>
      </div>
      <div class="pagination">
        <ul>
          <li class="prev"><a href="#">&larr; Previous</a></li>
          <li><a href="#">10</a></li>
          <li><a href="#">11</a></li>
          <li><a href="#">12</a></li>
          <li><a href="#">13</a></li>
          <li><a href="#">14</a></li>
          <li class="active"><a href="#">15</a></li>
          <li><a href="#">16</a></li>
          <li><a href="#">17</a></li>
          <li><a href="#">18</a></li>
          <li><a href="#">19</a></li>
          <li><a href="#">20</a></li>
1532
          <li class="next"><a href="#">Next &raquo;</a></li>
1533
1534
        </ul>
      </div>
1535
<pre class="prettyprint linenums">
1536
1537
&lt;div class="pagination"&gt;
  &lt;ul&gt;
Mark Otto's avatar
Mark Otto committed
1538
1539
1540
1541
1542
1543
1544
    &lt;li class="prev disabled"&gt;&lt;a href="#"&gt;&amp;larr; Previous&lt;/a&gt;&lt;/li>
    &lt;li class="active"&gt;&lt;a href="#"&gt;1&lt;/a&gt;&lt;/li&gt;
    &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;
    &lt;li&gt;&lt;a href="#"&gt;5&lt;/a&gt;&lt;/li&gt;
    &lt;li class="next"&gt;&lt;a href="#"&gt;Next &amp;rarr;&lt;/a&gt;&lt;/li>
1545
1546
1547
  &lt;/ul&gt;
&lt;/div&gt;
</pre>
1548
    </div>
1549
  </div><!-- /row -->
1550
1551
1552
1553
1554

</section>



Mark Otto's avatar
Mark Otto committed
1555
1556
<!-- Alerts & Messages
================================================== -->
1557
1558
<section id="alerts">
  <div class="page-header">
1559
1560
    <h1>Alerts &amp; Errors <small>Styles for success, warning, and error messages or alerts</small></h1>
  </div>
1561
  <!-- Basic alert messages -->
1562
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1563
    <div class="span4">
1564
      <h2>Basic alerts</h2>
1565
      <p><code>.alert-message</code></p>
1566
      <p>One-line messages for highlighting the failure, possible failure, or success of an action. Particularly useful for forms.</p>
1567
      <p><a class="btn js-btn" href="./javascript.html#alerts">Get the javascript &raquo;</a></p>
1568
    </div>
Mark Otto's avatar
Mark Otto committed
1569
    <div class="span12">
1570
1571
      <div class="alert-message warning">
        <a class="close" href="#">&times;</a>
1572
        <p><strong>Holy guacamole!</strong> Best check yo self, you’re not looking too good.</p>
1573
      </div>
1574
      <div class="alert-message error">
1575
        <a class="close" href="#">&times;</a>
1576
        <p><strong>Oh snap!</strong> Change this and that and try again.</p>
1577
1578
1579
1580
1581
1582
1583
      </div>
      <div class="alert-message success">
        <a class="close" href="#">&times;</a>
        <p><strong>Well done!</strong> You successfully read this alert message.</p>
      </div>
      <div class="alert-message info">
        <a class="close" href="#">&times;</a>
1584
        <p><strong>Heads up!</strong> This is an alert that needs your attention, but it’s not a huge priority just yet.</p>
1585
      </div>
1586
1587
1588
1589
1590
1591
1592
1593

      <h4>Example code</h4>
<pre class="prettyprint linenums">
&lt;div class="alert-message warning"&gt;
  &lt;a class="close" href="#"&gt;&times;&lt;/a&gt;
  &lt;p&gt;&lt;strong&gt;Holy guacamole!&lt;/strong&gt; Best check yo self, you’re not looking too good.&lt;/p&gt;
&lt;/div&gt;
</pre>
1594
    </div>
1595
  </div><!-- /row -->
1596
  <!-- Block messages -->
1597
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1598
    <div class="span4">
1599
      <h2>Block messages</h2>
1600
      <p><code>.alert-message.block-message</code></p>
1601
      <p>For messages that require a bit of explanation, we have paragraph style alerts. These are perfect for bubbling up longer error messages, warning a user of a pending action, or just presenting information for more emphasis on the page.</p>
1602
      <p><a class="btn js-btn" href="./javascript.html#alerts">Get the javascript &raquo;</a></p>
1603
    </div>
Mark Otto's avatar
Mark Otto committed
1604
    <div class="span12">
1605
1606
      <div class="alert-message block-message warning">
        <a class="close" href="#">&times;</a>
1607
        <p><strong>Holy guacamole! This is a warning!</strong> 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>
1608
1609
1610
        <div class="alert-actions">
          <a class="btn small" href="#">Take this action</a> <a class="btn small" href="#">Or do this</a>
        </div>
1611
      </div>
1612
      <div class="alert-message block-message error">
1613
        <a class="close" href="#">&times;</a>
1614
1615
1616
1617
1618
1619
        <p><strong>Oh snap! You got an error!</strong> Change this and that and try again.</p>
        <ul>
          <li>Duis mollis est non commodo luctus</li>
          <li>Nisi erat porttitor ligula</li>
          <li>Eget lacinia odio sem nec elit</li>
        </ul>
1620
1621
1622
        <div class="alert-actions">
          <a class="btn small" href="#">Take this action</a> <a class="btn small" href="#">Or do this</a>
        </div>
1623
1624
1625
1626
      </div>
      <div class="alert-message block-message success">
        <a class="close" href="#">&times;</a>
        <p><strong>Well done!</strong> You successfully read this alert message. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Maecenas faucibus mollis interdum.</p>
1627
1628
1629
        <div class="alert-actions">
          <a class="btn small" href="#">Take this action</a> <a class="btn small" href="#">Or do this</a>
        </div>
1630
1631
1632
      </div>
      <div class="alert-message block-message info">
        <a class="close" href="#">&times;</a>
1633
        <p><strong>Heads up!</strong> This is an alert that needs your attention, but it’s not a huge priority just yet.</p>
1634
1635
1636
        <div class="alert-actions">
          <a class="btn small" href="#">Take this action</a> <a class="btn small" href="#">Or do this</a>
        </div>
1637
      </div>
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648

      <h4>Example code</h4>
<pre class="prettyprint linenums">
&lt;div class="alert-message block-message warning"&gt;
  &lt;a class="close" href="#"&gt;&times;&lt;/a&gt;
  &lt;p&gt;&lt;strong&gt;Holy guacamole! This is a warning!&lt;/strong&gt; 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.&lt;/p&gt;
  &lt;div class="alert-actions"&gt;
    &lt;a class="btn small" href="#"&gt;Take this action&lt;/a&gt; &lt;a class="btn small" href="#"&gt;Or do this&lt;/a>
  &lt;/div&gt;
&lt;/div&gt;
</pre>
1649
    </div>
1650
  </div><!-- /row -->
1651
1652
1653
</section>


Mark Otto's avatar
Mark Otto committed
1654
1655
<!-- Popovers
================================================== -->
Mark Otto's avatar
Mark Otto committed
1656
<section id="popovers">
Jacob Thornton's avatar
Jacob Thornton committed
1657
  <div class="page-header">
Mark Otto's avatar
Mark Otto committed
1658
    <h1>Popovers <small>Components for displaying content in modals, tooltips, and popovers</small></h1>
Jacob Thornton's avatar
Jacob Thornton committed
1659
1660
  </div>
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1661
    <div class="span4">
Mark Otto's avatar
Mark Otto committed
1662
      <h2>Modals</h2>
1663
      <p>Modals&mdash;dialogs or lightboxes&mdash;are great for contextual actions in situations where it’s important that the background context be maintained.</p>
1664
      <p><a class="btn js-btn" href="./javascript.html#modal">Get the javascript &raquo;</a></p>
Jacob Thornton's avatar
Jacob Thornton committed
1665
    </div>
Mark Otto's avatar
Mark Otto committed
1666
    <div class="span12">
Jacob Thornton's avatar
Jacob Thornton committed
1667
      <div class="well" style="background-color: #888; border: none; padding: 40px;">
1668
        <!-- Modal -->
1669
        <div class="modal" style="position: relative; top: auto; left: auto; margin: 0 auto; z-index: 1">
Jacob Thornton's avatar
Jacob Thornton committed
1670
          <div class="modal-header">
1671
            <a href="#" class="close js-dismiss">&times;</a>
1672
            <h3>Modal Heading</h3>
Jacob Thornton's avatar
Jacob Thornton committed
1673
1674
          </div>
          <div class="modal-body">
1675
            <p>One fine body…</p>
Jacob Thornton's avatar
Jacob Thornton committed
1676
1677
          </div>
          <div class="modal-footer">
Mark Otto's avatar
Mark Otto committed
1678
            <a href="#" class="btn primary">Primary</a>
1679
            <a href="#" class="btn">Secondary</a>
Jacob Thornton's avatar
Jacob Thornton committed
1680
1681
1682
          </div>
        </div>
      </div>
1683
    </div>
1684
  </div><!-- /row -->
1685

1686
  <!-- Tooltips -->
1687
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1688
    <div class="span4">
Jacob Thornton's avatar
Jacob Thornton committed
1689
      <h2>Tooltips</h2>
1690
      <p>Twipsies are super useful for aiding a confused user and pointing them in the right direction.</p>
1691
      <p><a class="btn js-btn" href="./javascript.html#twipsy">Get the javascript &raquo;</a></p>
1692
    </div>
Mark Otto's avatar
Mark Otto committed
1693
    <div class="span12">
1694
1695
1696
      <div class="twipsies well">
        <div style="position: relative">
          <p class="muted" style="margin-bottom: 0">
Jacob Thornton's avatar
Jacob Thornton committed
1697
Lorem ipsum dolar sit amet illo error <a href="#" title="below">ipsum</a> veritatis aut iste perspiciatis iste voluptas natus illo quasi odit aut natus consequuntur consequuntur, aut natus illo voluptatem odit perspiciatis laudantium rem doloremque totam voluptas. <a href="#" title="right">Voluptasdicta</a> eaque beatae aperiam ut enim voluptatem explicabo explicabo, voluptas quia odit fugit accusantium totam totam architecto explicabo sit quasi fugit fugit, totam doloremque unde sunt <a href="#" title="left">sed</a> dicta quae accusantium fugit voluptas nemo voluptas voluptatem <a href="#" title="above">rem</a> quae aut veritatis quasi quae.
1698
          </p>
Jacob Thornton's avatar
Jacob Thornton committed
1699
1700
1701
        </div>
      </div>
    </div>
1702
  </div><!-- /row -->
Jacob Thornton's avatar
Jacob Thornton committed
1703

1704
  <!-- Popovers -->
Mark Otto's avatar
Mark Otto committed
1705
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1706
    <div class="span4">
Mark Otto's avatar
Mark Otto committed
1707
      <h2>Popovers</h2>
Mark Otto's avatar
Mark Otto committed
1708
      <p>Use popovers to provide subtextual information to a page without affecting layout.</p>
1709
      <p><a class="btn js-btn" href="./javascript.html#popover">Get the javascript &raquo;</a></p>
Mark Otto's avatar
Mark Otto committed
1710
    </div>
Mark Otto's avatar
Mark Otto committed
1711
    <div class="span12">
Mark Otto's avatar
Mark Otto committed
1712
      <div class="well popover-well">
Jacob Thornton's avatar
Jacob Thornton committed
1713
1714
         <div class="popover-wrapper">
          <div class="popover left">
Mark Otto's avatar
Mark Otto committed
1715
1716
            <div class="arrow"></div>
            <div class="inner">
Jacob Thornton's avatar
Jacob Thornton committed
1717
              <h3 class="title">Popover Title</h3>
Mark Otto's avatar
Mark Otto committed
1718
1719
1720
1721
1722
              <div class="content">
                <p>Etiam porta sem malesuada magna mollis euismod. Maecenas faucibus mollis interdum. Morbi leo risus, porta ac consectetur ac, vestibulum at eros.</p>
              </div>
            </div>
          </div>
Jacob Thornton's avatar
Jacob Thornton committed
1723
          <img class="large-bird" src="assets/img/bird.png" >
Mark Otto's avatar
Mark Otto committed
1724
1725
1726
        </div>
      </div>
    </div>
1727
  </div><!-- /row -->
Jacob Thornton's avatar
Jacob Thornton committed
1728
</section>
1729

Mark Otto's avatar
Mark Otto committed
1730

1731
1732
1733
1734
1735
<!-- Using Javascript w/ Bootstrap
 ================================================== -->

 <section id="javascript">
   <div class="page-header">
1736
     <h1>Using javascript with Bootstrap <small>An index of plugins to get you started</small></h1>
1737
1738
   </div>
   <div class="row">
Mark Otto's avatar
Mark Otto committed
1739
     <div class="span4">
1740
       <h2>Getting started</h2>
1741
       <p>Integrating javascript with the Bootstrap library is super easy. Below we go over the basics and provide you with some awesome plugins to get you started!</p>
1742
       <p><a class="btn primary" href="./javascript.html">View javascript docs &raquo;</a></p>
1743
     </div>
Mark Otto's avatar
Mark Otto committed
1744
     <div class="span12">
1745
1746
      <h3>What's included</h3>
       <p>Bring some of Bootstrap's primary components to life with new custom plugins that work with <a href="http://jquery.com/" target="_blank">jQuery</a> and <a href="http://ender.no.de" target="_blank">Ender</a>. We encourage you to extend and modify them to fit your specific development needs.</p>
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
       <table class="zebra-striped">
         <thead>
           <tr>
             <th style="width: 150px;">File</th>
             <th>Description</th>
           </tr>
         </thead>
         <tbody>
           <tr>
             <td><a href="./javascript.html#modal">bootstrap-modal.js</a></td>
             <td>Our Modal plugin is a <strong>super</strong> slim take on the traditional modal js plugin! We took special care to include only the bare functionality that we require at twitter.</td>
           </tr>
           <tr>
             <td><a href="./javascript.html#alerts">bootstrap-alerts.js</a></td>
             <td>The alert plugin is a super tiny class for adding close functionality to alerts.</td>
           </tr>
           <tr>
             <td><a href="./javascript.html#dropdowns">bootstrap-dropdown.js</a></td>
Jacob Thornton's avatar
Jacob Thornton committed
1765
             <td>This plugin is for adding dropdown interaction to the bootstrap topbar or tabbed navigations.</td>
1766
           </tr>
1767
1768
1769
1770
           <tr>
             <td><a href="./javascript.html#scrollspy">bootstrap-scrollspy.js</a></td>
             <td>The ScrollSpy plugin is for adding an auto updating nav based on scroll position to the bootstrap topbar.</td>
           </tr>
1771
1772
           <tr>
             <td><a href="./javascript.html#tabs">bootstrap-tabs.js</a></td>
1773
             <td>This plugin adds quick, dynamic tab and pill functionality for cycling through local content.</td>
1774
           </tr>
1775
1776
           <tr>
             <td><a href="./javascript.html#twipsy">bootstrap-twipsy.js</a></td>
1777
             <td>Based on the excellent jQuery.tipsy plugin written by Jason Frame; twipsy is an updated version, which doesn't rely on images, uses css3 for animations, and data-attributes for local title storage!</td>
1778
1779
1780
1781
1782
1783
1784
           </tr>
           <tr>
             <td><a href="./javascript.html#popover">bootstrap-popover.js</a></td>
             <td>The popover plugin provides a simple interface for adding popovers to your application. It extends the <a href="#twipsy">boostrap-twipsy.js</a> plugin, so be sure to grab that file as well when including popovers in your project!</td>
           </tr>
         </tbody>
       </table>
1785
1786
1787
1788
       <h3>Is javascript necessary?</h3>
       <p><strong>Nope!</strong> Bootstrap is designed first and foremost to be a CSS library. This javascript provides a basic interactive layer on top of the included styles.</p>
       <p>However, for those who do need javascript, we've provided the plugins above to help you understand how to integrate Bootstrap with javascript and to give you a quick, lightweight option for the basic functionality right away.</p>
       <p>For more information and to see some live demos, please refer to our <a href="./javascript.html">plugin documentation page</a>.</p>
1789
1790
1791
     </div>
   </div>

Mark Otto's avatar
Mark Otto committed
1792

Mark Otto's avatar
Mark Otto committed
1793
1794
<!-- Using Bootstrap w/ Less
================================================== -->
1795
<section id="less">
Mark Otto's avatar
Mark Otto committed
1796
<div class="page-header">
1797
  <h1>Using Bootstrap with Less <small>Supercharge your CSS with variables, mixins, and functions</small></h1>
Mark Otto's avatar
Mark Otto committed
1798
1799
</div>
<div class="row">
Mark Otto's avatar
Mark Otto committed
1800
  <div class="span4">
1801
1802
    <p>Bootstrap was built with <a href="http://markdotto.com/bootstrap/">Preboot</a>, an open-source pack of mixins and variables to be used in conjunction with <a href="http://lesscss.org" target="_blank">Less</a>, a CSS preprocessor for faster and easier web development.</p>
    <p>Check out how we used Preboot in Bootstrap and how you can make use of it should you choose to run Less on your next project.</p>
Mark Otto's avatar
Mark Otto committed
1803
  </div>
Mark Otto's avatar
Mark Otto committed
1804
  <div class="span12">
Mark Otto's avatar
Mark Otto committed
1805
    <h2>How to use it</h2>
1806
    <p>Use this option to make full use of Bootstrap’s Less variables, mixins, and nesting in CSS via javascript in your browser.</p>
1807
<pre class="prettyprint linenums">
Jacob Thornton's avatar
Jacob Thornton committed
1808
&lt;link rel="stylesheet/less" href="less/bootstrap.less" media="all" /&gt;
Mark Otto's avatar
Mark Otto committed
1809
&lt;script src="js/less-1.1.3.min.js"&gt;&lt;/script&gt;</pre>
1810
<p>Not feeling the .js solution? <a href="http://incident57.com/less" target="_blank">Try the Less Mac app</a> or <a href="http://lesscss.org/#-client-side-usage" target="_blank">use Node.js</a> to compile when you deploy your code.</p>
Mark Otto's avatar
Mark Otto committed
1811

1812
1813
    <h2>What’s included</h2>
    <p>Here are some of the highlights of what’s included in Twitter Bootstrap as part of Bootstrap. Head over to the Bootstrap website or Github project page to download and learn more.</p>
1814
    <h3>Variables</h3>
1815
    <p>Variables in Less are perfect for maintaining and updating your CSS headache free. When you want to change a color value or a frequently used value, update it in one spot and you’re set.</p>
1816
<pre class="prettyprint linenums">
Mark Otto's avatar
Mark Otto committed
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
// Links
@linkColor:         #8b59c2;
@linkColorHover:    darken(@linkColor, 10);

// Grays
@black:             #000;
@grayDark:          lighten(@black, 25%);
@gray:              lighten(@black, 50%);
@grayLight:         lighten(@black, 70%);
@grayLighter:       lighten(@black, 90%);
@white:             #fff;

// Accent Colors
@blue:              #08b5fb;
@green:             #46a546;
@red:               #9d261d;
@yellow:            #ffc40d;
@orange:            #f89406;
@pink:              #c3325f;
@purple:            #7a43b6;

1838
1839
1840
// Baseline grid
@basefont:          13px;
@baseline:          18px;
Mark Otto's avatar
Mark Otto committed
1841
1842
1843
</pre>

<h3>Commenting</h3>
1844
<p>Less also provides another style of commenting in addition to CSS’s normal <code>/* ... */</code> syntax.</p>
1845
<pre class="prettyprint linenums">
Mark Otto's avatar
Mark Otto committed
1846
1847
1848
1849
1850
// This is a comment
/* This is also a comment */
</pre>

<h3>Mixins up the wazoo</h3>
1851
<p>Mixins are basically includes or partials for CSS, allowing you to combine a block of code into one. They’re great for vendor prefixed properties like <code>box-shadow</code>, cross-browser gradients, font stacks, and more. Below is a sample of the mixins that are included with Bootstrap.</p>
Mark Otto's avatar
Mark Otto committed
1852
<h4>Font stacks</h4>
1853
<pre class="prettyprint linenums">
Mark Otto's avatar
Mark Otto committed
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
#font {
  .shorthand(@weight: normal, @size: 14px, @lineHeight: 20px) {
    font-size: @size;
    font-weight: @weight;
    line-height: @lineHeight;
  }
  .sans-serif(@weight: normal, @size: 14px, @lineHeight: 20px) {
    font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
    font-size: @size;
    font-weight: @weight;
    line-height: @lineHeight;
  }
1866
  ...
Mark Otto's avatar
Mark Otto committed
1867
1868
1869
}
</pre>
<h4>Gradients</h4>
1870
<pre class="prettyprint linenums">
Mark Otto's avatar
Mark Otto committed
1871
#gradient {
1872
  ...
Mark Otto's avatar
Mark Otto committed
1873
1874
1875
  .vertical (@startColor: #555, @endColor: #333) {
    background-color: @endColor;
    background-repeat: repeat-x;
1876
1877
1878
1879
1880
1881
1882
    background-image: -khtml-gradient(linear, left top, left bottom, from(@startColor), to(@endColor)); // Konqueror
    background-image: -moz-linear-gradient(@startColor, @endColor); // FF 3.6+
    background-image: -ms-linear-gradient(@startColor, @endColor); // IE10
    background-image: -webkit-gradient(linear, left top, left bottom, color-stop(0%, @startColor), color-stop(100%, @endColor)); // Safari 4+, Chrome 2+
    background-image: -webkit-linear-gradient(@startColor, @endColor); // Safari 5.1+, Chrome 10+
    background-image: -o-linear-gradient(@startColor, @endColor); // Opera 11.10
    background-image: linear-gradient(@startColor, @endColor); // The standard
Mark Otto's avatar
Mark Otto committed
1883
  }
1884
  ...
Mark Otto's avatar
Mark Otto committed
1885
1886
1887
}
</pre>

1888
<h3>Operations</h3>
1889
<p>Get fancy and perform some math to generate flexible and powerful mixins like the one below.</p>
1890
<pre class="prettyprint linenums">
Mark Otto's avatar
Mark Otto committed
1891
1892
1893
1894
// Griditude
@gridColumns:       16;
@gridColumnWidth:   40px;
@gridGutterWidth:   20px;
1895
@siteWidth:         (@gridColumns * @gridColumnWidth) + (@gridGutterWidth * (@gridColumns - 1));
Mark Otto's avatar
Mark Otto committed
1896

1897
// Make some columns
Mark Otto's avatar
Mark Otto committed
1898
1899
1900
1901
.columns(@columnSpan: 1) {
  width: (@gridColumnWidth * @columnSpan) + (@gridGutterWidth * (@columnSpan - 1));
}
</pre>
1902
1903
1904
1905

    <h2>Compiling Less</h2>
    <p>After modifying the <code>.less</code> files in /lib/, you'll need to recompile them in order to regenerate the bootstrap-*.*.*.css and bootstrap-*.*.*.min.css files. If you're submitting a pull request to GitHub, you must always recompile.</p>
    <h3>Ways to compile</h3>
Mark Otto's avatar
Mark Otto committed
1906
    <table class="zebra-striped">
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
      <thead>
        <tr>
          <th style="width: 120px;">Method</th>
          <th>Steps</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td>Node with makefile</td>
          <td>
1917
1918
1919
1920
            <p>Install the less command line compiler with npm by running the following command:</p>
            <pre>$ npm install lessc</pre>
            <p>Once installed just run <code>make</code> from the root of your bootstrap directory and you're all set.</p>
            <p>Additionally, if you have <a href="https://github.com/mynyml/watchr">watchr</a> installed, you may run <code>make watch</code> to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).</p>
1921
1922
1923
1924
          </td>
        </tr>
          <td>Javascript</td>
          <td>
1925
            <p><a href="http://lesscss.org/">Download the latest Less.js</a> and include the path to it (and Bootstrap) in the <code>head</code>.</p>
1926
<pre class="prettyprint linenums">
1927
1928
1929
1930
1931
1932
1933
1934
1935
&lt;link rel="stylesheet/less" href="/path/to/bootstrap.less"&gt;
&lt;script src="/path/to/less.js"&gt;&lt;/script&gt;
</pre>
            <p>To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.</p>
          </td>
        </tr>
        <tr>
          <td>Command line</td>
          <td>
1936
            <p>If you already have the less command line tool installed, simply run the following command:</p>
1937
              <pre>$ lessc ./lib/bootstrap.less > bootstrap.css</pre>
1938
            <p>Be sure to include <code>--compress</code> in that command if you're trying to save some bytes!</p>
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
          </td>
        </tr>
        <tr>
          <td>Less Mac app</td>
          <td>
            <p><a href="http://incident57.com/less/">The unofficial Mac app</a> watches directories of .less files and compiles the code to local files after every save of a watched .less file.</p>
            <p>If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.</p>
          </td>
        </tr>
      </tbody>
    </table>
Mark Otto's avatar
Mark Otto committed
1950
1951
1952
1953
1954
  </div>
</div>

</section>

1955

1956
    <footer class="footer">
1957
1958
1959
1960
1961
      <p class="pull-right"><a href="#">Back to top</a></p>
      <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>.<br>
        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>
1962
    </footer>
1963

1964
1965
1966
    </div><!-- /container -->


1967
  </body>
1968
</html>