css.mustache 98.4 KB
Newer Older
1
<!-- Subhead
2
================================================== -->
3
<header class="bs-docs-jumbotron subhead">
4
  <div class="container">
5
6
    <h1>CSS</h1>
    <p class="lead">Fundamental HTML elements styled and enhanced with extensible classes.</p>
7
  </div>
8
</header>
9
10


11
  <div class="container">
12

13
14
15
16
    <!-- Docs nav
    ================================================== -->
    <div class="row">
      <div class="span3 bs-docs-sidebar">
17
        <ul class="nav nav-list bs-docs-sidenav">
18
19
20
21
22
23
24
25
26
27
          <li><a href="#global"><i class="glyphicon-chevron-right"></i> Global styles</a></li>
          <li><a href="#gridSystem"><i class="glyphicon-chevron-right"></i> Grid system</a></li>
          <li><a href="#typography"><i class="glyphicon-chevron-right"></i> Typography</a></li>
          <li><a href="#code"><i class="glyphicon-chevron-right"></i> Code</a></li>
          <li><a href="#tables"><i class="glyphicon-chevron-right"></i> Tables</a></li>
          <li><a href="#forms"><i class="glyphicon-chevron-right"></i> Forms</a></li>
          <li><a href="#buttons"><i class="glyphicon-chevron-right"></i> Buttons</a></li>
          <li><a href="#images"><i class="glyphicon-chevron-right"></i> Images</a></li>
          <li><a href="#icons"><i class="glyphicon-chevron-right"></i> Icons by Glyphicons</a></li>
          <li><a href="#responsive"><i class="glyphicon-chevron-right"></i> Responsive design</a></li>
28
29
30
        </ul>
      </div>
      <div class="span9">
31

Mark Otto's avatar
Mark Otto committed
32
33


Mark Otto's avatar
Mark Otto committed
34
35
36
37
        <!-- Global Bootstrap settings
        ================================================== -->
        <section id="global">
          <div class="page-header">
38
            <h1>Global settings</h1>
Mark Otto's avatar
Mark Otto committed
39
40
          </div>

41
42
          <h3>Requires HTML5 doctype</h3>
          <p>Bootstrap makes use of certain HTML elements and CSS properties that require the use of the HTML5 doctype. Include it at the beginning of all your projects.</p>
Mark Otto's avatar
Mark Otto committed
43
44
45
46
47
48
49
<pre class="prettyprint linenums">
&lt;!DOCTYPE html&gt;
&lt;html lang="en"&gt;
  ...
&lt;/html&gt;
</pre>

50
51
          <h3>Typography and links</h3>
          <p>Bootstrap sets basic global display, typography, and link styles. Specifically, we:</p>
Mark Otto's avatar
Mark Otto committed
52
          <ul>
53
54
55
56
            <li>Remove <code>margin</code> on the body</li>
            <li>Set <code>background-color: white;</code> on the <code>body</code></li>
            <li>Use the <code>@font-family-base</code>, <code>@font-size-base</code>, and <code>@line-height-base</code> attributes as our typographic base</li>
            <li>Set the global link color via <code>@link-color</code> and apply link underlines only on <code>:hover</code></li>
Mark Otto's avatar
Mark Otto committed
57
          </ul>
58
          <p>These styles can be found within <strong>scaffolding.less</strong>.</p>
Mark Otto's avatar
Mark Otto committed
59

60
61
          <h3>Reset via Normalize</h3>
          <p>With Bootstrap 2, the old reset block has been dropped in favor of <a href="http://necolas.github.com/normalize.css/" target="_blank">Normalize.css</a>, a project by <a href="http://twitter.com/necolas" target="_blank">Nicolas Gallagher</a> and <a href="http://twitter.com/jon_neal" target="_blank">Jonathan Neal</a> that also powers the <a href="http://html5boilerplate.com" target="_blank">HTML5 Boilerplate</a>. While we use much of Normalize within our <strong>reset.less</strong>, we have removed some elements specifically for Bootstrap.</p>
Mark Otto's avatar
Mark Otto committed
62
63
64
65
66
67
68
69
70

        </section>



        <!-- Grid system
        ================================================== -->
        <section id="gridSystem">
          <div class="page-header">
71
            <h1>Grid system</h1>
Mark Otto's avatar
Mark Otto committed
72
73
          </div>

74
75
          <h2>Live grid example</h2>
          <p>The default Bootstrap grid system utilizes <strong>12 columns</strong>, making for a 940px wide container without <a href="./scaffolding.html#responsive">responsive features</a> enabled. With the responsive CSS file added, the grid adapts to be 724px and 1170px wide depending on your viewport. Below 767px viewports, the columns become fluid and stack vertically.</p>
Mark Otto's avatar
Mark Otto committed
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
          <div class="bs-docs-grid">
            <div class="row show-grid">
              <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>
            </div>
            <div class="row show-grid">
              <div class="span4">4</div>
              <div class="span4">4</div>
              <div class="span4">4</div>
            </div>
            <div class="row show-grid">
              <div class="span6">6</div>
              <div class="span6">6</div>
            </div>
            <div class="row show-grid">
              <div class="span12">12</div>
            </div>
          </div>

