rooty/Bootstrap
0
0
Fork 0
mirror of https://github.com/twbs/bootstrap.git synced 2025-02-21 18:54:30 +01:00
Code Issues Actions Packages Releases Activity

restore jekyll-based css.html to docs

Browse Source
This commit is contained in:
Mark Otto 2013-02-15 12:22:26 -08:00
parent 64ae9e5bd8
commit 866c8d60e9
1 changed files with 624 additions and 716 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1340
docs/css.html
View File

@ -1,70 +1,7 @@
<!DOCTYPE html> ---
<html lang="en"> layout: default
<head> title: CSS
<meta charset="utf-8"> ---
<title>Css · Bootstrap</title>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="">
<meta name="author" content="">
<!-- Bootstrap core CSS -->
<link href="assets/css/bootstrap.css" rel="stylesheet">
<!-- Documentation extras -->
<link href="assets/css/docs.css" rel="stylesheet">
<link href="assets/js/google-code-prettify/prettify.css" rel="stylesheet">
<!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
<!--[if lt IE 9]>
<script src="assets/js/html5shiv.js"></script>
<script src="assets/js/respond/respond.min.js"></script>
<![endif]-->
<!-- Favicons -->
<link rel="apple-touch-icon-precomposed" sizes="144x144" href="assets/ico/apple-touch-icon-144-precomposed.png">
<link rel="apple-touch-icon-precomposed" sizes="114x114" href="assets/ico/apple-touch-icon-114-precomposed.png">
<link rel="apple-touch-icon-precomposed" sizes="72x72" href="assets/ico/apple-touch-icon-72-precomposed.png">
<link rel="apple-touch-icon-precomposed" href="assets/ico/apple-touch-icon-57-precomposed.png">
<link rel="shortcut icon" href="assets/ico/favicon.png">
</head>
<body data-spy="scroll" data-target=".bs-docs-sidebar">
<!-- Navbar
================================================== -->
<div class="navbar navbar-inverse navbar-fixed-top">
<div class="container">
<button type="button" class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse">
<span class="icon-bar"></span>
<span class="icon-bar"></span>
<span class="icon-bar"></span>
</button>
<a class="brand" href="./index.html">Bootstrap</a>
<div class="nav-collapse collapse">
<ul class="nav">
<li class="">
<a href="./index.html">Home</a>
</li>
<li class="">
<a href="./getting-started.html">Get started</a>
</li>
<li class="active">
<a href="./css.html">CSS</a>
</li>
<li class="">
<a href="./components.html">Components</a>
</li>
<li class="">
<a href="./javascript.html">JavaScript</a>
</li>
<li class="">
<a href="./customize.html">Customize</a>
</li>
</ul>
</div>
</div>
</div>
<!-- Subhead <!-- Subhead
================================================== --> ================================================== -->
@ -109,17 +46,21 @@
<h3>Requires HTML5 doctype</h3> <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> <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>
<pre class="prettyprint linenums">
&lt;!DOCTYPE html&gt; {% highlight html linenos %}
&lt;html lang="en"&gt; <!DOCTYPE html>
<html lang="en">
... ...
&lt;/html&gt; </html>
</pre> {% endhighlight %}
<h3>Mobile first</h3> <h3>Mobile first</h3>
<p>With Bootstrap 2, we added optional mobile friendly styles for key aspects of the framework. With Bootstrap 3, we've rewritten the project to be mobile friendly from the start. Instead of adding on optional mobile styles, they're baked right into the core. In fact, <strong>Bootstrap is mobile first</strong>. Mobile first styles can be found throughout the entire library instead of in separate files.</p> <p>With Bootstrap 2, we added optional mobile friendly styles for key aspects of the framework. With Bootstrap 3, we've rewritten the project to be mobile friendly from the start. Instead of adding on optional mobile styles, they're baked right into the core. In fact, <strong>Bootstrap is mobile first</strong>. Mobile first styles can be found throughout the entire library instead of in separate files.</p>
<p>To ensure proper rendering and touch zooming, <strong>add the viewport meta tag</strong> to your <code>&lt;head&gt;</code>.</p> <p>To ensure proper rendering and touch zooming, <strong>add the viewport meta tag</strong> to your <code>&lt;head&gt;</code>.</p>
<pre class="prettyprint linenums">&lt;meta name="viewport" content="width=device-width, initial-scale=1.0"&gt;</pre>
{% highlight html linenos %}
<meta name="viewport" content="width=device-width, initial-scale=1.0">
{% endhighlight %}
<h3>Typography and links</h3> <h3>Typography and links</h3>
<p>Bootstrap sets basic global display, typography, and link styles. Specifically, we:</p> <p>Bootstrap sets basic global display, typography, and link styles. Specifically, we:</p>
@ -146,6 +87,7 @@
<h1>Typography</h1> <h1>Typography</h1>
</div> </div>
<!-- Headings -->
<h2 id="headings">Headings</h2> <h2 id="headings">Headings</h2>
<p>All HTML headings, <code>&lt;h1&gt;</code> through <code>&lt;h6&gt;</code> are available.</p> <p>All HTML headings, <code>&lt;h1&gt;</code> through <code>&lt;h6&gt;</code> are available.</p>
<div class="bs-docs-example"> <div class="bs-docs-example">
@ -157,6 +99,7 @@
<h6>h6. Heading 6</h6> <h6>h6. Heading 6</h6>
</div> </div>
<!-- Body copy -->
<h2 id="body-copy">Body copy</h2> <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> <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>
<div class="bs-docs-example"> <div class="bs-docs-example">
@ -164,19 +107,26 @@
<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>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> <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> </div>
<pre class="prettyprint">&lt;p&gt;...&lt;/p&gt;</pre> {% highlight html linenos %}
<p>...</p>
{% endhighlight %}
<!-- Body copy .lead -->
<h3>Lead body copy</h3> <h3>Lead body copy</h3>
<p>Make a paragraph stand out by adding <code>.lead</code>.</p> <p>Make a paragraph stand out by adding <code>.lead</code>.</p>
<div class="bs-docs-example"> <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> <p class="lead">Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus.</p>
</div> </div>
<pre class="prettyprint">&lt;p class="lead"&gt;...&lt;/p&gt;</pre> {% highlight html linenos %}
<p class="lead">...</p>
{% endhighlight %}
<!-- Using LESS -->
<h3>Built with Less</h3> <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> <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>
<!-- Emphasis -->
<h2 id="emphasis">Emphasis</h2> <h2 id="emphasis">Emphasis</h2>
<p>Make use of HTML's default emphasis tags with lightweight styles.</p> <p>Make use of HTML's default emphasis tags with lightweight styles.</p>
@ -185,25 +135,28 @@
<div class="bs-docs-example"> <div class="bs-docs-example">
<p><small>This line of text is meant to be treated as fine print.</small></p> <p><small>This line of text is meant to be treated as fine print.</small></p>
</div> </div>
<pre class="prettyprint"> {% highlight html linenos %}
&lt;p&gt; <small>This line of text is meant to be treated as fine print.</small>
&lt;small&gt;This line of text is meant to be treated as fine print.&lt;/small&gt; {% endhighlight %}
&lt;/p&gt;
</pre>
<h3>Bold</h3> <h3>Bold</h3>
<p>For emphasizing a snippet of text with a heavier font-weight.</p> <p>For emphasizing a snippet of text with a heavier font-weight.</p>
<div class="bs-docs-example"> <div class="bs-docs-example">
<p>The following snippet of text is <strong>rendered as bold text</strong>.</p> <p>The following snippet of text is <strong>rendered as bold text</strong>.</p>
</div> </div>
<pre class="prettyprint">&lt;strong&gt;rendered as bold text&lt;/strong&gt;</pre> {% highlight html linenos %}
<strong>rendered as bold text</strong>
{% endhighlight %}
<h3>Italics</h3> <h3>Italics</h3>
<p>For emphasizing a snippet of text with italics.</p> <p>For emphasizing a snippet of text with italics.</p>
<div class="bs-docs-example"> <div class="bs-docs-example">
<p>The following snippet of text is <em>rendered as italicized text</em>.</p> <p>The following snippet of text is <em>rendered as italicized text</em>.</p>
</div> </div>
<pre class="prettyprint">&lt;em&gt;rendered as italicized text&lt;/em&gt;</pre> {% highlight html linenos %}
<em>rendered as italicized text</em>
{% endhighlight %}
<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> <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>
@ -214,11 +167,11 @@
<p class="text-center">Center aligned text.</p> <p class="text-center">Center aligned text.</p>
<p class="text-right">Right aligned text.</p> <p class="text-right">Right aligned text.</p>
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;p class="text-left"&gt;Left aligned text.&lt;/p&gt; <p class="text-left">Left aligned text.</p>
&lt;p class="text-center"&gt;Center aligned text.&lt;/p&gt; <p class="text-center">Center aligned text.</p>
&lt;p class="text-right"&gt;Right aligned text.&lt;/p&gt; <p class="text-right">Right aligned text.</p>
</pre> {% endhighlight %}
<h3>Emphasis classes</h3> <h3>Emphasis classes</h3>
<p>Convey meaning through color with a handful of emphasis utility classes.</p> <p>Convey meaning through color with a handful of emphasis utility classes.</p>
@ -228,14 +181,16 @@
<p class="text-error">Donec ullamcorper nulla non metus auctor fringilla.</p> <p class="text-error">Donec ullamcorper nulla non metus auctor fringilla.</p>
<p class="text-success">Duis mollis, est non commodo luctus, nisi erat porttitor ligula.</p> <p class="text-success">Duis mollis, est non commodo luctus, nisi erat porttitor ligula.</p>
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;p class="muted"&gt;Fusce dapibus, tellus ac cursus commodo, tortor mauris nibh.&lt;/p&gt; <p class="muted">Fusce dapibus, tellus ac cursus commodo, tortor mauris nibh.</p>
&lt;p class="text-warning"&gt;Etiam porta sem malesuada magna mollis euismod.&lt;/p&gt; <p class="text-warning">Etiam porta sem malesuada magna mollis euismod.</p>
&lt;p class="text-error"&gt;Donec ullamcorper nulla non metus auctor fringilla.&lt;/p&gt; <p class="text-error">Donec ullamcorper nulla non metus auctor fringilla.</p>
&lt;p class="text-success"&gt;Duis mollis, est non commodo luctus, nisi erat porttitor ligula.&lt;/p&gt; <p class="text-error">Donec ullamcorper nulla non metus auctor fringilla.</p>
</pre> <p class="text-success">Duis mollis, est non commodo luctus, nisi erat porttitor ligula.</p>
{% endhighlight %}
<!-- Abbreviations -->
<h2 id="abbreviations">Abbreviations</h2> <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> <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>
@ -244,16 +199,21 @@
<div class="bs-docs-example"> <div class="bs-docs-example">
<p>An abbreviation of the word attribute is <abbr title="attribute">attr</abbr>.</p> <p>An abbreviation of the word attribute is <abbr title="attribute">attr</abbr>.</p>
</div> </div>
<pre class="prettyprint">&lt;abbr title="attribute"&gt;attr&lt;/abbr&gt;</pre> {% highlight html linenos %}
<abbr title="attribute">attr</abbr>
{% endhighlight %}
<h3><code>&lt;abbr class="initialism"&gt;</code></h3> <h3><code>&lt;abbr class="initialism"&gt;</code></h3>
<p>Add <code>.initialism</code> to an abbreviation for a slightly smaller font-size.</p> <p>Add <code>.initialism</code> to an abbreviation for a slightly smaller font-size.</p>
<div class="bs-docs-example"> <div class="bs-docs-example">
<p><abbr title="HyperText Markup Language" class="initialism">HTML</abbr> is the best thing since sliced bread.</p> <p><abbr title="HyperText Markup Language" class="initialism">HTML</abbr> is the best thing since sliced bread.</p>
</div> </div>
<pre class="prettyprint">&lt;abbr title="HyperText Markup Language" class="initialism"&gt;HTML&lt;/abbr&gt;</pre> {% highlight html linenos %}
<abbr title="HyperText Markup Language" class="initialism">HTML</abbr>
{% endhighlight %}
<!-- Addresses -->
<h2 id="addresses">Addresses</h2> <h2 id="addresses">Addresses</h2>
<p>Present contact information for the nearest ancestor or the entire body of work.</p> <p>Present contact information for the nearest ancestor or the entire body of work.</p>
@ -271,21 +231,22 @@
<a href="mailto:#">first.last@example.com</a> <a href="mailto:#">first.last@example.com</a>
</address> </address>
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;address&gt; <address>
&lt;strong&gt;Twitter, Inc.&lt;/strong&gt;&lt;br&gt; <strong>Twitter, Inc.</strong><br>
795 Folsom Ave, Suite 600&lt;br&gt; 795 Folsom Ave, Suite 600<br>
San Francisco, CA 94107&lt;br&gt; San Francisco, CA 94107<br>
&lt;abbr title="Phone"&gt;P:&lt;/abbr&gt; (123) 456-7890 <abbr title="Phone">P:</abbr> (123) 456-7890
&lt;/address&gt; </address>
&lt;address&gt; <address>
&lt;strong&gt;Full Name&lt;/strong&gt;&lt;br&gt; <strong>Full Name</strong><br>
&lt;a href="mailto:#"&gt;first.last@example.com&lt;/a&gt; <a href="mailto:#">first.last@example.com</a>
&lt;/address&gt; </address>
</pre> {% endhighlight %}
<!-- Blockquotes -->
<h2 id="blockquotes">Blockquotes</h2> <h2 id="blockquotes">Blockquotes</h2>
<p>For quoting blocks of content from another source within your document.</p> <p>For quoting blocks of content from another source within your document.</p>
@ -296,11 +257,11 @@
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p> <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
</blockquote> </blockquote>
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;blockquote&gt; <blockquote>
&lt;p&gt;Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.&lt;/p&gt; <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
&lt;/blockquote&gt; </blockquote>
</pre> {% endhighlight %}
<h3>Blockquote options</h3> <h3>Blockquote options</h3>
<p>Style and content changes for simple variations on a standard blockquote.</p> <p>Style and content changes for simple variations on a standard blockquote.</p>
@ -313,12 +274,12 @@
<small>Someone famous in <cite title="Source Title">Source Title</cite></small> <small>Someone famous in <cite title="Source Title">Source Title</cite></small>
</blockquote> </blockquote>
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;blockquote&gt; <blockquote>
&lt;p&gt;Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.&lt;/p&gt; <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
&lt;small&gt;Someone famous &lt;cite title="Source Title"&gt;Source Title&lt;/cite&gt;&lt;/small&gt; <small>Someone famous <cite title="Source Title">Source Title</cite></small>
&lt;/blockquote&gt; </blockquote>
</pre> {% endhighlight %}
<h4>Alternate displays</h4> <h4>Alternate displays</h4>
<p>Use <code>.pull-right</code> for a floated, right-aligned blockquote.</p> <p>Use <code>.pull-right</code> for a floated, right-aligned blockquote.</p>
@ -328,11 +289,11 @@
<small>Someone famous in <cite title="Source Title">Source Title</cite></small> <small>Someone famous in <cite title="Source Title">Source Title</cite></small>
</blockquote> </blockquote>
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;blockquote class="pull-right"&gt; <blockquote class="pull-right">
... ...
&lt;/blockquote&gt; </blockquote>
</pre> {% endhighlight %}
<!-- Lists --> <!-- Lists -->
@ -359,11 +320,11 @@
<li>Eget porttitor lorem</li> <li>Eget porttitor lorem</li>
</ul> </ul>
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;ul&gt; <ul>
&lt;li&gt;...&lt;/li&gt; <li>...</li>
&lt;/ul&gt; </ul>
</pre> {% endhighlight %}
<h3>Ordered</h3> <h3>Ordered</h3>
<p>A list of items in which the order <em>does</em> explicitly matter.</p> <p>A list of items in which the order <em>does</em> explicitly matter.</p>
@ -379,11 +340,11 @@
<li>Eget porttitor lorem</li> <li>Eget porttitor lorem</li>
</ol> </ol>
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;ol&gt; <ol>
&lt;li&gt;...&lt;/li&gt; <li>...</li>
&lt;/ol&gt; </ol>
</pre> {% endhighlight %}
<h3>Unstyled</h3> <h3>Unstyled</h3>
<p>Remove the default <code>list-style</code> and left padding on list items (immediate children only).</p> <p>Remove the default <code>list-style</code> and left padding on list items (immediate children only).</p>
@ -406,11 +367,11 @@
<li>Eget porttitor lorem</li> <li>Eget porttitor lorem</li>
</ul> </ul>
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;ul class="list-unstyled"&gt; <ul class="list-unstyled">
&lt;li&gt;...&lt;/li&gt; <li>...</li>
&lt;/ul&gt; </ul>
</pre> {% endhighlight %}
<h3>Inline</h3> <h3>Inline</h3>
<p>Place all list items on a single line with <code>inline-block</code> and some light padding.</p> <p>Place all list items on a single line with <code>inline-block</code> and some light padding.</p>
@ -421,11 +382,11 @@
<li>Nulla volutpat</li> <li>Nulla volutpat</li>
</ul> </ul>
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;ul class="list-inline"&gt; <ul class="list-inline">
&lt;li&gt;...&lt;/li&gt; <li>...</li>
&lt;/ul&gt; </ul>
</pre> {% endhighlight %}
<h3>Description</h3> <h3>Description</h3>
<p>A list of terms with their associated descriptions.</p> <p>A list of terms with their associated descriptions.</p>
@ -440,12 +401,12 @@
<dd>Etiam porta sem malesuada magna mollis euismod.</dd> <dd>Etiam porta sem malesuada magna mollis euismod.</dd>
</dl> </dl>
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;dl&gt; <dl>
&lt;dt&gt;...&lt;/dt&gt; <dt>...</dt>
&lt;dd&gt;...&lt;/dd&gt; <dd>...</dd>
&lt;/dl&gt; </dl>
</pre> {% endhighlight %}
<h4>Horizontal description</h4> <h4>Horizontal description</h4>
<p>Make terms and descriptions in <code>&lt;dl&gt;</code> line up side-by-side.</p> <p>Make terms and descriptions in <code>&lt;dl&gt;</code> line up side-by-side.</p>
@ -462,12 +423,13 @@
<dd>Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</dd> <dd>Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.</dd>
</dl> </dl>
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;dl class="dl-horizontal"&gt; <dl class="dl-horizontal">
&lt;dt&gt;...&lt;/dt&gt; <dt>...</dt>
&lt;dd&gt;...&lt;/dd&gt; <dd>...</dd>
&lt;/dl&gt; </dl>
</pre> {% endhighlight %}
<h5>Auto-truncating</h5> <h5>Auto-truncating</h5>
<p> <p>
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. 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,12 +475,13 @@
<h3>Basic grid HTML</h3> <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> <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>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;div class="row"&gt; <div class="row">
&lt;div class="span4"&gt;...&lt;/div&gt; <div class="span8">8</div>
&lt;div class="span8"&gt;...&lt;/div&gt; <div class="span4">4</div>
&lt;/div&gt; </div>
</pre> {% endhighlight %}
<p>Given this example, we have <code>.span4</code> and <code>.span8</code>, making for 12 total columns and a complete row.</p> <p>Given this example, we have <code>.span4</code> and <code>.span8</code>, making for 12 total columns and a complete row.</p>
<h2>Offsetting columns</h2> <h2>Offsetting columns</h2>
@ -536,12 +499,12 @@
<div class="span6 offset6">6 offset 6</div> <div class="span6 offset6">6 offset 6</div>
</div><!-- /row --> </div><!-- /row -->
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;div class="row"&gt; <div class="row">
&lt;div class="span4"&gt;...&lt;/div&gt; <div class="span4">...</div>
&lt;div class="span4 offset4"&gt;...&lt;/div&gt; <div class="span4 offset4">...</div>
&lt;/div&gt; </div>
</pre> {% endhighlight %}
<h2>Nesting columns</h2> <h2>Nesting columns</h2>
@ -559,17 +522,22 @@
</div> </div>
</div> </div>
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;div class="row"&gt; <div class="row">
&lt;div class="span9"&gt; <div class="span9">
Level 1: 9 columns Level 1: 9 columns
&lt;div class="row"&gt; <div class="row">
&lt;div class="span6"&gt;Level 2: 6 columns&lt;/div&gt; <div class="span6">
&lt;div class="span6"&gt;Level 2: 6 columns&lt;/div&gt; Level 2: 6 columns
&lt;/div&gt; </div>
&lt;/div&gt; <div class="span6">
&lt;/div&gt; Level 2: 6 columns
</pre> </div>
</div>
</div>
</div>
{% endhighlight %}
</section> </section>
@ -588,20 +556,19 @@
<div class="bs-docs-example"> <div class="bs-docs-example">
For example, <code>&lt;section&gt;</code> should be wrapped as inline. For example, <code>&lt;section&gt;</code> should be wrapped as inline.
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped as inline. For example, <code>&lt;section&gt;</code> should be wrapped as inline.
</pre> {% endhighlight %}
<h2>Basic block</h2> <h2>Basic block</h2>
<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> <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>
<div class="bs-docs-example"> <div class="bs-docs-example">
<pre>&lt;p&gt;Sample text here...&lt;/p&gt;</pre> <pre>&lt;p&gt;Sample text here...&lt;/p&gt;</pre>
</div> </div>
<pre class="prettyprint linenums" style="margin-bottom: 9px;"> {% highlight html linenos %}
&lt;pre&gt; <pre>&lt;p&gt;Sample text here...&lt;/p&gt;</pre>
&amp;lt;p&amp;gt;Sample text here...&amp;lt;/p&amp;gt; {% endhighlight %}
&lt;/pre&gt;
</pre>
<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> <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>
</section> </section>
@ -615,7 +582,7 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</div> </div>
<h2>Default styles</h2> <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> <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>. It may seem super redundant, but given the widespread use of tables for other plugins like calendars and date pickers, we've opted to isolate our custom table styles.</p>
<div class="bs-docs-example"> <div class="bs-docs-example">
<table class="table"> <table class="table">
<thead> <thead>
@ -647,12 +614,12 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</tr> </tr>
</tbody> </tbody>
</table> </table>
</div> </div><!-- /example -->
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;table class="table"&gt; <table class="table">
… ...
&lt;/table&gt; </table>
</pre> {% endhighlight %}
<h2>Optional classes</h2> <h2>Optional classes</h2>
@ -691,12 +658,12 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</tr> </tr>
</tbody> </tbody>
</table> </table>
</div> </div><!-- /example -->
<pre class="prettyprint linenums" style="margin-bottom: 18px;"> {% highlight html linenos %}
&lt;table class="table table-striped"&gt; <table class="table table-striped">
… ...
&lt;/table&gt; </table>
</pre> {% endhighlight %}
<h3><code>.table-bordered</code></h3> <h3><code>.table-bordered</code></h3>
<p>Add borders and rounded corners to the table.</p> <p>Add borders and rounded corners to the table.</p>
@ -735,12 +702,12 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</tr> </tr>
</tbody> </tbody>
</table> </table>
</div> </div><!-- /example -->
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;table class="table table-bordered"&gt; <table class="table table-bordered">
… ...
&lt;/table&gt; </table>
</pre> {% endhighlight %}
<h3><code>.table-hover</code></h3> <h3><code>.table-hover</code></h3>
<p>Enable a hover state on table rows within a <code>&lt;tbody&gt;</code>.</p> <p>Enable a hover state on table rows within a <code>&lt;tbody&gt;</code>.</p>
@ -774,12 +741,13 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</tr> </tr>
</tbody> </tbody>
</table> </table>
</div> </div><!-- /example -->
<pre class="prettyprint linenums" style="margin-bottom: 18px;"> {% highlight html linenos %}
&lt;table class="table table-hover"&gt; <table class="table table-hover">
… ...
&lt;/table&gt; </table>
</pre> {% endhighlight %}
<h3><code>.table-condensed</code></h3> <h3><code>.table-condensed</code></h3>
<p>Makes tables more compact by cutting cell padding in half.</p> <p>Makes tables more compact by cutting cell padding in half.</p>
@ -813,12 +781,13 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</tr> </tr>
</tbody> </tbody>
</table> </table>
</div> </div><!-- /example -->
<pre class="prettyprint linenums" style="margin-bottom: 18px;"> {% highlight html linenos %}
&lt;table class="table table-condensed"&gt; <table class="table table-condensed">
… ...
&lt;/table&gt; </table>
</pre> {% endhighlight %}
<h2>Optional row classes</h2> <h2>Optional row classes</h2>
@ -890,25 +859,20 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<td>03/04/2012</td> <td>03/04/2012</td>
<td>Pending</td> <td>Pending</td>
</tr> </tr>
<tr class="info">
<td>4</td>
<td>TB - Monthly</td>
<td>04/04/2012</td>
<td>Call in to confirm</td>
</tr>
</tbody> </tbody>
</table> </table>
</div> </div><!-- /example -->
<pre class="prettyprint linenums"> {% highlight html linenos %}
... ...
&lt;tr class="success"&gt; <tr class="sucess">
&lt;td&gt;1&lt;/td&gt; <td>1</td>
&lt;td&gt;TB - Monthly&lt;/td&gt; <td>TB - Monthly</td>
&lt;td&gt;01/04/2012&lt;/td&gt; <td>01/04/2012</td>
&lt;td&gt;Approved&lt;/td&gt; <td>Approved</td>
&lt;/tr&gt; </tr>
... ...
</pre> {% endhighlight %}
<h2>Supported table markup</h2> <h2>Supported table markup</h2>
@ -983,23 +947,25 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</tr> </tr>
</tbody> </tbody>
</table> </table>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;table&gt; <table>
&lt;caption&gt;...&lt;/caption&gt; <caption>...</caption>
&lt;thead&gt; <thead>
&lt;tr&gt; <tr>
&lt;th&gt;...&lt;/th&gt; <th>...</th>
&lt;th&gt;...&lt;/th&gt; <th>...</th>
&lt;/tr&gt; <th>...</th>
&lt;/thead&gt; </tr>
&lt;tbody&gt; </thead>
&lt;tr&gt; <tbody>
&lt;td&gt;...&lt;/td&gt; <tr>
&lt;td&gt;...&lt;/td&gt; <td>...</td>
&lt;/tr&gt; <td>...</td>
&lt;/tbody&gt; <td>...</td>
&lt;/table&gt; </tr>
</pre> </tbody>
</table>
{% endhighlight %}
</section> </section>
@ -1027,23 +993,23 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</div> </div>
<button type="submit" class="btn">Submit</button> <button type="submit" class="btn">Submit</button>
</fieldset> </fieldset>
</form> </form><!-- /example -->
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;form&gt; <form>
&lt;fieldset&gt; <fieldset>
&lt;legend&gt;Legend&lt;/legend&gt; <legend>Legend</legend>
&lt;label&gt;Label name&lt;/label&gt; <label>Label name</label>
&lt;input type="text" placeholder="Type something…"&gt; <input type="text" placeholder="Type something…">
&lt;span class="help-block"&gt;Example block-level help text here.&lt;/span&gt; <p class="help-block">Example block-level help text here.</p>
&lt;div class="checkbox"&gt; <div class="checkbox">
&lt;label&gt; <label>
&lt;input type="checkbox"&gt; Check me out <input type="checkbox"> Check me out
&lt;/label&gt; </label>
&lt;/div&gt; </div>
&lt;button type="submit" class="btn"&gt;Submit&lt;/button&gt; <button type="submit" class="btn">Submit</button>
&lt;/fieldset&gt; </fieldset>
&lt;/form&gt; </form>
</pre> {% endhighlight %}
<h2 id="forms-layouts">Optional layouts</h2> <h2 id="forms-layouts">Optional layouts</h2>
@ -1060,19 +1026,19 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</label> </label>
</div> </div>
<button type="submit" class="btn">Sign in</button> <button type="submit" class="btn">Sign in</button>
</form> </form><!-- /example -->
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;form class="form-inline"&gt; <form class="form-inline">
&lt;input type="text" class="span3" placeholder="Email"&gt; <input type="text" class="span3" placeholder="Email">
&lt;input type="password" class="span3" placeholder="Password"&gt; <input type="password" class="span3" placeholder="Password">
&lt;div class="checkbox"&gt; <div class="checkbox">
&lt;label&gt; <label>
&lt;input type="checkbox"&gt; Remember me <input type="checkbox"> Remember me
&lt;/label&gt; </label>
&lt;/div&gt; </div>
&lt;button type="submit" class="btn"&gt;Sign in&lt;/button&gt; <button type="submit" class="btn">Sign in</button>
&lt;/form&gt; </form>
</pre> {% endhighlight %}
<h3>Horizontal form</h3> <h3>Horizontal form</h3>
<p>Right align labels and float them to the left to make them appear on the same line as controls. Requires the most markup changes from a default form:</p> <p>Right align labels and float them to the left to make them appear on the same line as controls. Requires the most markup changes from a default form:</p>
@ -1106,32 +1072,32 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</div> </div>
</div> </div>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;form class="form-horizontal"&gt; <form class="form-horizontal">
&lt;div class="control-group"&gt; <div class="control-group">
&lt;label class="control-label" for="inputEmail"&gt;Email&lt;/label&gt; <label class="control-label" for="inputEmail">Email</label>
&lt;div class="controls"&gt; <div class="controls">
&lt;input type="text" id="inputEmail" placeholder="Email"&gt; <input type="text" id="inputEmail" placeholder="Email">
&lt;/div&gt; </div>
&lt;/div&gt; </div>
&lt;div class="control-group"&gt; <div class="control-group">
&lt;label class="control-label" for="inputPassword"&gt;Password&lt;/label&gt; <label class="control-label" for="inputPassword">Password</label>
&lt;div class="controls"&gt; <div class="controls">
&lt;input type="password" id="inputPassword" placeholder="Password"&gt; <input type="password" id="inputPassword" placeholder="Password">
&lt;/div&gt; <div class="checkbox">
&lt;/div&gt; <label>
&lt;div class="control-group"&gt; <input type="checkbox"> Remember me
&lt;div class="controls"&gt; </label>
&lt;div class="checkbox"&gt; </div>
&lt;label&gt; </div>
&lt;input type="checkbox"&gt; Remember me </div>
&lt;/label&gt; <div class="control-group">
&lt;/div&gt; <div class="controls">
&lt;button type="submit" class="btn"&gt;Sign in&lt;/button&gt; <button type="submit" class="btn">Sign in</button>
&lt;/div&gt; </div>
&lt;/div&gt; </div>
&lt;/form&gt; </form>
</pre> {% endhighlight %}
<h2 id="forms-controls">Supported form controls</h2> <h2 id="forms-controls">Supported form controls</h2>
@ -1143,18 +1109,18 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<form class="bs-docs-example form-inline"> <form class="bs-docs-example form-inline">
<input type="text" placeholder="Text input"> <input type="text" placeholder="Text input">
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;input type="text" placeholder="Text input"&gt; <input type="text" placeholder="Text input">
</pre> {% endhighlight %}
<h3>Textarea</h3> <h3>Textarea</h3>
<p>Form control which supports multiple lines of text. Change <code>rows</code> attribute as necessary.</p> <p>Form control which supports multiple lines of text. Change <code>rows</code> attribute as necessary.</p>
<form class="bs-docs-example form-inline"> <form class="bs-docs-example form-inline">
<textarea rows="3"></textarea> <textarea rows="3"></textarea>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;textarea rows="3"&gt;&lt;/textarea&gt; <textarea rows="3"></textarea>
</pre> {% endhighlight %}
<h3>Checkboxes and radios</h3> <h3>Checkboxes and radios</h3>
<p>Checkboxes are for selecting one or several options in a list while radios are for selecting one option from many.</p> <p>Checkboxes are for selecting one or several options in a list while radios are for selecting one option from many.</p>
@ -1180,27 +1146,21 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</label> </label>
</div> </div>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;div class="checkbox"&gt; <div class="checkbox">
&lt;label&gt; <label>
&lt;input type="checkbox" value=""&gt; <input type="checkbox" value="">
Option one is this and that&mdash;be sure to include why it's great Option one is this and that&mdash;be sure to include why it's great
&lt;/label&gt; </label>
&lt;/div&gt; </div>
&lt;div class="radio"&gt; <div class="radio">
&lt;label&gt; <label>
&lt;input type="radio" name="optionsRadios" id="optionsRadios1" value="option1" checked&gt; <input type="radio" name="optionsRadios" id="optionsRadios1" value="option1" checked>
Option one is this and that&mdash;be sure to include why it's great Option one is this and that&mdash;be sure to include why it's great
&lt;/label&gt; </label>
&lt;/div&gt; </div>
&lt;div class="radio"&gt; {% endhighlight %}
&lt;label&gt;
&lt;input type="radio" name="optionsRadios" id="optionsRadios2" value="option2"&gt;
Option two can be something else and selecting it will deselect option one
&lt;/label&gt;
&lt;/div&gt;
</pre>
<h4>Inline checkboxes</h4> <h4>Inline checkboxes</h4>
<p>Use <code>.checkbox-inline</code> or <code>.radio-inline</code> class to a series of checkboxes or radios for controls appear on the same line.</p> <p>Use <code>.checkbox-inline</code> or <code>.radio-inline</code> class to a series of checkboxes or radios for controls appear on the same line.</p>
@ -1215,17 +1175,17 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<input type="checkbox" id="inlineCheckbox3" value="option3"> 3 <input type="checkbox" id="inlineCheckbox3" value="option3"> 3
</label> </label>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;label class="checkbox-inline"&gt; <label class="checkbox-inline">
&lt;input type="checkbox" id="inlineCheckbox1" value="option1"&gt; 1 <input type="checkbox" id="inlineCheckbox1" value="option1"> 1
&lt;/label&gt; </label>
&lt;label class="checkbox-inline"&gt; <label class="checkbox-inline">
&lt;input type="checkbox" id="inlineCheckbox2" value="option2"&gt; 2 <input type="checkbox" id="inlineCheckbox2" value="option2"> 2
&lt;/label&gt; </label>
&lt;label class="checkbox-inline"&gt; <label class="checkbox-inline">
&lt;input type="checkbox" id="inlineCheckbox3" value="option3"&gt; 3 <input type="checkbox" id="inlineCheckbox3" value="option3"> 3
&lt;/label&gt; </label>
</pre> {% endhighlight %}
<h3>Selects</h3> <h3>Selects</h3>
<p>Use the default option or specify a <code>multiple="multiple"</code> to show multiple options at once.</p> <p>Use the default option or specify a <code>multiple="multiple"</code> to show multiple options at once.</p>
@ -1246,23 +1206,23 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<option>5</option> <option>5</option>
</select> </select>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;select&gt; <select>
&lt;option&gt;1&lt;/option&gt; <option>1</option>
&lt;option&gt;2&lt;/option&gt; <option>2</option>
&lt;option&gt;3&lt;/option&gt; <option>3</option>
&lt;option&gt;4&lt;/option&gt; <option>4</option>
&lt;option&gt;5&lt;/option&gt; <option>5</option>
&lt;/select&gt; </select>
&lt;select multiple="multiple"&gt; <select multiple="multiple">
&lt;option&gt;1&lt;/option&gt; <option>1</option>
&lt;option&gt;2&lt;/option&gt; <option>2</option>
&lt;option&gt;3&lt;/option&gt; <option>3</option>
&lt;option&gt;4&lt;/option&gt; <option>4</option>
&lt;option&gt;5&lt;/option&gt; <option>5</option>
&lt;/select&gt; </select>
</pre> {% endhighlight %}
@ -1274,9 +1234,9 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<form class="bs-docs-example form-inline"> <form class="bs-docs-example form-inline">
<input class="focused" id="focusedInput" type="text" value="This is focused..."> <input class="focused" id="focusedInput" type="text" value="This is focused...">
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;input id="focusedInput" type="text" value="This is focused..."&gt; <input id="focusedInput" type="text" value="This is focused...">
</pre> {% endhighlight %}
<h3 id="forms-invalid-inputs">Invalid inputs</h3> <h3 id="forms-invalid-inputs">Invalid inputs</h3>
<p>Style inputs via default browser functionality with <code>:invalid</code>. Specify a <code>type</code>, add the <code>required</code> attribute if the field is not optional, and (if applicable) specify a <code>pattern</code>.</p> <p>Style inputs via default browser functionality with <code>:invalid</code>. Specify a <code>type</code>, add the <code>required</code> attribute if the field is not optional, and (if applicable) specify a <code>pattern</code>.</p>
@ -1284,18 +1244,18 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<form class="bs-docs-example form-inline"> <form class="bs-docs-example form-inline">
<input class="span3" type="email" placeholder="test@example.com" required> <input class="span3" type="email" placeholder="test@example.com" required>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;input class="span3" type="email" required&gt; <input class="span3" type="email" placeholder="test@example.com" required>
</pre> {% endhighlight %}
<h3 id="forms-disabled-inputs">Disabled inputs</h3> <h3 id="forms-disabled-inputs">Disabled inputs</h3>
<p>Add the <code>disabled</code> attribute on an input to prevent user input and trigger a slightly different look.</p> <p>Add the <code>disabled</code> attribute on an input to prevent user input and trigger a slightly different look.</p>
<form class="bs-docs-example form-inline"> <form class="bs-docs-example form-inline">
<input class="input-xlarge" id="disabledInput" type="text" placeholder="Disabled input here…" disabled> <input class="input-xlarge" id="disabledInput" type="text" placeholder="Disabled input here…" disabled>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;input class="input-xlarge" id="disabledInput" type="text" placeholder="Disabled input here..." disabled&gt; <input id="disabledInput" type="text" placeholder="Disabled input here..." disabled>
</pre> {% endhighlight %}
<h3 id="forms-disabled-fieldsets">Disabled fieldsets</h3> <h3 id="forms-disabled-fieldsets">Disabled fieldsets</h3>
<p>Add the <code>disabled</code> attribute to a <code>&lt;fieldset&gt;</code> to disable all the controls within the <code>&lt;fieldset&gt;</code> at once. Link buttons (with the <code>&lt;a&gt;</code> element) will be aesthetically disabled, but you will need custom JavaScript to disable their behavior.</p> <p>Add the <code>disabled</code> attribute to a <code>&lt;fieldset&gt;</code> to disable all the controls within the <code>&lt;fieldset&gt;</code> at once. Link buttons (with the <code>&lt;a&gt;</code> element) will be aesthetically disabled, but you will need custom JavaScript to disable their behavior.</p>
@ -1317,22 +1277,26 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<button type="submit" class="btn btn-primary">Submit</button> <button type="submit" class="btn btn-primary">Submit</button>
</fieldset> </fieldset>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;form class="form-inline"&gt; <form class="form-inline">
&lt;fieldset disabled&gt; <fieldset disabled>
&lt;input type="text" class="span4" placeholder="Disabled input"&gt; <div>
&lt;select class="span4"&gt; <input type="text" class="span4" placeholder="Disabled input">
&lt;option&gt;Disabled select&lt;/option&gt; </div>
&lt;/select&gt; <div>
&lt;div class="checkbox"&gt; <select class="span4">
&lt;label&gt; <option>Disabled select</option>
&lt;input type="checkbox"&gt; Can't check this </select>
&lt;/label&gt; </div>
&lt;/div&gt; <div class="checkbox">
&lt;button type="submit" class="btn btn-primary"&gt;Submit&lt;/button&gt; <label>
&lt;/fieldset&gt; <input type="checkbox"> Can't check this
&lt;/form&gt; </label>
</pre> </div>
<button type="submit" class="btn btn-primary">Submit</button>
</fieldset>
</form>
{% endhighlight %}
<h3 id="forms-validation">Validation states</h3> <h3 id="forms-validation">Validation states</h3>
<p>Bootstrap includes validation styles for error, warning, info, and success messages. To use:</p> <p>Bootstrap includes validation styles for error, warning, info, and success messages. To use:</p>
@ -1362,26 +1326,26 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</div> </div>
</div> </div>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;div class="control-group has-warning"&gt; <div class="control-group has-warning">
&lt;label class="control-label" for="inputWarning"&gt;Input with warning&lt;/label&gt; <label class="control-label" for="inputWarning">Input with warning</label>
&lt;div class="controls"&gt; <div class="controls">
&lt;input type="text" class="input-with-feedback" id="inputWarning"&gt; <input type="text" class="input-with-feedback" id="inputWarning">
&lt;/div&gt; </div>
&lt;/div&gt; </div>
&lt;div class="control-group has-error"&gt; <div class="control-group has-error">
&lt;label class="control-label" for="inputError"&gt;Input with error&lt;/label&gt; <label class="control-label" for="inputError">Input with error</label>
&lt;div class="controls"&gt; <div class="controls">
&lt;input type="text" class="input-with-feedback" id="inputError"&gt; <input type="text" class="input-with-feedback" id="inputError">
&lt;/div&gt; </div>
&lt;/div&gt; </div>
&lt;div class="control-group has-success"&gt; <div class="control-group has-success">
&lt;label class="control-label" for="inputSuccess"&gt;Input with success&lt;/label&gt; <label class="control-label" for="inputSuccess">Input with success</label>
&lt;div class="controls"&gt; <div class="controls">
&lt;input type="text" class="input-with-feedback id="inputSuccess""&gt; <input type="text" class="input-with-feedback" id="inputSuccess">
&lt;/div&gt; </div>
&lt;/div&gt; </div>
</pre> {% endhighlight %}
@ -1408,23 +1372,23 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<span class="input-group-addon">.00</span> <span class="input-group-addon">.00</span>
</div> </div>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;div class="input-group span9"&gt; <div class="input-group span9">
&lt;span class="input-group-addon"&gt;@&lt;/span&gt; <span class="input-group-addon">@</span>
&lt;input type="text" placeholder="Username"&gt; <input type="text" placeholder="Username">
&lt;/div&gt; </div>
&lt;div class="input-group span6"&gt; <div class="input-group span6">
&lt;input type="text"&gt; <input type="text">
&lt;span class="input-group-addon"&gt;.00&lt;/span&gt; <span class="input-group-addon">.00</span>
&lt;/div&gt; </div>
&lt;div class="input-group span3"&gt; <div class="input-group span3">
&lt;span class="input-group-addon"&gt;$&lt;/span&gt; <span class="input-group-addon">$</span>
&lt;input type="text"&gt; <input type="text">
&lt;span class="input-group-addon"&gt;.00&lt;/span&gt; <span class="input-group-addon">.00</span>
&lt;/div&gt; </div>
</pre> {% endhighlight %}
<h4>Optional sizes</h4> <h4>Optional sizes</h4>
<p>Add the relative form sizing classes to the `.input-group-addon`.</p> <p>Add the relative form sizing classes to the `.input-group-addon`.</p>
@ -1444,20 +1408,22 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<input type="text" class="input-small" placeholder="Username"> <input type="text" class="input-small" placeholder="Username">
</div> </div>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;div class="input-group span9"&gt; <div class="input-group span9">
&lt;span class="input-group-addon input-large"&gt;@&lt;/span&gt; <span class="input-group-addon input-large">@</span>
&lt;input type="text" class="input-large" placeholder="Username"&gt; <input type="text" class="input-large" placeholder="Username">
&lt;/div&gt; </div>
&lt;div class="input-group span9"&gt;
&lt;span class="input-group-addon"&gt;@&lt;/span&gt; <div class="input-group span9">
&lt;input type="text" placeholder="Username"&gt; <span class="input-group-addon">@</span>
&lt;/div&gt; <input type="text" placeholder="Username">
&lt;div class="input-group span9"&gt; </div>
&lt;span class="input-group-addon input-small"&gt;@&lt;/span&gt;
&lt;input type="text" class="input-small" placeholder="Username"&gt; <div class="input-group span9">
&lt;/div&gt; <span class="input-group-addon input-small">@</span>
</pre> <input type="text" class="input-small" placeholder="Username">
</div>
{% endhighlight %}
<h4>Buttons instead of text</h4> <h4>Buttons instead of text</h4>
<p>Buttons in input groups are a bit different and require one extra level of nesting. Instead of <code>.input-group-addon</code>, you'll need to use <code>.input-group-btn</code> to wrap the buttons. This is required due to default browser styles that cannot be overridden.</p> <p>Buttons in input groups are a bit different and require one extra level of nesting. Instead of <code>.input-group-addon</code>, you'll need to use <code>.input-group-btn</code> to wrap the buttons. This is required due to default browser styles that cannot be overridden.</p>
@ -1476,21 +1442,21 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</span> </span>
</div> </div>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;div class="input-group span7"&gt; <div class="input-group span7">
&lt;span class="input-group-btn"&gt; <span class="input-group-btn">
&lt;button class="btn" type="button"&gt;Go!&lt;/button&gt; <button class="btn" type="button">Go!</button>
&lt;/span&gt; </span>
&lt;input type="text"&gt; <input type="text">
&lt;/div&gt; </div>
&lt;div class="input-group span7"&gt; <div class="input-group span7">
&lt;input type="text"&gt; <input type="text">
&lt;span class="input-group-btn"&gt; <span class="input-group-btn">
&lt;button class="btn" type="button"&gt;Go!&lt;/button&gt; <button class="btn" type="button">Go!</button>
&lt;/span&gt; </span>
&lt;/div&gt; </div>
</pre> {% endhighlight %}
<h4>Button dropdowns</h4> <h4>Button dropdowns</h4>
<p></p> <p></p>
@ -1523,33 +1489,35 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</div><!-- /btn-group --> </div><!-- /btn-group -->
</div><!-- /input-group --> </div><!-- /input-group -->
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;div class="input-group span7"&gt; <div class="input-group span7">
&lt;div class="input-group-btn btn-group"&gt; <div class="input-group-btn btn-group">
&lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt; <button class="btn dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
Action <ul class="dropdown-menu">
&lt;span class="caret"&gt;&lt;/span&gt; <li><a href="#">Action</a></li>
&lt;/button&gt; <li><a href="#">Another action</a></li>
&lt;ul class="dropdown-menu"&gt; <li><a href="#">Something else here</a></li>
... <li class="divider"></li>
&lt;/ul&gt; <li><a href="#">Separated link</a></li>
&lt;/div&gt; </ul>
&lt;input type="text"&gt; </div><!-- /btn-group -->
&lt;/div&gt; <input type="text">
</div><!-- /input-group -->
&lt;div class="input-group span7"&gt; <div class="input-group span7">
&lt;input type="text"&gt; <input type="text">
&lt;div class="input-group-btn btn-group"&gt; <div class="input-group-btn btn-group">
&lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt; <button class="btn dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
Action <ul class="dropdown-menu">
&lt;span class="caret"&gt;&lt;/span&gt; <li><a href="#">Action</a></li>
&lt;/button&gt; <li><a href="#">Another action</a></li>
&lt;ul class="dropdown-menu"&gt; <li><a href="#">Something else here</a></li>
... <li class="divider"></li>
&lt;/ul&gt; <li><a href="#">Separated link</a></li>
&lt;/div&gt; </ul>
&lt;/div&gt; </div><!-- /btn-group -->
</pre> </div><!-- /input-group -->
{% endhighlight %}
<h4>Segmented dropdown groups</h4> <h4>Segmented dropdown groups</h4>
<form class="bs-docs-example"> <form class="bs-docs-example">
@ -1567,7 +1535,7 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<li><a href="#">Separated link</a></li> <li><a href="#">Separated link</a></li>
</ul> </ul>
</div> </div>
<input type="text" class="span3"> <input type="text">
</div> </div>
<br> <br>
@ -1589,16 +1557,21 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</div> </div>
</div> </div>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;div class="input-prepend"&gt; <div class="input-group span7">
&lt;div class="btn-group"&gt;...&lt;/div&gt; <div class="input-group-btn btn-group">
&lt;input type="text" class="span3"&gt; <!-- Button and dropdown menu -->
&lt;/div&gt; </div>
&lt;div class="input-append"&gt; <input type="text">
&lt;input type="text" class="span3"&gt; </div>
&lt;div class="btn-group"&gt;...&lt;/div&gt;
&lt;/div&gt; <div class="input-group span7">
</pre> <input type="text">
<div class="input-group-btn btn-group">
<!-- Button and dropdown menu -->
</div>
</div>
{% endhighlight %}
<h3 id="forms-extending-sizes">Control sizing</h3> <h3 id="forms-extending-sizes">Control sizing</h3>
<p>Use relative sizing classes like <code>.input-large</code> or match your inputs to the grid column sizes using <code>.span*</code> classes.</p> <p>Use relative sizing classes like <code>.input-large</code> or match your inputs to the grid column sizes using <code>.span*</code> classes.</p>
@ -1612,11 +1585,11 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<input class="input-small" type="text" placeholder=".input-small"> <input class="input-small" type="text" placeholder=".input-small">
</div> </div>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;input class="input-large" type="text" placeholder=".input-large"&gt; <input class="input-large" type="text" placeholder=".input-large">
&lt;input type="text" placeholder="Default input"&gt; <input type="text" placeholder="Default input">
&lt;input class="input-small" type="text" placeholder=".input-small"&gt; <input class="input-small" type="text" placeholder=".input-small">
</pre> {% endhighlight %}
<h4>Column sizing</h4> <h4>Column sizing</h4>
<p>Use <code>.span1</code> to <code>.span12</code> for setting widths on inputs that match Bootstrap's grid system.</p> <p>Use <code>.span1</code> to <code>.span12</code> for setting widths on inputs that match Bootstrap's grid system.</p>
@ -1648,20 +1621,21 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</select> </select>
</div> </div>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;input class="span1" type="text" placeholder=".span1"&gt; <input class="span1" type="text" placeholder=".span1">
&lt;input class="span2" type="text" placeholder=".span2"&gt; <input class="span2" type="text" placeholder=".span2">
&lt;input class="span3" type="text" placeholder=".span3"&gt; <input class="span3" type="text" placeholder=".span3">
&lt;select class="span1"&gt; <select class="span1">
... ...
&lt;/select&gt; </select>
&lt;select class="span2"&gt; <select class="span2">
... ...
&lt;/select&gt; </select>
&lt;select class="span3"&gt; <select class="span3">
... ...
&lt;/select&gt; </select>
</pre> {% endhighlight %}
<p>If you need multiple inputs on the same line, wrap them in the standard grid markup (with <code>.row</code> and <code>.span*</code> classes). Each input should have it's own column and will expand to fill the available width automatically.</p> <p>If you need multiple inputs on the same line, wrap them in the standard grid markup (with <code>.row</code> and <code>.span*</code> classes). Each input should have it's own column and will expand to fill the available width automatically.</p>
<form class="bs-docs-example" style="padding-bottom: 15px;"> <form class="bs-docs-example" style="padding-bottom: 15px;">
<div class="row"> <div class="row">
@ -1676,28 +1650,28 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</div> </div>
</div> </div>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;div class="row"&gt; <div class="row">
&lt;div class="span4"&gt; <div class="span4">
&lt;input type="text" placeholder=".span4"&gt; <input type="text" placeholder=".span4">
&lt;/div&gt; </div>
&lt;div class="span4"&gt; <div class="span4">
&lt;input type="text" placeholder=".span4"&gt; <input type="text" placeholder=".span4">
&lt;/div&gt; </div>
&lt;div class="span4"&gt; <div class="span4">
&lt;input type="text" placeholder=".span4"&gt; <input type="text" placeholder=".span4">
&lt;/div&gt; </div>
&lt;/div&gt; </div>
</pre> {% endhighlight %}
<h3>Uneditable inputs</h3> <h3>Uneditable inputs</h3>
<p>Present data in a form that's not editable without using actual form markup.</p> <p>Present data in a form that's not editable without using actual form markup.</p>
<form class="bs-docs-example"> <form class="bs-docs-example">
<span class="input-xlarge uneditable-input">Some value here</span> <span class="input-xlarge uneditable-input">Some value here</span>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;span class="input-xlarge uneditable-input"&gt;Some value here&lt;/span&gt; <span class="uneditable-input">Some value here</span>
</pre> {% endhighlight %}
<h3>Form actions</h3> <h3>Form actions</h3>
<p>End a form with a group of actions (buttons). When placed within a <code>.form-horizontal</code>, the buttons will automatically indent to line up with the form controls.</p> <p>End a form with a group of actions (buttons). When placed within a <code>.form-horizontal</code>, the buttons will automatically indent to line up with the form controls.</p>
@ -1707,12 +1681,12 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<button type="button" class="btn">Cancel</button> <button type="button" class="btn">Cancel</button>
</div> </div>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;div class="form-actions"&gt; <div class="form-actions">
&lt;button type="submit" class="btn btn-primary"&gt;Save changes&lt;/button&gt; <button type="submit" class="btn btn-primary">Save changes</button>
&lt;button type="button" class="btn"&gt;Cancel&lt;/button&gt; <button type="button" class="btn">Cancel</button>
&lt;/div&gt; </div>
</pre> {% endhighlight %}
<h3>Help text</h3> <h3>Help text</h3>
<p>Inline and block level support for help text that appears around form controls.</p> <p>Inline and block level support for help text that appears around form controls.</p>
@ -1720,18 +1694,20 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<form class="bs-docs-example form-inline"> <form class="bs-docs-example form-inline">
<input type="text"> <span class="help-inline">Inline help text</span> <input type="text"> <span class="help-inline">Inline help text</span>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;input type="text"&gt;&lt;span class="help-inline"&gt;Inline help text&lt;/span&gt; <input type="text">
</pre> <span class="help-inline">Inline help text</span>
{% endhighlight %}
<h4>Block help</h4> <h4>Block help</h4>
<form class="bs-docs-example form-inline"> <form class="bs-docs-example form-inline">
<input type="text"> <input type="text">
<span class="help-block">A longer block of help text that breaks onto a new line and may extend beyond one line.</span> <span class="help-block">A longer block of help text that breaks onto a new line and may extend beyond one line.</span>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;input type="text"&gt;&lt;span class="help-block"&gt;A longer block of help text that breaks onto a new line and may extend beyond one line.&lt;/span&gt; <input type="text">
</pre> <span class="help-block">A longer block of help text that breaks onto a new line and may extend beyond one line.</span>
{% endhighlight %}
</section> </section>
@ -1817,24 +1793,25 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<button type="button" class="btn btn-mini">Mini button</button> <button type="button" class="btn btn-mini">Mini button</button>
</p> </p>
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;p&gt; <p>
&lt;button class="btn btn-large btn-primary" type="button"&gt;Large button&lt;/button&gt; <button type="button" class="btn btn-large btn-primary">Large button</button>
&lt;button class="btn btn-large" type="button"&gt;Large button&lt;/button&gt; <button type="button" class="btn btn-large">Large button</button>
&lt;/p&gt; </p>
&lt;p&gt; <p>
&lt;button class="btn btn-primary" type="button"&gt;Default button&lt;/button&gt; <button type="button" class="btn btn-primary">Default button</button>
&lt;button class="btn" type="button"&gt;Default button&lt;/button&gt; <button type="button" class="btn">Default button</button>
&lt;/p&gt; </p>
&lt;p&gt; <p>
&lt;button class="btn btn-small btn-primary" type="button"&gt;Small button&lt;/button&gt; <button type="button" class="btn btn-small btn-primary">Small button</button>
&lt;button class="btn btn-small" type="button"&gt;Small button&lt;/button&gt; <button type="button" class="btn btn-small">Small button</button>
&lt;/p&gt; </p>
&lt;p&gt; <p>
&lt;button class="btn btn-mini btn-primary" type="button"&gt;Mini button&lt;/button&gt; <button type="button" class="btn btn-mini btn-primary">Mini button</button>
&lt;button class="btn btn-mini" type="button"&gt;Mini button&lt;/button&gt; <button type="button" class="btn btn-mini">Mini button</button>
&lt;/p&gt; </p>
</pre> {% endhighlight %}
<p>Create block level buttons&mdash;those that span the full width of a parent&mdash; by adding <code>.btn-block</code>.</p> <p>Create block level buttons&mdash;those that span the full width of a parent&mdash; by adding <code>.btn-block</code>.</p>
<div class="bs-docs-example"> <div class="bs-docs-example">
<div class="well" style="max-width: 400px; margin: 0 auto 10px;"> <div class="well" style="max-width: 400px; margin: 0 auto 10px;">
@ -1842,40 +1819,40 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<button type="button" class="btn btn-large btn-block">Block level button</button> <button type="button" class="btn btn-large btn-block">Block level button</button>
</div> </div>
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;button class="btn btn-large btn-block btn-primary" type="button"&gt;Block level button&lt;/button&gt; <button type="button" class="btn btn-large btn-block btn-primary">Block level button</button>
&lt;button class="btn btn-large btn-block" type="button"&gt;Block level button&lt;/button&gt; <button type="button" class="btn btn-large btn-block">Block level button</button>
</pre> {% endhighlight %}
<h2>Disabled state</h2> <h2>Disabled state</h2>
<p>Make buttons look unclickable by fading them back 50%.</p> <p>Make buttons look unclickable by fading them back 50%.</p>
<h3>Button element</h3>
<p>Add the <code>disabled</code> attribute to <code>&lt;button&gt;</code> buttons.</p>
<p class="bs-docs-example">
<button type="button" class="btn btn-large btn-primary disabled" disabled="disabled">Primary button</button>
<button type="button" class="btn btn-large" disabled="disabled">Button</button>
</p>
{% highlight html linenos %}
<button type="button" class="btn btn-large btn-primary disabled" disabled="disabled">Primary button</button>
<button type="button" class="btn btn-large" disabled="disabled">Button</button>
{% endhighlight %}
<h3>Anchor element</h3> <h3>Anchor element</h3>
<p>Add the <code>.disabled</code> class to <code>&lt;a&gt;</code> buttons.</p> <p>Add the <code>.disabled</code> class to <code>&lt;a&gt;</code> buttons.</p>
<p class="bs-docs-example"> <p class="bs-docs-example">
<a href="#" class="btn btn-large btn-primary disabled">Primary link</a> <a href="#" class="btn btn-large btn-primary disabled">Primary link</a>
<a href="#" class="btn btn-large disabled">Link</a> <a href="#" class="btn btn-large disabled">Link</a>
</p> </p>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;a href="#" class="btn btn-large btn-primary disabled"&gt;Primary link&lt;/a&gt; <a href="#" class="btn btn-large btn-primary disabled">Primary link</a>
&lt;a href="#" class="btn btn-large disabled"&gt;Link&lt;/a&gt; <a href="#" class="btn btn-large disabled">Link</a>
</pre> {% endhighlight %}
<p> <p>
We use <code>.disabled</code> as a utility class here, similar to the common <code>.active</code> class, so no prefix is required. Also, this class is only for aesthetic; you must use custom JavaScript to disable links here. We use <code>.disabled</code> as a utility class here, similar to the common <code>.active</code> class, so no prefix is required. Also, this class is only for aesthetic; you must use custom JavaScript to disable links here.
</p> </p>
<h3>Button element</h3>
<p>Add the <code>disabled</code> attribute to <code>&lt;button&gt;</code> buttons.</p>
<p class="bs-docs-example">
<button type="button" class="btn btn-large btn-primary disabled" disabled="disabled">Primary button</button>
<button type="button" class="btn btn-large" disabled>Button</button>
</p>
<pre class="prettyprint linenums">
&lt;button type="button" class="btn btn-large btn-primary disabled" disabled="disabled"&gt;Primary button&lt;/button&gt;
&lt;button type="button" class="btn btn-large" disabled&gt;Button&lt;/button&gt;
</pre>
<h2>One class, multiple tags</h2> <h2>One class, multiple tags</h2>
<p>Use the <code>.btn</code> class on an <code>&lt;a&gt;</code>, <code>&lt;button&gt;</code>, or <code>&lt;input&gt;</code> element.</p> <p>Use the <code>.btn</code> class on an <code>&lt;a&gt;</code>, <code>&lt;button&gt;</code>, or <code>&lt;input&gt;</code> element.</p>
@ -1885,13 +1862,13 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<input class="btn" type="button" value="Input"> <input class="btn" type="button" value="Input">
<input class="btn" type="submit" value="Submit"> <input class="btn" type="submit" value="Submit">
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;a class="btn" href=""&gt;Link&lt;/a&gt; <a class="btn" href="">Link</a>
&lt;button class="btn" type="submit"&gt;Button&lt;/button&gt; <button class="btn" type="submit">Button</button>
&lt;input class="btn" type="button" value="Input"&gt; <input class="btn" type="button" value="Input">
&lt;input class="btn" type="submit" value="Submit"&gt; <input class="btn" type="submit" value="Submit">
</pre> {% endhighlight %}
<p>As a best practice, try to match the element for your context to ensure matching cross-browser rendering. If you have an <code>input</code>, use an <code>&lt;input type="submit"&gt;</code> for your button.</p> <p>As a best practice, <strong>we highly recommend matching using the <code>&lt;button&lt;</code> element whenever possible</strong> to ensure matching cross-browser rendering.</p>
</section> </section>
@ -1906,15 +1883,15 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<p>Add classes to an <code>&lt;img&gt;</code> element to easily style images in any project. Rounded corners are not available in IE8.</p> <p>Add classes to an <code>&lt;img&gt;</code> element to easily style images in any project. Rounded corners are not available in IE8.</p>
<div class="bs-docs-example bs-docs-example-images"> <div class="bs-docs-example bs-docs-example-images">
<img data-src="holder.js/140x140" class="img-rounded" alt=""> <img data-src="holder.js/140x140" class="img-rounded">
<img data-src="holder.js/140x140" class="img-circle" alt=""> <img data-src="holder.js/140x140" class="img-circle">
<img data-src="holder.js/140x140" class="img-thumbnail" alt=""> <img data-src="holder.js/140x140" class="img-thumbnail">
</div> </div>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;img src="..." class="img-rounded" alt=""&gt; <img src="..." class="img-rounded">
&lt;img src="..." class="img-circle" alt=""&gt; <img src="..." class="img-circle">
&lt;img src="..." class="img-thumbnail" alt=""&gt; <img src="..." class="img-thumbnail">
</pre> {% endhighlight %}
</section> </section>
@ -2105,9 +2082,9 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<h2>How to use</h2> <h2>How to use</h2>
<p>Add the appropriate class to any inline element. All icon classes are prefixed with <code>glyphicon-</code> for easy styling. To use, place the following code just about anywhere:</p> <p>Add the appropriate class to any inline element. All icon classes are prefixed with <code>glyphicon-</code> for easy styling. To use, place the following code just about anywhere:</p>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;i class="glyphicon-search"&gt;&lt;/i&gt; <span class="glyphicon-search"></span>
</pre> {% endhighlight %}
<p>Want to change the icon color? Just change the <code>color</code> of the parent element.</p> <p>Want to change the icon color? Just change the <code>color</code> of the parent element.</p>
<p>When using beside strings of text, as in buttons or nav links, be sure to leave a space after the icon for proper spacing.</p> <p>When using beside strings of text, as in buttons or nav links, be sure to leave a space after the icon for proper spacing.</p>
@ -2121,87 +2098,86 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<div class="bs-docs-example"> <div class="bs-docs-example">
<div class="btn-toolbar"> <div class="btn-toolbar">
<div class="btn-group"> <div class="btn-group">
<a class="btn" href="#"><i class="glyphicon-align-left"></i></a> <a class="btn" href="#"><span class="glyphicon-align-left"></span></a>
<a class="btn" href="#"><i class="glyphicon-align-center"></i></a> <a class="btn" href="#"><span class="glyphicon-align-center"></span></a>
<a class="btn" href="#"><i class="glyphicon-align-right"></i></a> <a class="btn" href="#"><span class="glyphicon-align-right"></span></a>
<a class="btn" href="#"><i class="glyphicon-align-justify"></i></a> <a class="btn" href="#"><span class="glyphicon-align-justify"></span></a>
</div> </div>
</div> </div>
</div> </div><!-- /bs-docs-example -->
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;div class="btn-toolbar"&gt; <div class="btn-toolbar">
&lt;div class="btn-group"&gt; <div class="btn-group">
<a class="btn" href="#"><span class="glyphicon-align-left"></span></a>
&lt;a class="btn" href="#"&gt;&lt;i class="glyphicon-align-left"&gt;&lt;/i&gt;&lt;/a&gt; <a class="btn" href="#"><span class="glyphicon-align-center"></span></a>
&lt;a class="btn" href="#"&gt;&lt;i class="glyphicon-align-center"&gt;&lt;/i&gt;&lt;/a&gt; <a class="btn" href="#"><span class="glyphicon-align-right"></span></a>
&lt;a class="btn" href="#"&gt;&lt;i class="glyphicon-align-right"&gt;&lt;/i&gt;&lt;/a&gt; <a class="btn" href="#"><span class="glyphicon-align-justify"></span></a>
&lt;a class="btn" href="#"&gt;&lt;i class="glyphicon-align-justify"&gt;&lt;/i&gt;&lt;/a&gt; </div>
&lt;/div&gt; </div>
&lt;/div&gt; {% endhighlight %}
</pre>
<h5>Dropdown in a button group</h5> <h5>Dropdown in a button group</h5>
<div class="bs-docs-example"> <div class="bs-docs-example">
<div class="btn-group"> <div class="btn-group">
<a class="btn btn-primary" href="#"><i class="glyphicon-user icon-white"></i> User</a> <a class="btn btn-primary" href="#"><i class="glyphicon-user"></i> User</a>
<a class="btn btn-primary dropdown-toggle" data-toggle="dropdown" href="#"><span class="caret"></span></a> <a class="btn btn-primary dropdown-toggle" data-toggle="dropdown" href="#"><span class="caret"></span></a>
<ul class="dropdown-menu"> <ul class="dropdown-menu">
<li><a href="#"><i class="glyphicon-pencil"></i> Edit</a></li> <li><a href="#"><i class="glyphicon-pencil"></i> Edit</a></li>
<li><a href="#"><i class="glyphicon-trash"></i> Delete</a></li> <li><a href="#"><i class="glyphicon-trash"></i> Delete</a></li>
<li><a href="#"><i class="glyphicon-ban-circle"></i> Ban</a></li> <li><a href="#"><i class="glyphicon-ban-circle"></i> Ban</a></li>
<li class="divider"></li> <li class="divider"></li>
<li><a href="#"><i class="i"></i> Make admin</a></li> <li><a href="#"><i class="glyphicon-"></i> Make admin</a></li>
</ul> </ul>
</div> </div>
</div> </div><!-- /bs-docs-example -->
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;div class="btn-group"&gt; <div class="btn-group">
&lt;a class="btn btn-primary" href="#"&gt;&lt;i class="glyphicon-user icon-white"&gt;&lt;/i&gt; User&lt;/a&gt; <a class="btn btn-primary" href="#"><span class="glyphicon-user"></span> User</a>
&lt;a class="btn btn-primary dropdown-toggle" data-toggle="dropdown" href="#"&gt;&lt;span class="caret"&gt;&lt;/span&gt;&lt;/a&gt; <a class="btn btn-primary dropdown-toggle" data-toggle="dropdown" href="#"><span class="caret"></span></a>
&lt;ul class="dropdown-menu"&gt; <ul class="dropdown-menu">
&lt;li&gt;&lt;a href="#"&gt;&lt;i class="glyphicon-pencil"&gt;&lt;/i&gt; Edit&lt;/a&gt;&lt;/li&gt; <li><a href="#"><span class="glyphicon-pencil"></span> Edit</a></li>
&lt;li&gt;&lt;a href="#"&gt;&lt;i class="glyphicon-trash"&gt;&lt;/i&gt; Delete&lt;/a&gt;&lt;/li&gt; <li><a href="#"><span class="glyphicon-trash"></span> Delete</a></li>
&lt;li&gt;&lt;a href="#"&gt;&lt;i class="glyphicon-ban-circle"&gt;&lt;/i&gt; Ban&lt;/a&gt;&lt;/li&gt; <li><a href="#"><span class="glyphicon-ban-circle"></span> Ban</a></li>
&lt;li class="divider"&gt;&lt;/li&gt; <li class="divider"></li>
&lt;li&gt;&lt;a href="#"&gt;&lt;i class="i"&gt;&lt;/i&gt; Make admin&lt;/a&gt;&lt;/li&gt; <li><a href="#"><span class="glyphicon-"></span> Make admin</a></li>
&lt;/ul&gt; </ul>
&lt;/div&gt; </div>
</pre> {% endhighlight %}
<h5>Large button</h5> <h5>Large button</h5>
<div class="bs-docs-example"> <div class="bs-docs-example">
<a class="btn btn-large" href="#"><i class="glyphicon-star"></i> Star</a> <a class="btn btn-large" href="#"><span class="glyphicon-star"></span> Star</a>
</div> </div><!-- /bs-docs-example -->
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;a class="btn btn-large" href="#"&gt;&lt;i class="glyphicon-star"&gt;&lt;/i&gt; Star&lt;/a&gt; <a class="btn btn-large" href="#"><span class="glyphicon-star"></span> Star</a>
</pre> {% endhighlight %}
<h5>Small button</h5> <h5>Small button</h5>
<div class="bs-docs-example"> <div class="bs-docs-example">
<a class="btn btn-small" href="#"><i class="glyphicon-star"></i></a> <a class="btn btn-small" href="#"><span class="glyphicon-star"></span></a>
</div> </div><!-- /bs-docs-example -->
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;a class="btn btn-small" href="#"&gt;&lt;i class="glyphicon-star"&gt;&lt;/i&gt;&lt;/a&gt; <a class="btn btn-small" href="#"><span class="glyphicon-star"></span></a>
</pre> {% endhighlight %}
<h4>Navigation</h4> <h4>Navigation</h4>
<div class="bs-docs-example"> <div class="bs-docs-example">
<ul class="nav nav-list"> <ul class="nav nav-list">
<li class="active"><a href="#"><i class="glyphicon-home icon-white"></i> Home</a></li> <li class="active"><a href="#"><span class="glyphicon-home"></span> Home</a></li>
<li><a href="#"><i class="glyphicon-book"></i> Library</a></li> <li><a href="#"><span class="glyphicon-book"></span> Library</a></li>
<li><a href="#"><i class="glyphicon-pencil"></i> Applications</a></li> <li><a href="#"><span class="glyphicon-pencil"></span> Applications</a></li>
<li><a href="#"><i class="i"></i> Misc</a></li> <li><a href="#"><span class="glyphicon-"></span> Misc</a></li>
</ul> </ul>
</div> </div><!-- /bs-docs-example -->
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;ul class="nav nav-list"&gt; <ul class="nav nav-list">
&lt;li class="active"&gt;&lt;a href="#"&gt;&lt;i class="glyphicon-home icon-white"&gt;&lt;/i&gt; Home&lt;/a&gt;&lt;/li&gt; <li class="active"><a href="#"><span class="glyphicon-home"></span> Home</a></li>
&lt;li&gt;&lt;a href="#"&gt;&lt;i class="glyphicon-book"&gt;&lt;/i&gt; Library&lt;/a&gt;&lt;/li&gt; <li><a href="#"><span class="glyphicon-book"></span> Library</a></li>
&lt;li&gt;&lt;a href="#"&gt;&lt;i class="glyphicon-pencil"&gt;&lt;/i&gt; Applications&lt;/a&gt;&lt;/li&gt; <li><a href="#"><span class="glyphicon-pencil"></span> Applications</a></li>
&lt;li&gt;&lt;a href="#"&gt;&lt;i class="i"&gt;&lt;/i&gt; Misc&lt;/a&gt;&lt;/li&gt; <li><a href="#"><span class="glyphicon-"></span> Misc</a></li>
&lt;/ul&gt; </ul>
</pre> {% endhighlight %}
<h4>Form fields</h4> <h4>Form fields</h4>
<form class="bs-docs-example form-horizontal"> <form class="bs-docs-example form-horizontal">
@ -2209,23 +2185,23 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
<label class="control-label" for="inputIcon">Email address</label> <label class="control-label" for="inputIcon">Email address</label>
<div class="controls"> <div class="controls">
<div class="input-group"> <div class="input-group">
<span class="input-group-addon"><i class="glyphicon-envelope"></i></span> <span class="input-group-addon"><span class="glyphicon-envelope"></span></span>
<input class="span2" id="inputIcon" type="text"> <input class="span2" id="inputIcon" type="text">
</div> </div>
</div> </div>
</div> </div>
</form> </form>
<pre class="prettyprint linenums"> {% highlight html linenos %}
&lt;div class="control-group"&gt; <div class="control-group">
&lt;label class="control-label" for="inputIcon"&gt;Email address&lt;/label&gt; <label class="control-label" for="inputIcon">Email address</label>
&lt;div class="controls"&gt; <div class="controls">
&lt;div class="input-group"&gt; <div class="input-group">
&lt;span class="input-group-addon"&gt;&lt;i class="glyphicon-envelope"&gt;&lt;/i&gt;&lt;/span&gt; <span class="input-group-addon"><span class="glyphicon-envelope"></span></span>
&lt;input class="span2" id="inputIcon" type="text"&gt; <input class="span2" id="inputIcon" type="text">
&lt;/div&gt; </div>
&lt;/div&gt; </div>
&lt;/div&gt; </div>
</pre> {% endhighlight %}
</section> </section>
@ -2312,75 +2288,7 @@ For example, &lt;code&gt;&amp;lt;section&amp;gt;&lt;/code&gt; should be wrapped
</div> </div><!-- /span9 -->
</div> </div><!-- row -->
</div> </div><!-- /.container -->
<!-- Footer
================================================== -->
<footer class="footer">
<div class="container">
<div class="bs-docs-social">
<ul class="bs-docs-social-buttons">
<li>
<iframe class="github-btn" src="http://ghbtns.com/github-btn.html?user=twitter&repo=bootstrap&type=watch&count=true" allowtransparency="true" frameborder="0" scrolling="0" width="100px" height="20px"></iframe>
</li>
<li>
<iframe class="github-btn" src="http://ghbtns.com/github-btn.html?user=twitter&repo=bootstrap&type=fork&count=true" allowtransparency="true" frameborder="0" scrolling="0" width="102px" height="20px"></iframe>
</li>
<li class="follow-btn">
<a href="https://twitter.com/twbootstrap" class="twitter-follow-button" data-link-color="#0069D6" data-show-count="true">Follow @twbootstrap</a>
</li>
<li class="tweet-btn">
<a href="https://twitter.com/share" class="twitter-share-button" data-url="http://twitter.github.com/bootstrap/" data-count="horizontal" data-via="twbootstrap" data-related="mdo:Creator of Twitter Bootstrap">Tweet</a>
</li>
</ul>
</div>
<p>Designed and built with all the love in the world by <a href="http://twitter.com/mdo" target="_blank">@mdo</a> and <a href="http://twitter.com/fat" target="_blank">@fat</a>.</p>
<p>Code licensed under <a href="http://www.apache.org/licenses/LICENSE-2.0" target="_blank">Apache License v2.0</a>, documentation under <a href="http://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a>.</p>
<p><a href="http://glyphicons.com">Glyphicons Free</a> licensed under <a href="http://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a>.</p>
<ul class="footer-links">
<li><a href="http://blog.getbootstrap.com">Blog</a></li>
<li class="muted">&middot;</li>
<li><a href="https://github.com/twitter/bootstrap/issues?state=open">Issues</a></li>
<li class="muted">&middot;</li>
<li><a href="https://github.com/twitter/bootstrap/blob/master/CHANGELOG.md">Changelog</a></li>
</ul>
</div>
</footer>
<!-- Bootstrap core JavaScript
================================================== -->
<!-- Placed at the end of the document so the pages load faster -->
<script src="assets/js/jquery.js"></script>
<script src="assets/js/bootstrap-transition.js"></script>
<script src="assets/js/bootstrap-alert.js"></script>
<script src="assets/js/bootstrap-modal.js"></script>
<script src="assets/js/bootstrap-dropdown.js"></script>
<script src="assets/js/bootstrap-scrollspy.js"></script>
<script src="assets/js/bootstrap-tab.js"></script>
<script src="assets/js/bootstrap-tooltip.js"></script>
<script src="assets/js/bootstrap-popover.js"></script>
<script src="assets/js/bootstrap-button.js"></script>
<script src="assets/js/bootstrap-collapse.js"></script>
<script src="assets/js/bootstrap-carousel.js"></script>
<script src="assets/js/bootstrap-typeahead.js"></script>
<script src="assets/js/bootstrap-affix.js"></script>
<script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script>
<script src="assets/js/holder/holder.js"></script>
<script src="assets/js/google-code-prettify/prettify.js"></script>
<script src="assets/js/application.js"></script>
</body>
</html>