105
106
          <h3>Basic grid HTML</h3>
          <p>For a simple two column layout, create a <code>.row</code> and add the appropriate number of <code>.span*</code> columns. As this is a 12-column grid, each <code>.span*</code> spans a number of those 12 columns, and should always add up to 12 for each row (or the number of columns in the parent).</p>
Mark Otto's avatar
Mark Otto committed
107
108
109
110
111
112
<pre class="prettyprint linenums">
&lt;div class="row"&gt;
  &lt;div class="span4"&gt;...&lt;/div&gt;
  &lt;div class="span8"&gt;...&lt;/div&gt;
&lt;/div&gt;
</pre>
113
          <p>Given this example, we have <code>.span4</code> and <code>.span8</code>, making for 12 total columns and a complete row.</p>
Mark Otto's avatar
Mark Otto committed
114

115
116
          <h2>Offsetting columns</h2>
          <p>Move columns to the right using <code>.offset*</code> classes. Each class increases the left margin of a column by a whole column. For example, <code>.offset4</code> moves <code>.span4</code> over four columns.</p>
Mark Otto's avatar
Mark Otto committed
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
          <div class="bs-docs-grid">
            <div class="row show-grid">
              <div class="span4">4</div>
              <div class="span4 offset4">4 offset 4</div>
            </div><!-- /row -->
            <div class="row show-grid">
              <div class="span3 offset3">3 offset 3</div>
              <div class="span3 offset3">3 offset 3</div>
            </div><!-- /row -->
            <div class="row show-grid">
              <div class="span6 offset6">6 offset 6</div>
            </div><!-- /row -->
          </div>
<pre class="prettyprint linenums">
&lt;div class="row"&gt;
  &lt;div class="span4"&gt;...&lt;/div&gt;
  &lt;div class="span4 offset4"&gt;...&lt;/div&gt;
&lt;/div&gt;
</pre>


138
139
          <h2>Nesting columns</h2>
          <p>To nest your content with the default grid, add a new <code>.row</code> and set of <code>.span*</code> columns within an existing <code>.span*</code> column. Nested rows should include a set of columns that add up to the number of columns of its parent.</p>
Mark Otto's avatar
Mark Otto committed
140
141
          <div class="row show-grid">
            <div class="span9">
Mark Otto's avatar
Mark Otto committed
142
              Level 1: 9 columns
Mark Otto's avatar
Mark Otto committed
143
144
              <div class="row show-grid">
                <div class="span6">
Mark Otto's avatar
Mark Otto committed
145
                  Level 2: 6 columns
Mark Otto's avatar
Mark Otto committed
146
147
                </div>
                <div class="span6">
Mark Otto's avatar
Mark Otto committed
148
                  Level 2: 6 columns
Mark Otto's avatar
Mark Otto committed
149
150
151
152
153
154
155
                </div>
              </div>
            </div>
          </div>
<pre class="prettyprint linenums">
&lt;div class="row"&gt;
  &lt;div class="span9"&gt;
Mark Otto's avatar
Mark Otto committed
156
    Level 1: 9 columns
Mark Otto's avatar
Mark Otto committed
157
    &lt;div class="row"&gt;
Mark Otto's avatar
Mark Otto committed
158
159
      &lt;div class="span6"&gt;Level 2: 6 columns&lt;/div&gt;
      &lt;div class="span3"&gt;Level 2: 6 columns&lt;/div&gt;
Mark Otto's avatar
Mark Otto committed
160
161
162
163
164
165
166
167
168
    &lt;/div&gt;
  &lt;/div&gt;
&lt;/div&gt;
</pre>
        </section>




169
170
171
172
        <!-- Typography
        ================================================== -->
        <section id="typography">
          <div class="page-header">
173
            <h1>Typography</h1>
174
          </div>
Mark Otto's avatar
Mark Otto committed
175

176
          {{! Headings }}
177
178
          <h2 id="headings">Headings</h2>
          <p>All HTML headings, <code>&lt;h1&gt;</code> through <code>&lt;h6&gt;</code> are available.</p>
179
          <div class="bs-docs-example">
180
181
182
183
184
185
            <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>
186
          </div>
187

188
          {{! Body copy }}
189
190
          <h2 id="body-copy">Body copy</h2>
          <p>Bootstrap's global default <code>font-size</code> is <strong>14px</strong>, with a <code>line-height</code> of <strong>20px</strong>. This is applied to the <code>&lt;body&gt;</code> and all paragraphs. In addition, <code>&lt;p&gt;</code> (paragraphs) receive a bottom margin of half their line-height (10px by default).</p>
191
192
193
194
195
196
          <div class="bs-docs-example">
            <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.</p>
            <p>Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec ullamcorper nulla non metus auctor fringilla. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Donec ullamcorper nulla non metus auctor fringilla.</p>
            <p>Maecenas sed diam eget risus varius blandit sit amet non magna. Donec id elit non mi porta gravida at eget metus. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit.</p>
          </div>
          <pre class="prettyprint">&lt;p&gt;...&lt;/p&gt;</pre>
Mark Otto's avatar
Mark Otto committed
197

198
          {{! Body copy .lead }}
199
200
          <h3>Lead body copy</h3>
          <p>Make a paragraph stand out by adding <code>.lead</code>.</p>
201
202
203
204
          <div class="bs-docs-example">
            <p class="lead">Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus.</p>
          </div>
          <pre class="prettyprint">&lt;p class="lead"&gt;...&lt;/p&gt;</pre>
Mark Otto's avatar
Mark Otto committed
205

206
          {{! Using LESS }}
207
208
          <h3>Built with Less</h3>
          <p>The typographic scale is based on two LESS variables in <strong>variables.less</strong>: <code>@font-size-base</code> and <code>@line-height-base</code>. The first is the base font-size used throughout and the second is the base line-height. We use those variables and some simple math to create the margins, paddings, and line-heights of all our type and more. Customize them and Bootstrap adapts.</p>
Mark Otto's avatar
Mark Otto committed
209
210


211
          <hr class="bs-docs-separator">
Mark Otto's avatar
Mark Otto committed
212
213


214
          {{! Emphasis }}
215
216
          <h2 id="emphasis">Emphasis</h2>
          <p>Make use of HTML's default emphasis tags with lightweight styles.</p>
217
218

          <h3><code>&lt;small&gt;</code></h3>
219
          <p>For de-emphasizing inline or blocks of text, <small>use the small tag.</small></p>
220
221
222
223
224
225
226
227
          <div class="bs-docs-example">
            <p><small>This line of text is meant to be treated as fine print.</small></p>
          </div>
<pre class="prettyprint">
&lt;p&gt;
  &lt;small&gt;This line of text is meant to be treated as fine print.&lt;/small&gt;
&lt;/p&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
228

229
230
          <h3>Bold</h3>
          <p>For emphasizing a snippet of text with a heavier font-weight.</p>
231
232
233
234
          <div class="bs-docs-example">
            <p>The following snippet of text is <strong>rendered as bold text</strong>.</p>
          </div>
          <pre class="prettyprint">&lt;strong&gt;rendered as bold text&lt;/strong&gt;</pre>
Mark Otto's avatar
Mark Otto committed
235

236
237
          <h3>Italics</h3>
          <p>For emphasizing a snippet of text with italics.</p>
238
239
240
241
          <div class="bs-docs-example">
            <p>The following snippet of text is <em>rendered as italicized text</em>.</p>
          </div>
          <pre class="prettyprint">&lt;em&gt;rendered as italicized text&lt;/em&gt;</pre>
Mark Otto's avatar
Mark Otto committed
242

Mark Otto's avatar
Mark Otto committed
243
          <p>Feel free to use <code>&lt;b&gt;</code> and <code>&lt;i&gt;</code> in HTML5. <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>
244

245
246
          <h3>Emphasis classes</h3>
          <p>Convey meaning through color with a handful of emphasis utility classes.</p>
247
248
249
250
251
252
253
254
255
256
257
258
259
260
          <div class="bs-docs-example">
            <p class="muted">Fusce dapibus, tellus ac cursus commodo, tortor mauris nibh.</p>
            <p class="text-warning">Etiam porta sem malesuada magna mollis euismod.</p>
            <p class="text-error">Donec ullamcorper nulla non metus auctor fringilla.</p>
            <p class="text-info">Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis.</p>
            <p class="text-success">Duis mollis, est non commodo luctus, nisi erat porttitor ligula.</p>
          </div>
<pre class="prettyprint linenums">
&lt;p class="muted"&gt;Fusce dapibus, tellus ac cursus commodo, tortor mauris nibh.&lt;/p&gt;
&lt;p class="text-warning"&gt;Etiam porta sem malesuada magna mollis euismod.&lt;/p&gt;
&lt;p class="text-error"&gt;Donec ullamcorper nulla non metus auctor fringilla.&lt;/p&gt;
&lt;p class="text-info"&gt;Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis.&lt;/p&gt;
&lt;p class="text-success"&gt;Duis mollis, est non commodo luctus, nisi erat porttitor ligula.&lt;/p&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
261
262


263
          <hr class="bs-docs-separator">
Mark Otto's avatar
Mark Otto committed
264

265

266
          {{! Abbreviations }}
267
268
          <h2 id="abbreviations">Abbreviations</h2>
          <p>Stylized implementation of HTML's <code>&lt;abbr&gt;</code> element for abbreviations and acronyms to show the expanded version on hover. Abbreviations with a <code>title</code> attribute have a light dotted bottom border and a help cursor on hover, providing additional context on hover.</p>
Mark Otto's avatar
Mark Otto committed
269

270
          <h3><code>&lt;abbr&gt;</code></h3>
271
          <p>For expanded text on long hover of an abbreviation, include the <code>title</code> attribute.</p>
272
          <div class="bs-docs-example">
273
            <p>An abbreviation of the word attribute is <abbr title="attribute">attr</abbr>.</p>
274
275
276
277
          </div>
          <pre class="prettyprint">&lt;abbr title="attribute"&gt;attr&lt;/abbr&gt;</pre>

          <h3><code>&lt;abbr class="initialism"&gt;</code></h3>
278
          <p>Add <code>.initialism</code> to an abbreviation for a slightly smaller font-size.</p>
279
          <div class="bs-docs-example">
280
            <p><abbr title="HyperText Markup Language" class="initialism">HTML</abbr> is the best thing since sliced bread.</p>
281
          </div>
282
          <pre class="prettyprint">&lt;abbr title="HyperText Markup Language" class="initialism"&gt;HTML&lt;/abbr&gt;</pre>
283
284
285
286
287
288


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


          {{! Addresses }}
289
290
          <h2 id="addresses">Addresses</h2>
          <p>Present contact information for the nearest ancestor or the entire body of work.</p>
291
292

          <h3><code>&lt;address&gt;</code></h3>
293
          <p>Preserve formatting by ending all lines with <code>&lt;br&gt;</code>.</p>
294
295
296
297
298
299
300
301
          <div class="bs-docs-example">
            <address>
              <strong>Twitter, Inc.</strong><br>
              795 Folsom Ave, Suite 600<br>
              San Francisco, CA 94107<br>
              <abbr title="Phone">P:</abbr> (123) 456-7890
            </address>
            <address>
302
303
              <strong>Full Name</strong><br>
              <a href="mailto:#">first.last@example.com</a>
304
305
            </address>
          </div>
Mark Otto's avatar
Mark Otto committed
306
307
308
309
310
311
312
<pre class="prettyprint linenums">
&lt;address&gt;
  &lt;strong&gt;Twitter, Inc.&lt;/strong&gt;&lt;br&gt;
  795 Folsom Ave, Suite 600&lt;br&gt;
  San Francisco, CA 94107&lt;br&gt;
  &lt;abbr title="Phone"&gt;P:&lt;/abbr&gt; (123) 456-7890
&lt;/address&gt;
313

Mark Otto's avatar
Mark Otto committed
314
&lt;address&gt;
315
316
  &lt;strong&gt;Full Name&lt;/strong&gt;&lt;br&gt;
  &lt;a href="mailto:#"&gt;first.last@example.com&lt;/a&gt;
Mark Otto's avatar
Mark Otto committed
317
318
319
320
&lt;/address&gt;
</pre>


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

323

324
          {{! Blockquotes }}
325
326
          <h2 id="blockquotes">Blockquotes</h2>
          <p>For quoting blocks of content from another source within your document.</p>
Mark Otto's avatar
Mark Otto committed
327

328
329
          <h3>Default blockquote</h3>
          <p>Wrap <code>&lt;blockquote&gt;</code> around any <abbr title="HyperText Markup Language">HTML</abbr> as the quote. For straight quotes we recommend a <code>&lt;p&gt;</code>.</p>
330
331
332
333
334
          <div class="bs-docs-example">
            <blockquote>
              <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
            </blockquote>
          </div>
335
336
<pre class="prettyprint linenums">
&lt;blockquote&gt;
Mark Otto's avatar
Mark Otto committed
337
  &lt;p&gt;Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.&lt;/p&gt;
338
339
&lt;/blockquote&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
340

341
342
          <h3>Blockquote options</h3>
          <p>Style and content changes for simple variations on a standard blockquote.</p>
Mark Otto's avatar
Mark Otto committed
343

344
345
          <h4>Naming a source</h4>
          <p>Add <code>&lt;small&gt;</code> tag for identifying the source. Wrap the name of the source work in <code>&lt;cite&gt;</code>.</p>
346
347
348
          <div class="bs-docs-example">
            <blockquote>
              <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
349
              <small>Someone famous in <cite title="Source Title">Source Title</cite></small>
350
351
            </blockquote>
          </div>
Mark Otto's avatar
Mark Otto committed
352
353
354
<pre class="prettyprint linenums">
&lt;blockquote&gt;
  &lt;p&gt;Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.&lt;/p&gt;
355
  &lt;small&gt;Someone famous &lt;cite title="Source Title"&gt;Source Title&lt;/cite&gt;&lt;/small&gt;
Mark Otto's avatar
Mark Otto committed
356
357
358
&lt;/blockquote&gt;
</pre>

359
360
          <h4>Alternate displays</h4>
          <p>Use <code>.pull-right</code> for a floated, right-aligned blockquote.</p>
361
362
363
          <div class="bs-docs-example" style="overflow: hidden;">
            <blockquote class="pull-right">
              <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
364
              <small>Someone famous in <cite title="Source Title">Source Title</cite></small>
365
366
            </blockquote>
          </div>
Mark Otto's avatar
Mark Otto committed
367
368
<pre class="prettyprint linenums">
&lt;blockquote class="pull-right"&gt;
369
  ...
Mark Otto's avatar
Mark Otto committed
370
371
372
373
&lt;/blockquote&gt;
</pre>


374
375
376
377
          <hr class="bs-docs-separator">


          <!-- Lists -->
378
          <h2 id="lists">Lists</h2>
379

380
381
          <h3>Unordered</h3>
          <p>A list of items in which the order does <em>not</em> explicitly matter.</p>
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
          <div class="bs-docs-example">
            <ul>
              <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
                <ul>
                  <li>Phasellus iaculis neque</li>
                  <li>Purus sodales ultricies</li>
                  <li>Vestibulum laoreet porttitor sem</li>
                  <li>Ac tristique libero volutpat at</li>
                </ul>
              </li>
              <li>Faucibus porta lacus fringilla vel</li>
              <li>Aenean sit amet erat nunc</li>
              <li>Eget porttitor lorem</li>
            </ul>
          </div>
<pre class="prettyprint linenums">
&lt;ul&gt;
  &lt;li&gt;...&lt;/li&gt;
&lt;/ul&gt;
</pre>
406

407
408
          <h3>Ordered</h3>
          <p>A list of items in which the order <em>does</em> explicitly matter.</p>
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
          <div class="bs-docs-example">
            <ol>
              <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>
            </ol>
          </div>
<pre class="prettyprint linenums">
&lt;ol&gt;
  &lt;li&gt;...&lt;/li&gt;
&lt;/ol&gt;
</pre>
426

427
428
        <h3>Unstyled</h3>
        <p>Remove the default <code>list-style</code> and left padding on list items (immediate children only).</p>
429
        <div class="bs-docs-example">
430
          <ul class="list-unstyled">
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
            <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
              <ul>
                <li>Phasellus iaculis neque</li>
                <li>Purus sodales ultricies</li>
                <li>Vestibulum laoreet porttitor sem</li>
                <li>Ac tristique libero volutpat at</li>
              </ul>
            </li>
            <li>Faucibus porta lacus fringilla vel</li>
            <li>Aenean sit amet erat nunc</li>
            <li>Eget porttitor lorem</li>
          </ul>
        </div>
<pre class="prettyprint linenums">
449
&lt;ul class="list-unstyled"&gt;
450
451
  &lt;li&gt;...&lt;/li&gt;
&lt;/ul&gt;
452
453
</pre>

454
455
        <h3>Inline</h3>
        <p>Place all list items on a single line with <code>inline-block</code> and some light padding.</p>
456
        <div class="bs-docs-example">
457
          <ul class="list-inline">
Mark Otto's avatar
Mark Otto committed
458
459
460
            <li>Lorem ipsum</li>
            <li>Phasellus iaculis</li>
            <li>Nulla volutpat</li>
461
462
463
          </ul>
        </div>
<pre class="prettyprint linenums">
464
&lt;ul class="list-inline"&gt;
465
466
  &lt;li&gt;...&lt;/li&gt;
&lt;/ul&gt;
467
468
</pre>

469
470
        <h3>Description</h3>
        <p>A list of terms with their associated descriptions.</p>
471
        <div class="bs-docs-example">
472
          <dl>
473
474
            <dt>Description lists</dt>
            <dd>A description list is perfect for defining terms.</dd>
475
476
477
478
479
480
            <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>
481
482
        </div>
<pre class="prettyprint linenums">
483
484
485
486
487
&lt;dl&gt;
  &lt;dt&gt;...&lt;/dt&gt;
  &lt;dd&gt;...&lt;/dd&gt;
&lt;/dl&gt;
</pre>
488

489
490
        <h4>Horizontal description</h4>
        <p>Make terms and descriptions in <code>&lt;dl&gt;</code> line up side-by-side.</p>
491
492
        <div class="bs-docs-example">
          <dl class="dl-horizontal">
493
494
            <dt>Description lists</dt>
            <dd>A description list is perfect for defining terms.</dd>
495
496
497
498
499
500
501
502
503
            <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>
            <dt>Felis euismod semper eget lacinia</dt>
            <dd>Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</dd>
          </dl>
        </div>
504
505
506
507
508
509
<pre class="prettyprint linenums">
&lt;dl class="dl-horizontal"&gt;
  &lt;dt&gt;...&lt;/dt&gt;
  &lt;dd&gt;...&lt;/dd&gt;
&lt;/dl&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
510
        <h5>Auto-truncating</h5>
511
        <p>
512
          Horizontal description lists will truncate terms that are too long to fit in the left column fix <code>text-overflow</code>. In narrower viewports, they will change to the default stacked layout.
513
514
        </p>
      </section>
515
516
517



518
519
520
521
        <!-- Code
        ================================================== -->
        <section id="code">
          <div class="page-header">
522
            <h1>Code</h1>
523
          </div>
Mark Otto's avatar
Mark Otto committed
524

525
526
          <h2>Inline</h2>
          <p>Wrap inline snippets of code with <code>&lt;code&gt;</code>.</p>
Mark Otto's avatar
Mark Otto committed
527
528
529
<div class="bs-docs-example">
  For example, <code>&lt;section&gt;</code> should be wrapped as inline.
</div>
530
<pre class="prettyprint linenums">
531
For example, &lt;code&gt;&lt;section&gt;&lt;/code&gt; should be wrapped as inline.
532
</pre>
Mark Otto's avatar
Mark Otto committed
533

534
          <h2>Basic block</h2>
535
          <p>Use <code>&lt;pre&gt;</code> for multiple lines of code. Be sure to escape any angle brackets in the code for proper rendering.</p>
Mark Otto's avatar
Mark Otto committed
536
<div class="bs-docs-example">
537
  <pre>&lt;p&gt;Sample text here...&lt;/p&gt;</pre>
Mark Otto's avatar
Mark Otto committed
538
</div>
539
540
<pre class="prettyprint linenums" style="margin-bottom: 9px;">
&lt;pre&gt;
541
  &amp;lt;p&amp;gt;Sample text here...&amp;lt;/p&amp;gt;
542
543
&lt;/pre&gt;
</pre>
544
          <p>You may optionally add the <code>.pre-scrollable</code> class which will set a max-height of 350px and provide a y-axis scrollbar.</p>
545
        </section>
546
547
548



549
550
551
552
        <!-- Tables
        ================================================== -->
        <section id="tables">
          <div class="page-header">
553
            <h1>Tables</h1>
554
          </div>
555

556
557
          <h2>Default styles</h2>
          <p>For basic styling&mdash;light padding and only horizontal dividers&mdash;add the base class <code>.table</code> to any <code>&lt;table&gt;</code>.</p>
558
559
560
561
562
          <div class="bs-docs-example">
            <table class="table">
              <thead>
                <tr>
                  <th>#</th>
563
564
565
                  <th>First Name</th>
                  <th>Last Name</th>
                  <th>Username</th>
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
                </tr>
              </thead>
              <tbody>
                <tr>
                  <td>1</td>
                  <td>Mark</td>
                  <td>Otto</td>
                  <td>@mdo</td>
                </tr>
                <tr>
                  <td>2</td>
                  <td>Jacob</td>
                  <td>Thornton</td>
                  <td>@fat</td>
                </tr>
                <tr>
                  <td>3</td>
                  <td>Larry</td>
                  <td>the Bird</td>
                  <td>@twitter</td>
                </tr>
              </tbody>
            </table>
          </div>{{! /example }}
590
591
<pre class="prettyprint linenums">
&lt;table class="table"&gt;
592

Mark Otto's avatar
Mark Otto committed
593
594
&lt;/table&gt;
</pre>
595

596

597
598
599
          <hr class="bs-docs-separator">


600
601
          <h2>Optional classes</h2>
          <p>Add any of the following classes to the <code>.table</code> base class.</p>
602

603
604
          <h3><code>.table-striped</code></h3>
          <p>Adds zebra-striping to any table row within the <code>&lt;tbody&gt;</code> via the <code>:nth-child</code> CSS selector (not available in IE8).</p>
605
606
607
608
609
          <div class="bs-docs-example">
            <table class="table table-striped">
              <thead>
                <tr>
                  <th>#</th>
610
611
612
                  <th>First Name</th>
                  <th>Last Name</th>
                  <th>Username</th>
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
                </tr>
              </thead>
              <tbody>
                <tr>
                  <td>1</td>
                  <td>Mark</td>
                  <td>Otto</td>
                  <td>@mdo</td>
                </tr>
                <tr>
                  <td>2</td>
                  <td>Jacob</td>
                  <td>Thornton</td>
                  <td>@fat</td>
                </tr>
                <tr>
                  <td>3</td>
                  <td>Larry</td>
                  <td>the Bird</td>
                  <td>@twitter</td>
                </tr>
              </tbody>
            </table>
          </div>{{! /example }}
637
638
<pre class="prettyprint linenums" style="margin-bottom: 18px;">
&lt;table class="table table-striped"&gt;
639

Mark Otto's avatar
Mark Otto committed
640
641
&lt;/table&gt;
</pre>
642

643
644
          <h3><code>.table-bordered</code></h3>
          <p>Add borders and rounded corners to the table.</p>
645
646
647
648
649
          <div class="bs-docs-example">
            <table class="table table-bordered">
              <thead>
                <tr>
                  <th>#</th>
650
651
652
                  <th>First Name</th>
                  <th>Last Name</th>
                  <th>Username</th>
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
                </tr>
              </thead>
              <tbody>
                <tr>
                  <td rowspan="2">1</td>
                  <td>Mark</td>
                  <td>Otto</td>
                  <td>@mdo</td>
                </tr>
                <tr>
                  <td>Mark</td>
                  <td>Otto</td>
                  <td>@TwBootstrap</td>
                </tr>
                <tr>
                  <td>2</td>
                  <td>Jacob</td>
                  <td>Thornton</td>
                  <td>@fat</td>
                </tr>
                <tr>
                  <td>3</td>
                  <td colspan="2">Larry the Bird</td>
                  <td>@twitter</td>
                </tr>
              </tbody>
            </table>
          </div>{{! /example }}
681
682
<pre class="prettyprint linenums">
&lt;table class="table table-bordered"&gt;
683

Mark Otto's avatar
Mark Otto committed
684
&lt;/table&gt;
685
686
</pre>

687
688
          <h3><code>.table-hover</code></h3>
          <p>Enable a hover state on table rows within a <code>&lt;tbody&gt;</code>.</p>
689
690
691
692
693
          <div class="bs-docs-example">
            <table class="table table-hover">
              <thead>
                <tr>
                  <th>#</th>
694
695
696
                  <th>First Name</th>
                  <th>Last Name</th>
                  <th>Username</th>
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
                </tr>
              </thead>
              <tbody>
                <tr>
                  <td>1</td>
                  <td>Mark</td>
                  <td>Otto</td>
                  <td>@mdo</td>
                </tr>
                <tr>
                  <td>2</td>
                  <td>Jacob</td>
                  <td>Thornton</td>
                  <td>@fat</td>
                </tr>
                <tr>
                  <td>3</td>
                  <td colspan="2">Larry the Bird</td>
                  <td>@twitter</td>
                </tr>
              </tbody>
            </table>
          </div>{{! /example }}
720
721
722
723
724
725
<pre class="prettyprint linenums" style="margin-bottom: 18px;">
&lt;table class="table table-hover"&gt;

&lt;/table&gt;
</pre>

726
727
          <h3><code>.table-condensed</code></h3>
          <p>Makes tables more compact by cutting cell padding in half.</p>
728
729
730
731
732
          <div class="bs-docs-example">
            <table class="table table-condensed">
              <thead>
                <tr>
                  <th>#</th>
733
734
735
                  <th>First Name</th>
                  <th>Last Name</th>
                  <th>Username</th>
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
                </tr>
              </thead>
              <tbody>
                <tr>
                  <td>1</td>
                  <td>Mark</td>
                  <td>Otto</td>
                  <td>@mdo</td>
                </tr>
                <tr>
                  <td>2</td>
                  <td>Jacob</td>
                  <td>Thornton</td>
                  <td>@fat</td>
                </tr>
                <tr>
                  <td>3</td>
                  <td colspan="2">Larry the Bird</td>
                  <td>@twitter</td>
                </tr>
              </tbody>
            </table>
          </div>{{! /example }}
759
760
761
762
763
764
765
<pre class="prettyprint linenums" style="margin-bottom: 18px;">
&lt;table class="table table-condensed"&gt;

&lt;/table&gt;
</pre>


766
767
768
          <hr class="bs-docs-separator">


769
770
          <h2>Optional row classes</h2>
          <p>Use contextual classes to color table rows.</p>
771
772
773
774
775
          <table class="table table-bordered table-striped">
            <colgroup>
              <col class="span1">
              <col class="span7">
            </colgroup>
776
777
            <thead>
              <tr>
778
779
                <th>Class</th>
                <th>Description</th>
780
781
782
              </tr>
            </thead>
            <tbody>
783
784
785
786
              <tr>
                <td>
                  <code>.success</code>
                </td>
787
                <td>Indicates a successful or positive action.</td>
788
              </tr>
789
790
791
792
              <tr>
                <td>
                  <code>.error</code>
                </td>
793
                <td>Indicates a dangerous or potentially negative action.</td>
794
              </tr>
795
796
797
798
              <tr>
                <td>
                  <code>.warning</code>
                </td>
799
                <td>Indicates a warning that might need attention.</td>
800
              </tr>
801
802
803
804
              <tr>
                <td>
                  <code>.info</code>
                </td>
805
                <td>Used as an alternative to the default styles.</td>
806
807
808
              </tr>
            </tbody>
          </table>
809
810
811
812
813
          <div class="bs-docs-example">
            <table class="table">
              <thead>
                <tr>
                  <th>#</th>
814
815
816
                  <th>Product</th>
                  <th>Payment Taken</th>
                  <th>Status</th>
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
                </tr>
              </thead>
              <tbody>
                <tr class="success">
                  <td>1</td>
                  <td>TB - Monthly</td>
                  <td>01/04/2012</td>
                  <td>Approved</td>
                </tr>
                <tr class="error">
                  <td>2</td>
                  <td>TB - Monthly</td>
                  <td>02/04/2012</td>
                  <td>Declined</td>
                </tr>
832
                <tr class="warning">
833
834
835
836
837
                  <td>3</td>
                  <td>TB - Monthly</td>
                  <td>03/04/2012</td>
                  <td>Pending</td>
                </tr>
838
839
840
841
842
843
                <tr class="info">
                  <td>4</td>
                  <td>TB - Monthly</td>
                  <td>04/04/2012</td>
                  <td>Call in to confirm</td>
                </tr>
844
845
846
              </tbody>
            </table>
          </div>{{! /example }}
847
<pre class="prettyprint linenums">
848
849
850
851
852
853
854
855
...
  &lt;tr class="success"&gt;
    &lt;td&gt;1&lt;/td&gt;
    &lt;td&gt;TB - Monthly&lt;/td&gt;
    &lt;td&gt;01/04/2012&lt;/td&gt;
    &lt;td&gt;Approved&lt;/td&gt;
  &lt;/tr&gt;
...
856
857
858
</pre>


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


862
863
          <h2>Supported table markup</h2>
          <p>List of supported table HTML elements and how they should be used.</p>
864
865
866
867
868
869
870
          <table class="table table-bordered table-striped">
            <colgroup>
              <col class="span1">
              <col class="span7">
            </colgroup>
            <thead>
              <tr>
871
872
                <th>Tag</th>
                <th>Description</th>
873
874
875
876
877
878
879
880
              </tr>
            </thead>
            <tbody>
              <tr>
                <td>
                  <code>&lt;table&gt;</code>
                </td>
                <td>
881
                  Wrapping element for displaying data in a tabular format
882
883
884
885
886
887
888
                </td>
              </tr>
              <tr>
                <td>
                  <code>&lt;thead&gt;</code>
                </td>
                <td>
889
                  Container element for table header rows (<code>&lt;tr&gt;</code>) to label table columns
890
891
892
893
894
895
896
                </td>
              </tr>
              <tr>
                <td>
                  <code>&lt;tbody&gt;</code>
                </td>
                <td>
897
                  Container element for table rows (<code>&lt;tr&gt;</code>) in the body of the table
898
899
900
901
902
903
904
                </td>
              </tr>
              <tr>
                <td>
                  <code>&lt;tr&gt;</code>
                </td>
                <td>
905
                  Container element for a set of table cells (<code>&lt;td&gt;</code> or <code>&lt;th&gt;</code>) that appears on a single row
906
907
908
909
910
911
912
                </td>
              </tr>
              <tr>
                <td>
                  <code>&lt;td&gt;</code>
                </td>
                <td>
913
                  Default table cell
914
915
916
917
918
919
920
                </td>
              </tr>
              <tr>
                <td>
                  <code>&lt;th&gt;</code>
                </td>
                <td>
921
922
                  Special table cell for column (or row, depending on scope and placement) labels<br>
                  Must be used within a <code>&lt;thead&gt;</code>
923
924
925
926
927
928
929
                </td>
              </tr>
              <tr>
                <td>
                  <code>&lt;caption&gt;</code>
                </td>
                <td>
930
                  Description or summary of what the table holds, especially useful for screen readers
931
932
933
934
                </td>
              </tr>
            </tbody>
          </table>
935
936
<pre class="prettyprint linenums">
&lt;table&gt;
Mark Otto's avatar
Mark Otto committed
937
  &lt;caption&gt;...&lt;/caption&gt;
938
939
  &lt;thead&gt;
    &lt;tr&gt;
Mark Otto's avatar
Mark Otto committed
940
941
      &lt;th&gt;...&lt;/th&gt;
      &lt;th&gt;...&lt;/th&gt;
942
943
944
945
    &lt;/tr&gt;
  &lt;/thead&gt;
  &lt;tbody&gt;
    &lt;tr&gt;
Mark Otto's avatar
Mark Otto committed
946
947
      &lt;td&gt;...&lt;/td&gt;
      &lt;td&gt;...&lt;/td&gt;
948
949
    &lt;/tr&gt;
  &lt;/tbody&gt;
Mark Otto's avatar
Mark Otto committed
950
951
952
&lt;/table&gt;
</pre>

953
        </section>
954
955
956



957
958
959
960
        <!-- Forms
        ================================================== -->
        <section id="forms">
          <div class="page-header">
961
            <h1>Forms</h1>
962
          </div>
Mark Otto's avatar
Mark Otto committed
963

964
965
          <h2 id="forms-default">Default styles</h2>
          <p>Individual form controls automatically receive some global styling. By default, inputs are set to <code>width: 100%;</code>.</p>
966
          <form class="bs-docs-example">
967
968
            <fieldset>
              <legend>Legend</legend>
969
970
971
              <label>Label name</label>
              <input type="text" placeholder="Type something…">
              <p class="help-block">Example block-level help text here.</p>
972
973
              <div class="checkbox">
                <label>
974
                  <input type="checkbox"> Check me out
975
976
                </label>
              </div>
977
              <button type="submit" class="btn">Submit</button>
978
            </fieldset>
979
          </form>{{! /example }}
980
<pre class="prettyprint linenums">
981
&lt;form&gt;
982
  &lt;fieldset&gt;
983
984
985
    &lt;legend&gt;Legend&lt;/legend&gt;
    &lt;label&gt;Label name&lt;/label&gt;
    &lt;input type="text" placeholder="Type something…"&gt;
986
    &lt;span class="help-block"&gt;Example block-level help text here.&lt;/span&gt;
987
988
    &lt;div class="checkbox"&gt;
      &lt;label&gt;
989
        &lt;input type="checkbox"&gt; Check me out
990
991
      &lt;/label&gt;
    &lt;/div&gt;
992
    &lt;button type="submit" class="btn"&gt;Submit&lt;/button&gt;
993
  &lt;/fieldset&gt;
994
995
&lt;/form&gt;
</pre>
Mark Otto's avatar
Mark Otto committed
996

997

998
          <hr class="bs-docs-separator">
999
1000


For faster browsing, not all history is shown. View entire blame