From a12f0e551f7da763a9be23013d1b51c161a0f6f8 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Thu, 12 Jul 2012 18:11:49 -0700 Subject: [PATCH] overhaul docs on sub pages, clean up css and copy --- docs/assets/css/docs.css | 42 +- docs/base-css.html | 2197 +++++++------- docs/components.html | 2662 ++++++++-------- docs/download.html | 4 - docs/examples.html | 4 - docs/extend.html | 147 +- docs/getting-started.html | 8 +- docs/index.html | 7 +- docs/javascript.html | 2379 +++++++-------- docs/scaffolding.html | 702 ++--- docs/templates/layout.mustache | 4 - docs/templates/pages/base-css.mustache | 2213 +++++++------- docs/templates/pages/components.mustache | 2672 ++++++++--------- docs/templates/pages/extend.mustache | 145 +- docs/templates/pages/getting-started.mustache | 4 + docs/templates/pages/index.mustache | 5 +- docs/templates/pages/javascript.mustache | 2427 +++++++-------- docs/templates/pages/scaffolding.mustache | 708 ++--- docs/upgrading.html | 4 - 19 files changed, 8101 insertions(+), 8233 deletions(-) diff --git a/docs/assets/css/docs.css b/docs/assets/css/docs.css index ff6e37fe01..35eb7b83cb 100644 --- a/docs/assets/css/docs.css +++ b/docs/assets/css/docs.css @@ -12,12 +12,8 @@ body { position: relative; - padding-top: 80px; + padding-top: 40px; font-size: 14px; - background-color: #fff; - background-image: url(../img/grid-20px.png); - background-repeat: repeat-x; - background-position: 0 40px; } /* Code in headings */ @@ -87,7 +83,22 @@ hr.soften { ------------------------- */ .jumbotron { position: relative; + padding: 40px 0; + color: #fff; text-align: center; + text-shadow: 0 1px 5px rgba(0,0,0,.25), 0 0 30px rgba(0,0,0,.075); + background: #020031; /* Old browsers */ + background: -moz-linear-gradient(45deg, #020031 0%, #6d3353 100%); /* FF3.6+ */ + background: -webkit-gradient(linear, left bottom, right top, color-stop(0%,#020031), color-stop(100%,#6d3353)); /* Chrome,Safari4+ */ + background: -webkit-linear-gradient(45deg, #020031 0%,#6d3353 100%); /* Chrome10+,Safari5.1+ */ + background: -o-linear-gradient(45deg, #020031 0%,#6d3353 100%); /* Opera 11.10+ */ + background: -ms-linear-gradient(45deg, #020031 0%,#6d3353 100%); /* IE10+ */ + background: linear-gradient(45deg, #020031 0%,#6d3353 100%); /* W3C */ + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='#020031', endColorstr='#6d3353',GradientType=1 ); /* IE6-9 fallback on horizontal gradient */ + -webkit-box-shadow: inset 0 -1px 0 rgba(0,0,0,.15); + -moz-box-shadow: inset 0 -1px 0 rgba(0,0,0,.15); + box-shadow: inset 0 -1px 0 rgba(0,0,0,.15); + } .jumbotron h1 { font-size: 80px; @@ -118,22 +129,8 @@ hr.soften { ------------------------- */ .masthead { padding: 50px 0 60px; - margin-top: -40px; margin-bottom: 0; color: #fff; - text-align: center; - text-shadow: 0 1px 5px rgba(0,0,0,.25), 0 0 30px rgba(0,0,0,.075); - background: #020031; /* Old browsers */ - background: -moz-linear-gradient(45deg, #020031 0%, #6d3353 100%); /* FF3.6+ */ - background: -webkit-gradient(linear, left bottom, right top, color-stop(0%,#020031), color-stop(100%,#6d3353)); /* Chrome,Safari4+ */ - background: -webkit-linear-gradient(45deg, #020031 0%,#6d3353 100%); /* Chrome10+,Safari5.1+ */ - background: -o-linear-gradient(45deg, #020031 0%,#6d3353 100%); /* Opera 11.10+ */ - background: -ms-linear-gradient(45deg, #020031 0%,#6d3353 100%); /* IE10+ */ - background: linear-gradient(45deg, #020031 0%,#6d3353 100%); /* W3C */ - filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='#020031', endColorstr='#6d3353',GradientType=1 ); /* IE6-9 fallback on horizontal gradient */ - -webkit-box-shadow: inset 0 -1px 0 rgba(0,0,0,.15); - -moz-box-shadow: inset 0 -1px 0 rgba(0,0,0,.15); - box-shadow: inset 0 -1px 0 rgba(0,0,0,.15); } .masthead h1 { font-size: 120px; @@ -211,6 +208,9 @@ hr.soften { .subhead h1 { font-size: 60px; } +.subhead p { + margin-bottom: 10px; +} .subhead .navbar { display: none; } @@ -736,7 +736,7 @@ form.bs-docs-example { padding-top: 0; } /* Widen masthead and social buttons to fill body padding */ - .masthead { + .jumbotron { margin-top: -20px; /* Offset bottom margin on .navbar */ } } @@ -750,7 +750,7 @@ form.bs-docs-example { } /* Widen masthead and social buttons to fill body padding */ - .masthead { + .jumbotron { padding: 40px 20px; margin-top: -20px; /* Offset bottom margin on .navbar */ margin-right: -20px; diff --git a/docs/base-css.html b/docs/base-css.html index b829dc3aef..fc04ea4c20 100644 --- a/docs/base-css.html +++ b/docs/base-css.html @@ -66,142 +66,143 @@ -
-
-

Base CSS

-

On top of the scaffolding, basic HTML elements are styled and enhanced with extensible classes to provide a fresh, consistent look and feel.

+
+

Base CSS

+

On top of the scaffolding, basic HTML elements are styled and enhanced with extensible classes.

+
+
- -
- -
+ +
+ +
- -
- + +
+ -

Headings

-

All HTML headings, <h1> through <h6> are available.

-
-

h1. Heading 1

-

h2. Heading 2

-

h3. Heading 3

-

h4. Heading 4

-
h5. Heading 5
-
h6. Heading 6
-
+

Headings

+

All HTML headings, <h1> through <h6> are available.

+
+

h1. Heading 1

+

h2. Heading 2

+

h3. Heading 3

+

h4. Heading 4

+
h5. Heading 5
+
h6. Heading 6
+
-

Body copy

-

Bootstrap's global default font-size is 14px, with a line-height of 20px. This is applied to the <body> and all paragraphs. In addition, <p> (paragraphs) receive a bottom margin of half their line-height (9px by default).

-
-

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.

-

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.

-

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.

-
+

Body copy

+

Bootstrap's global default font-size is 14px, with a line-height of 20px. This is applied to the <body> and all paragraphs. In addition, <p> (paragraphs) receive a bottom margin of half their line-height (9px by default).

+
+

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.

+

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.

+

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.

+
-

Lead body copy

-

Make a paragraph stand out by adding .lead.

-
-

Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus.

-
+

Lead body copy

+

Make a paragraph stand out by adding .lead.

+
+

Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus.

+
-

Built with Less

-

The typographic scale is based on two LESS variables in variables.less: @baseFontSize and @baseLineHeight. 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.

+

Built with Less

+

The typographic scale is based on two LESS variables in variables.less: @baseFontSize and @baseLineHeight. 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.

-
+
-

Emphasis

-

Make use of HTML's default emphasis tags, <strong> and <em>.

+

Emphasis

+

Make use of HTML's default emphasis tags, <strong> and <em>.

-

<strong>

-

For emphasizing a snippet of text with important

-
-

The following snippet of text is rendered as bold text.

-
+

<strong>

+

For emphasizing a snippet of text with important

+
+

The following snippet of text is rendered as bold text.

+
 <strong>rendered as bold text</strong>
 
-

<em>

-

For emphasizing a snippet of text with stress

-
-

The following snippet of text is rendered as italicized text.

-
-
-    <em>rendered as italicized text</em>
-    
+

<em>

+

For emphasizing a snippet of text with stress

+
+

The following snippet of text is rendered as italicized text.

+
+
+<em>rendered as italicized text</em>
+
-

Heads up! Feel free to use <b> and <i> in HTML5. <b> is meant to highlight words or phrases without conveying additional importance while <i> is mostly for voice, technical terms, etc.

+

Heads up! Feel free to use <b> and <i> in HTML5. <b> is meant to highlight words or phrases without conveying additional importance while <i> is mostly for voice, technical terms, etc.

-
+
-

Abbreviations

-

Stylized implemenation of HTML's <abbr> element for abbreviations and acronyms to show the expanded version on hover. Abbreviations with a title attribute have a light dotted bottom border and a help cursor on hover, providing additional context on hover.

+

Abbreviations

+

Stylized implemenation of HTML's <abbr> element for abbreviations and acronyms to show the expanded version on hover. Abbreviations with a title attribute have a light dotted bottom border and a help cursor on hover, providing additional context on hover.

-

<abbr>

-

For expanded text on long hover of an abbreviation, include the title attribute.

-
-

An abbreviation of the word attribute is attr.

-
+

<abbr>

+

For expanded text on long hover of an abbreviation, include the title attribute.

+
+

An abbreviation of the word attribute is attr.

+
 <abbr title="attribute">attr</abbr>
 
-

<abbr class="initialism">

-

Add .initialism to an abbreviation for a slightly smaller font-size.

-
-

HTML is the best thing since sliced bread.

-
+

<abbr class="initialism">

+

Add .initialism to an abbreviation for a slightly smaller font-size.

+
+

HTML is the best thing since sliced bread.

+
 <abbr title="attribute" class="initialism">attr</abbr>
 
-
+
-

Addresses

-

Present contact information for the nearest ancestor or the entire body of work.

+

Addresses

+

Present contact information for the nearest ancestor or the entire body of work.

-

<address>

-

Preserve formatting by ending all lines with <br>.

-
-
- Twitter, Inc.
- 795 Folsom Ave, Suite 600
- San Francisco, CA 94107
- P: (123) 456-7890 -
-
- Full Name
- first.last@gmail.com -
-
+

<address>

+

Preserve formatting by ending all lines with <br>.

+
+
+ Twitter, Inc.
+ 795 Folsom Ave, Suite 600
+ San Francisco, CA 94107
+ P: (123) 456-7890 +
+
+ Full Name
+ first.last@gmail.com +
+
 <address>
   <strong>Twitter, Inc.</strong><br>
@@ -217,36 +218,36 @@
 
-
+
-

Blockquotes

-

For quoting blocks of content from another source within your document.

+

Blockquotes

+

For quoting blocks of content from another source within your document.

-

Default blockqoute

-

Wrap <blockquote> around any HTML as the quote. For straight quotes we recommend a <p>.

-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

-
-
+

Default blockqoute

+

Wrap <blockquote> around any HTML as the quote. For straight quotes we recommend a <p>.

+
+
+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

+
+
 <blockquote>
   <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
 </blockquote>
 
-

Blockquote options

-

Style and content changes for simple variations on a standard blockquote.

+

Blockquote options

+

Style and content changes for simple variations on a standard blockquote.

-

Naming a source

-

Add <small> tag for identifying the source. Wrap the name of the source work in <cite>.

-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

- Someone famous in Source Title -
-
+

Naming a source

+

Add <small> tag for identifying the source. Wrap the name of the source work in <cite>.

+
+
+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

+ Someone famous in Source Title +
+
 <blockquote>
   <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
@@ -254,14 +255,14 @@
 </blockquote>
 
-

Alternate displays

-

Use .pull-left and .pull-right classes for floated, right-aligned blockquote content.

-
-
-

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

- Someone famous in Source Title -
-
+

Alternate displays

+

Use .pull-left and .pull-right classes for floated, right-aligned blockquote content.

+
+
+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

+ Someone famous in Source Title +
+
 <blockquote class="pull-right">
   <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
@@ -270,16 +271,63 @@
 
-
+
- -

Lists

+ +

Lists

-

Unordered

-

A list of items in which the order does not explicitly matter.

+

Unordered

+

A list of items in which the order does not explicitly matter.

+
+
    +
  • Lorem ipsum dolor sit amet
  • +
  • Consectetur adipiscing elit
  • +
  • Integer molestie lorem at massa
  • +
  • Facilisis in pretium nisl aliquet
  • +
  • Nulla volutpat aliquam velit +
      +
    • Phasellus iaculis neque
    • +
    • Purus sodales ultricies
    • +
    • Vestibulum laoreet porttitor sem
    • +
    • Ac tristique libero volutpat at
    • +
    +
  • +
  • Faucibus porta lacus fringilla vel
  • +
  • Aenean sit amet erat nunc
  • +
  • Eget porttitor lorem
  • +
+
+
+<ul>
+  <li>...</li>
+</ul>
+
+ +

Ordered

+

A list of items in which the order does explicitly matter.

+
+
    +
  1. Lorem ipsum dolor sit amet
  2. +
  3. Consectetur adipiscing elit
  4. +
  5. Integer molestie lorem at massa
  6. +
  7. Facilisis in pretium nisl aliquet
  8. +
  9. Nulla volutpat aliquam velit
  10. +
  11. Faucibus porta lacus fringilla vel
  12. +
  13. Aenean sit amet erat nunc
  14. +
  15. Eget porttitor lorem
  16. +
+
+
+<ol>
+  <li>...</li>
+</ol>
+
+ +

Unstyled

+

A list of items with no list-style or additional left padding.

-
    +
    • Lorem ipsum dolor sit amet
    • Consectetur adipiscing elit
    • Integer molestie lorem at massa
    • @@ -298,71 +346,24 @@
-<ul>
-  <li>...</li>
-</ul>
-
- -

Ordered

-

A list of items in which the order does explicitly matter.

-
-
    -
  1. Lorem ipsum dolor sit amet
  2. -
  3. Consectetur adipiscing elit
  4. -
  5. Integer molestie lorem at massa
  6. -
  7. Facilisis in pretium nisl aliquet
  8. -
  9. Nulla volutpat aliquam velit
  10. -
  11. Faucibus porta lacus fringilla vel
  12. -
  13. Aenean sit amet erat nunc
  14. -
  15. Eget porttitor lorem
  16. -
-
-
-<ol>
-  <li>...</li>
-</ol>
-
- -

Unstyled

-

A list of items with no list-style or additional left padding.

-
-
    -
  • Lorem ipsum dolor sit amet
  • -
  • Consectetur adipiscing elit
  • -
  • Integer molestie lorem at massa
  • -
  • Facilisis in pretium nisl aliquet
  • -
  • Nulla volutpat aliquam velit -
      -
    • Phasellus iaculis neque
    • -
    • Purus sodales ultricies
    • -
    • Vestibulum laoreet porttitor sem
    • -
    • Ac tristique libero volutpat at
    • -
    -
  • -
  • Faucibus porta lacus fringilla vel
  • -
  • Aenean sit amet erat nunc
  • -
  • Eget porttitor lorem
  • -
-
-
 <ul class="unstyled">
   <li>...</li>
 </ul>
 
-

Description

-

A list of terms with their associated descriptions.

-
-
-
Description lists
-
A description list is perfect for defining terms.
-
Euismod
-
Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.
-
Donec id elit non mi porta gravida at eget metus.
-
Malesuada porta
-
Etiam porta sem malesuada magna mollis euismod.
-
-
+

Description

+

A list of terms with their associated descriptions.

+
+
+
Description lists
+
A description list is perfect for defining terms.
+
Euismod
+
Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.
+
Donec id elit non mi porta gravida at eget metus.
+
Malesuada porta
+
Etiam porta sem malesuada magna mollis euismod.
+
+
 <dl>
   <dt>...</dt>
@@ -370,50 +371,50 @@
 </dl>
 
-

Horizontal description

-

Make terms and descriptions in <dl> line up side-by-side.

-
-
-
Description lists
-
A description list is perfect for defining terms.
-
Euismod
-
Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.
-
Donec id elit non mi porta gravida at eget metus.
-
Malesuada porta
-
Etiam porta sem malesuada magna mollis euismod.
-
Felis euismod semper eget lacinia
-
Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.
-
-
+

Horizontal description

+

Make terms and descriptions in <dl> line up side-by-side.

+
+
+
Description lists
+
A description list is perfect for defining terms.
+
Euismod
+
Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.
+
Donec id elit non mi porta gravida at eget metus.
+
Malesuada porta
+
Etiam porta sem malesuada magna mollis euismod.
+
Felis euismod semper eget lacinia
+
Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.
+
+
 <dl class="dl-horizontal">
   <dt>...</dt>
   <dd>...</dd>
 </dl>
 
-

- Heads up! - Horizontal description lists will truncate terms that are too long to fit in the left column fix text-overflow. In narrower viewports, they will change to the default stacked layout. -

-
+

+ Heads up! + Horizontal description lists will truncate terms that are too long to fit in the left column fix text-overflow. In narrower viewports, they will change to the default stacked layout. +

+
- -
- + +
+ -

Inline

-

Wrap inline snippets of code with <code>.

+

Inline

+

Wrap inline snippets of code with <code>.

 For example, <code>section</code> should be wrapped as inline.
 
-

Basic block

-

Use <pre> for multiple lines of code. Be sure to escape any angle brackets in the code for proper rendering.

+

Basic block

+

Use <pre> for multiple lines of code. Be sure to escape any angle brackets in the code for proper rendering.

 <p>Sample text here...</p>
 
@@ -422,53 +423,53 @@ For example, <code>section</code> should be wrapped as inline. &lt;p&gt;Sample text here...&lt;/p&gt; </pre> -

Note: Be sure to keep code within <pre> tags as close to the left as possible; it will render all tabs.

-

You may optionally add the .pre-scrollable class which will set a max-height of 350px and provide a y-axis scrollbar.

-
+

Note: Be sure to keep code within <pre> tags as close to the left as possible; it will render all tabs.

+

You may optionally add the .pre-scrollable class which will set a max-height of 350px and provide a y-axis scrollbar.

+
- -
- + +
+ -

Default styles

-

For basic styling—light padding and only horizontal dividers—add the base class .table to any <table>.

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#First NameLast NameUsername
1MarkOtto@mdo
2JacobThornton@fat
3Larrythe Bird@twitter
-
+

Default styles

+

For basic styling—light padding and only horizontal dividers—add the base class .table to any <table>.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#First NameLast NameUsername
1MarkOtto@mdo
2JacobThornton@fat
3Larrythe Bird@twitter
+
 <table class="table">
   …
@@ -476,168 +477,168 @@ For example, <code>section</code> should be wrapped as inline.
 
-
+
-

Optional classes

-

Add any of the follow classes to the .table base class.

+

Optional classes

+

Add any of the follow classes to the .table base class.

-

.table-striped

-

Adds zebra-striping to any table row within the <tbody> via the :nth-child CSS selector (not available in IE7-IE8).

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#First NameLast NameUsername
1MarkOtto@mdo
2JacobThornton@fat
3Larrythe Bird@twitter
-
+

.table-striped

+

Adds zebra-striping to any table row within the <tbody> via the :nth-child CSS selector (not available in IE7-IE8).

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#First NameLast NameUsername
1MarkOtto@mdo
2JacobThornton@fat
3Larrythe Bird@twitter
+
 <table class="table table-striped">
   …
 </table>
 
-

.table-bordered

-

Add borders and rounded corners to the table.

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#First NameLast NameUsername
1MarkOtto@mdo
MarkOtto@TwBootstrap
2JacobThornton@fat
3Larry the Bird@twitter
-
+

.table-bordered

+

Add borders and rounded corners to the table.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#First NameLast NameUsername
1MarkOtto@mdo
MarkOtto@TwBootstrap
2JacobThornton@fat
3Larry the Bird@twitter
+
 <table class="table table-bordered">
   …
 </table>
 
-

.table-hover

-

Enable a hover state on table rows within a <tbody>.

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#First NameLast NameUsername
1MarkOtto@mdo
2JacobThornton@fat
3Larry the Bird@twitter
-
+

.table-hover

+

Enable a hover state on table rows within a <tbody>.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#First NameLast NameUsername
1MarkOtto@mdo
2JacobThornton@fat
3Larry the Bird@twitter
+
 <table class="table table-hover">
   …
 </table>
 
-

.table-condensed

-

Makes tables more compact by cutting cell padding in half.

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - -
#First NameLast NameUsername
1MarkOtto@mdo
2JacobThornton@fat
3Larry the Bird@twitter
-
+

.table-condensed

+

Makes tables more compact by cutting cell padding in half.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
#First NameLast NameUsername
1MarkOtto@mdo
2JacobThornton@fat
3Larry the Bird@twitter
+
 <table class="table table-condensed">
   …
@@ -645,82 +646,82 @@ For example, <code>section</code> should be wrapped as inline.
 
-
+
-

Supported table markup

-

List of supported table HTML elements and how they should be used.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
TagDescription
- <table> - - Wrapping element for displaying data in a tabular format -
- <thead> - - Container element for table header rows (<tr>) to label table columns -
- <tbody> - - Container element for table rows (<tr>) in the body of the table -
- <tr> - - Container element for a set of table cells (<td> or <th>) that appears on a single row -
- <td> - - Default table cell -
- <th> - - Special table cell for column (or row, depending on scope and placement) labels
- Must be used within a <thead> -
- <caption> - - Description or summary of what the table holds, especially useful for screen readers -
+

Supported table markup

+

List of supported table HTML elements and how they should be used.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
TagDescription
+ <table> + + Wrapping element for displaying data in a tabular format +
+ <thead> + + Container element for table header rows (<tr>) to label table columns +
+ <tbody> + + Container element for table rows (<tr>) in the body of the table +
+ <tr> + + Container element for a set of table cells (<td> or <th>) that appears on a single row +
+ <td> + + Default table cell +
+ <th> + + Special table cell for column (or row, depending on scope and placement) labels
+ Must be used within a <thead> +
+ <caption> + + Description or summary of what the table holds, especially useful for screen readers +
 <table>
   <thead>
@@ -738,29 +739,29 @@ For example, <code>section</code> should be wrapped as inline.
 </table>
 
-
+
- -
- + +
+ -

Default styles

-

Individual form controls receive styling, but without any required base class on the <form> or large changes in markup. Results in stacked, left-aligned labels on top of form controls.

-
- Legend - - -

Example block-level help text here.

- - -
+

Default styles

+

Individual form controls receive styling, but without any required base class on the <form> or large changes in markup. Results in stacked, left-aligned labels on top of form controls.

+
+ Legend + + +

Example block-level help text here.

+ + +
 <form class="well">
   <label>Label name</label>
@@ -774,18 +775,18 @@ For example, <code>section</code> should be wrapped as inline.
 
-
+
-

Optional layouts

-

Included with Bootstrap are three optional form layouts for common use cases.

+

Optional layouts

+

Included with Bootstrap are three optional form layouts for common use cases.

-

Search form

-

Add .form-search to the form and .search-query to the <input> for an extra-rounded text input.

- +

Search form

+

Add .form-search to the form and .search-query to the <input> for an extra-rounded text input.

+
 <form class="form-search">
   <input type="text" class="input-medium search-query">
@@ -793,16 +794,16 @@ For example, <code>section</code> should be wrapped as inline.
 </form>
 
-

Inline form

-

Add .form-inline for left-aligned labels and inline-block controls for a compact layout.

-
- - - - -
+

Inline form

+

Add .form-inline for left-aligned labels and inline-block controls for a compact layout.

+
+ + + + +
 <form class="form-inline">
   <input type="text" class="input-small" placeholder="Email">
@@ -814,37 +815,37 @@ For example, <code>section</code> should be wrapped as inline.
 </form>
 
-

Horizontal form

-

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:

-
    -
  • Add .form-horizontal to the form
  • -
  • Wrap labels and controls in .control-group
  • -
  • Add .control-label to the label
  • -
  • Wrap any associated controls in .controls for proper alignment
  • -
-
- Legend -
- -
- +

Horizontal form

+

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:

+
    +
  • Add .form-horizontal to the form
  • +
  • Wrap labels and controls in .control-group
  • +
  • Add .control-label to the label
  • +
  • Wrap any associated controls in .controls for proper alignment
  • +
+ + Legend +
+ +
+ +
-
-
- -
- +
+ +
+ +
-
-
-
- - +
+
+ + +
-
- +
 <form class="form-horizontal">
   <div class="control-group">
@@ -871,49 +872,49 @@ For example, <code>section</code> should be wrapped as inline.
 
-
+
-

Supported form controls

-

Examples of standard form controls supported in an example form layout.

+

Supported form controls

+

Examples of standard form controls supported in an example form layout.

-

Inputs

-

Most common form control, text-based input fields. Includes support for all HTML5 types: text, password, datetime, datetime-local, date, month, time, week, number, email, url, search, tel, and color.

-

Requires the use of a specified type at all times.

-
- -
+

Inputs

+

Most common form control, text-based input fields. Includes support for all HTML5 types: text, password, datetime, datetime-local, date, month, time, week, number, email, url, search, tel, and color.

+

Requires the use of a specified type at all times.

+
+ +
 <input type="text" placeholder="Text input">
 
-

Textarea

-

Form control which supports multiple lines of text. Change row attribute as necessary.

-
- -
+

Textarea

+

Form control which supports multiple lines of text. Change row attribute as necessary.

+
+ +
 <textarea id="textarea" rows="3"></textarea>
 
-

Checkboxes and radios

-

Checkboxes are for selecting one or several options in a list while radios are for selecting one option from many.

-

Default (stacked)

-
- -
- - -
+

Checkboxes and radios

+

Checkboxes are for selecting one or several options in a list while radios are for selecting one option from many.

+

Default (stacked)

+
+ +
+ + +
 <label class="checkbox">
   <input type="checkbox" value="">
@@ -930,19 +931,19 @@ For example, <code>section</code> should be wrapped as inline.
 </label>
 
-

Inline checkboxes

-

Add the .inline class to a series of checkboxes or radios for controls appear on the same line.

-
- - - -
+

Inline checkboxes

+

Add the .inline class to a series of checkboxes or radios for controls appear on the same line.

+
+ + + +
 <label class="checkbox inline">
   <input type="checkbox" id="inlineCheckbox1" value="option1"> 1
@@ -955,25 +956,25 @@ For example, <code>section</code> should be wrapped as inline.
 </label>
 
-

Selects

-

Use the default option or specify a multiple="multiple" to show multiple options at once.

-
- -
- -
+

Selects

+

Use the default option or specify a multiple="multiple" to show multiple options at once.

+
+ +
+ +
 <select>
   <option>something</option>
@@ -993,28 +994,28 @@ For example, <code>section</code> should be wrapped as inline.
 
-
+
-

Extending form controls

-

Adding on top of existing browser controls, Bootstrap includes other useful form components.

+

Extending form controls

+

Adding on top of existing browser controls, Bootstrap includes other useful form components.

-

Prepended and appended inputs

-

Add text or buttons before or after any text-based input. Do note that select elements are not supported here.

+

Prepended and appended inputs

+

Add text or buttons before or after any text-based input. Do note that select elements are not supported here.

-

Default options

-

Wrap a .add-on and an input with one of two classes to prepend or append text to an input.

-
-
- @ - -
-
-
- - .00 -
-
+

Default options

+

Wrap a .add-on and an input with one of two classes to prepend or append text to an input.

+
+
+ @ + +
+
+
+ + .00 +
+
 <div class="input-prepend">
   <span class="add-on">@</span><input class="span2" id="prependedInput" size="16" type="text" placeholder="Username">
@@ -1024,35 +1025,35 @@ For example, <code>section</code> should be wrapped as inline.
 </div>
 
-

Combined

-

Use both classes and two instances of .add-on to prepend and append an input.

-
-
- $ - - .00 -
-
+

Combined

+

Use both classes and two instances of .add-on to prepend and append an input.

+
+
+ $ + + .00 +
+
 <div class="input-prepend input-append">
   <span class="add-on">$</span><input class="span2" id="appendedPrependedInput" size="16" type="text"><span class="add-on">.00</span>
 </div>
 
-

Buttons instead of text

-

Instead of a <span> with text, use a .btn to attach a button (or two) to an input.

-
-
- - -
-
-
- - - -
-
+

Buttons instead of text

+

Instead of a <span> with text, use a .btn to attach a button (or two) to an input.

+
+
+ + +
+
+
+ + + +
+
 <div class="input-append">
   <input class="span2" id="appendedInputButton" size="16" type="text"><button class="btn" type="button">Go!</button>
@@ -1063,17 +1064,17 @@ For example, <code>section</code> should be wrapped as inline.
 </div>
 
-

Search form

- +

Search form

+
 <form class="form-search">
   <input type="text" class="span2 search-query">
@@ -1081,20 +1082,20 @@ For example, <code>section</code> should be wrapped as inline.
 </form>
 
-

Control sizing

-

Use relative sizing classes like .input-large or match your inputs to the grid column sizes using .span* classes.

+

Control sizing

+

Use relative sizing classes like .input-large or match your inputs to the grid column sizes using .span* classes.

-

Relative sizing

-
-
- - - - - - -
-
+

Relative sizing

+
+
+ + + + + + +
+
 <input class="input-mini" type="text">
 <input class="input-small" type="text">
@@ -1103,68 +1104,68 @@ For example, <code>section</code> should be wrapped as inline.
 <input class="input-xlarge" type="text">
 <input class="input-xxlarge" type="text">
 
-

- Heads up! In future versions, we'll be altering the use of these relative input classes to match our button sizes. For example, .input-large will increase the padding and font-size of an input. -

+

+ Heads up! In future versions, we'll be altering the use of these relative input classes to match our button sizes. For example, .input-large will increase the padding and font-size of an input. +

-

Grid sizing

-

Use .span1 to .span12 for inputs that match the same sizes of the grid columns.

-
-
- - - - - - -
-
+

Grid sizing

+

Use .span1 to .span12 for inputs that match the same sizes of the grid columns.

+
+
+ + + + + + +
+
 <input class="span1" type="text">
 <input class="span2" type="text">
 <input class="span3" type="text">
 
-

For multiple grid inputs per line, use the .controls-row modifier class for proper spacing. It floats the inputs to collapse white-space, sets the proper margins, and the clears the float.

-
-
- -
-
- - -
-
- - -
-
- - -
-
- - -
-
+

For multiple grid inputs per line, use the .controls-row modifier class for proper spacing. It floats the inputs to collapse white-space, sets the proper margins, and the clears the float.

+
+
+ +
+
+ + +
+
+ + +
+
+ + +
+
+ + +
+
 <div class="controls controls-row">
   <input class="span4" type="text" placeholder=".span4">
@@ -1172,23 +1173,23 @@ For example, <code>section</code> should be wrapped as inline.
 </div>
 
-

Uneditable inputs

-

Present data in a form that's not editable without using actual form markup.

-
- Some value here -
+

Uneditable inputs

+

Present data in a form that's not editable without using actual form markup.

+
+ Some value here +
   <span class="input-xlarge uneditable-input">Some value here</span>
 
-

Form actions

-

End a form with a group of actions (buttons). When placed within a .form-horizontal, the buttons will automatically indent to line up with the form controls.

-
-
- - -
-
+

Form actions

+

End a form with a group of actions (buttons). When placed within a .form-horizontal, the buttons will automatically indent to line up with the form controls.

+
+
+ + +
+
 <div class="form-actions">
   <button type="submit" class="btn btn-primary">Save changes</button>
@@ -1196,76 +1197,76 @@ For example, <code>section</code> should be wrapped as inline.
 </div>
 
-

Help text

-

Inline and block level support for help text that appears around form controls.

-

Inline help

-
- Inline help text -
+

Help text

+

Inline and block level support for help text that appears around form controls.

+

Inline help

+
+ Inline help text +
 <span class="help-inline">Inline help text</span>
 
-

Block help

-
- - A longer block of help text that breaks onto a new line and may extend beyond one line. -
+

Block help

+
+ + A longer block of help text that breaks onto a new line and may extend beyond one line. +
 <span class="help-block">A longer block of help text that breaks onto a new line and may extend beyond one line.</span>
 
-
+
-

Form control states

-

Provide feedback to users or visitors with basic feedback states on form controls and labels.

+

Form control states

+

Provide feedback to users or visitors with basic feedback states on form controls and labels.

-

Input focus

-

We remove the default outline styles on some form controls and apply a box-shadow in its place for :focus.

-
- -
+

Input focus

+

We remove the default outline styles on some form controls and apply a box-shadow in its place for :focus.

+
+ +
 <input class="input-xlarge" id="focusedInput" type="text" value="This is focused...">
 
-

Disabled inputs

-

Add the disabled attribute on an input to prevent user input and trigger a slightly different look.

-
- -
+

Disabled inputs

+

Add the disabled attribute on an input to prevent user input and trigger a slightly different look.

+
+ +
 <input class="input-xlarge" id="disabledInput" type="text" placeholder="Disabled input here..." disabled>
 
-

Validation states

-

Bootstrap includes validation styles for error, warning, and success messages. To use, add the appropriate class to the surrounding .control-group.

+

Validation states

+

Bootstrap includes validation styles for error, warning, and success messages. To use, add the appropriate class to the surrounding .control-group.

-
-
- -
- - Something may have gone wrong + +
+ +
+ + Something may have gone wrong +
-
-
- -
- - Please correct the error +
+ +
+ + Please correct the error +
-
-
- -
- - Woohoo! +
+ +
+ + Woohoo! +
-
- +
 <div class="control-group warning">
   <label class="control-label" for="inputWarning">Input with warning</label>
@@ -1290,133 +1291,133 @@ For example, <code>section</code> should be wrapped as inline.
 </div>
 
-
+
- -
- + +
+ -

Default buttons

-

Button styles can be applied to anything with the .btn class applied. However, typically you'll want to apply these to only <a> and <button> elements for the best rendering.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Buttonclass=""Description
btnStandard gray button with gradient
btn btn-primaryProvides extra visual weight and identifies the primary action in a set of buttons
btn btn-infoUsed as an alternative to the default styles
btn btn-successIndicates a successful or positive action
btn btn-warningIndicates caution should be taken with this action
btn btn-dangerIndicates a dangerous or potentially negative action
btn btn-inverseAlternate dark gray button, not tied to a semantic action or use
+

Default buttons

+

Button styles can be applied to anything with the .btn class applied. However, typically you'll want to apply these to only <a> and <button> elements for the best rendering.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Buttonclass=""Description
btnStandard gray button with gradient
btn btn-primaryProvides extra visual weight and identifies the primary action in a set of buttons
btn btn-infoUsed as an alternative to the default styles
btn btn-successIndicates a successful or positive action
btn btn-warningIndicates caution should be taken with this action
btn btn-dangerIndicates a dangerous or potentially negative action
btn btn-inverseAlternate dark gray button, not tied to a semantic action or use
-

Cross browser compatibility

-

IE9 doesn't crop background gradients on rounded corners, so we remove it. Related, IE9 jankifies disabled button elements, rendering text gray with a nasty text-shadow that we cannot fix.

+

Cross browser compatibility

+

IE9 doesn't crop background gradients on rounded corners, so we remove it. Related, IE9 jankifies disabled button elements, rendering text gray with a nasty text-shadow that we cannot fix.

-
+
-

Button sizes

-

Fancy larger or smaller buttons? Add .btn-large, .btn-small, or .btn-mini for two additional sizes.

-

- - -

-

- - -

-

- - -

+

Button sizes

+

Fancy larger or smaller buttons? Add .btn-large, .btn-small, or .btn-mini for two additional sizes.

+

+ + +

+

+ + +

+

+ + +

-
+
-

Disabled state

-

Make buttons look unclickable by fading them back 50%.

+

Disabled state

+

Make buttons look unclickable by fading them back 50%.

-

Anchor element

-

Add the .disabled class to <a> buttons.

-

- Primary link - Link -

+

Anchor element

+

Add the .disabled class to <a> buttons.

+

+ Primary link + Link +

 <a href="#" class="btn btn-large btn-primary disabled">Primary link</a>
 <a href="#" class="btn btn-large disabled">Link</a>
 
-

- Heads up! - We use .disabled as a utility class here, similar to the common .active class, so no prefix is required. -

+

+ Heads up! + We use .disabled as a utility class here, similar to the common .active class, so no prefix is required. +

-

Button element

-

Add the disabled attribute to <button> buttons.

-

- - -

+

Button element

+

Add the disabled attribute to <button> buttons.

+

+ + +

 <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>
 
-
+
-

One class, multiple tags

-

Use the .btn class on an <a>, <button>, or <input> element.

-
- Link - - - -
+

One class, multiple tags

+

Use the .btn class on an <a>, <button>, or <input> element.

+
+ Link + + + +
 <a class="btn" href="">Link</a>
 <button class="btn" type="submit">
@@ -1427,251 +1428,251 @@ For example, <code>section</code> should be wrapped as inline.
 <input class="btn" type="submit"
          value="Submit">
 
-

As a best practice, try to match the element for you context to ensure matching cross-browser rendering. If you have an input, use an <input type="submit"> for your button.

+

As a best practice, try to match the element for you context to ensure matching cross-browser rendering. If you have an input, use an <input type="submit"> for your button.

-
+
- -
- + +
+ -

Icon glyphs

-

140 icons in sprite form, available in dark gray (default) and white, provided by Glyphicons.

-
    -
  • icon-glass
  • -
  • icon-music
  • -
  • icon-search
  • -
  • icon-envelope
  • -
  • icon-heart
  • -
  • icon-star
  • -
  • icon-star-empty
  • -
  • icon-user
  • -
  • icon-film
  • -
  • icon-th-large
  • -
  • icon-th
  • -
  • icon-th-list
  • -
  • icon-ok
  • -
  • icon-remove
  • -
  • icon-zoom-in
  • -
  • icon-zoom-out
  • -
  • icon-off
  • -
  • icon-signal
  • -
  • icon-cog
  • -
  • icon-trash
  • -
  • icon-home
  • -
  • icon-file
  • -
  • icon-time
  • -
  • icon-road
  • -
  • icon-download-alt
  • -
  • icon-download
  • -
  • icon-upload
  • -
  • icon-inbox
  • +

    Icon glyphs

    +

    140 icons in sprite form, available in dark gray (default) and white, provided by Glyphicons.

    +
      +
    • icon-glass
    • +
    • icon-music
    • +
    • icon-search
    • +
    • icon-envelope
    • +
    • icon-heart
    • +
    • icon-star
    • +
    • icon-star-empty
    • +
    • icon-user
    • +
    • icon-film
    • +
    • icon-th-large
    • +
    • icon-th
    • +
    • icon-th-list
    • +
    • icon-ok
    • +
    • icon-remove
    • +
    • icon-zoom-in
    • +
    • icon-zoom-out
    • +
    • icon-off
    • +
    • icon-signal
    • +
    • icon-cog
    • +
    • icon-trash
    • +
    • icon-home
    • +
    • icon-file
    • +
    • icon-time
    • +
    • icon-road
    • +
    • icon-download-alt
    • +
    • icon-download
    • +
    • icon-upload
    • +
    • icon-inbox
    • -
    • icon-play-circle
    • -
    • icon-repeat
    • -
    • icon-refresh
    • -
    • icon-list-alt
    • -
    • icon-lock
    • -
    • icon-flag
    • -
    • icon-headphones
    • -
    • icon-volume-off
    • -
    • icon-volume-down
    • -
    • icon-volume-up
    • -
    • icon-qrcode
    • -
    • icon-barcode
    • -
    • icon-tag
    • -
    • icon-tags
    • -
    • icon-book
    • -
    • icon-bookmark
    • -
    • icon-print
    • -
    • icon-camera
    • -
    • icon-font
    • -
    • icon-bold
    • -
    • icon-italic
    • -
    • icon-text-height
    • -
    • icon-text-width
    • -
    • icon-align-left
    • -
    • icon-align-center
    • -
    • icon-align-right
    • -
    • icon-align-justify
    • -
    • icon-list
    • +
    • icon-play-circle
    • +
    • icon-repeat
    • +
    • icon-refresh
    • +
    • icon-list-alt
    • +
    • icon-lock
    • +
    • icon-flag
    • +
    • icon-headphones
    • +
    • icon-volume-off
    • +
    • icon-volume-down
    • +
    • icon-volume-up
    • +
    • icon-qrcode
    • +
    • icon-barcode
    • +
    • icon-tag
    • +
    • icon-tags
    • +
    • icon-book
    • +
    • icon-bookmark
    • +
    • icon-print
    • +
    • icon-camera
    • +
    • icon-font
    • +
    • icon-bold
    • +
    • icon-italic
    • +
    • icon-text-height
    • +
    • icon-text-width
    • +
    • icon-align-left
    • +
    • icon-align-center
    • +
    • icon-align-right
    • +
    • icon-align-justify
    • +
    • icon-list
    • -
    • icon-indent-left
    • -
    • icon-indent-right
    • -
    • icon-facetime-video
    • -
    • icon-picture
    • -
    • icon-pencil
    • -
    • icon-map-marker
    • -
    • icon-adjust
    • -
    • icon-tint
    • -
    • icon-edit
    • -
    • icon-share
    • -
    • icon-check
    • -
    • icon-move
    • -
    • icon-step-backward
    • -
    • icon-fast-backward
    • -
    • icon-backward
    • -
    • icon-play
    • -
    • icon-pause
    • -
    • icon-stop
    • -
    • icon-forward
    • -
    • icon-fast-forward
    • -
    • icon-step-forward
    • -
    • icon-eject
    • -
    • icon-chevron-left
    • -
    • icon-chevron-right
    • -
    • icon-plus-sign
    • -
    • icon-minus-sign
    • -
    • icon-remove-sign
    • -
    • icon-ok-sign
    • +
    • icon-indent-left
    • +
    • icon-indent-right
    • +
    • icon-facetime-video
    • +
    • icon-picture
    • +
    • icon-pencil
    • +
    • icon-map-marker
    • +
    • icon-adjust
    • +
    • icon-tint
    • +
    • icon-edit
    • +
    • icon-share
    • +
    • icon-check
    • +
    • icon-move
    • +
    • icon-step-backward
    • +
    • icon-fast-backward
    • +
    • icon-backward
    • +
    • icon-play
    • +
    • icon-pause
    • +
    • icon-stop
    • +
    • icon-forward
    • +
    • icon-fast-forward
    • +
    • icon-step-forward
    • +
    • icon-eject
    • +
    • icon-chevron-left
    • +
    • icon-chevron-right
    • +
    • icon-plus-sign
    • +
    • icon-minus-sign
    • +
    • icon-remove-sign
    • +
    • icon-ok-sign
    • -
    • icon-question-sign
    • -
    • icon-info-sign
    • -
    • icon-screenshot
    • -
    • icon-remove-circle
    • -
    • icon-ok-circle
    • -
    • icon-ban-circle
    • -
    • icon-arrow-left
    • -
    • icon-arrow-right
    • -
    • icon-arrow-up
    • -
    • icon-arrow-down
    • -
    • icon-share-alt
    • -
    • icon-resize-full
    • -
    • icon-resize-small
    • -
    • icon-plus
    • -
    • icon-minus
    • -
    • icon-asterisk
    • -
    • icon-exclamation-sign
    • -
    • icon-gift
    • -
    • icon-leaf
    • -
    • icon-fire
    • -
    • icon-eye-open
    • -
    • icon-eye-close
    • -
    • icon-warning-sign
    • -
    • icon-plane
    • -
    • icon-calendar
    • -
    • icon-random
    • -
    • icon-comment
    • -
    • icon-magnet
    • +
    • icon-question-sign
    • +
    • icon-info-sign
    • +
    • icon-screenshot
    • +
    • icon-remove-circle
    • +
    • icon-ok-circle
    • +
    • icon-ban-circle
    • +
    • icon-arrow-left
    • +
    • icon-arrow-right
    • +
    • icon-arrow-up
    • +
    • icon-arrow-down
    • +
    • icon-share-alt
    • +
    • icon-resize-full
    • +
    • icon-resize-small
    • +
    • icon-plus
    • +
    • icon-minus
    • +
    • icon-asterisk
    • +
    • icon-exclamation-sign
    • +
    • icon-gift
    • +
    • icon-leaf
    • +
    • icon-fire
    • +
    • icon-eye-open
    • +
    • icon-eye-close
    • +
    • icon-warning-sign
    • +
    • icon-plane
    • +
    • icon-calendar
    • +
    • icon-random
    • +
    • icon-comment
    • +
    • icon-magnet
    • -
    • icon-chevron-up
    • -
    • icon-chevron-down
    • -
    • icon-retweet
    • -
    • icon-shopping-cart
    • -
    • icon-folder-close
    • -
    • icon-folder-open
    • -
    • icon-resize-vertical
    • -
    • icon-resize-horizontal
    • -
    • icon-hdd
    • -
    • icon-bullhorn
    • -
    • icon-bell
    • -
    • icon-certificate
    • -
    • icon-thumbs-up
    • -
    • icon-thumbs-down
    • -
    • icon-hand-right
    • -
    • icon-hand-left
    • -
    • icon-hand-up
    • -
    • icon-hand-down
    • -
    • icon-circle-arrow-right
    • -
    • icon-circle-arrow-left
    • -
    • icon-circle-arrow-up
    • -
    • icon-circle-arrow-down
    • -
    • icon-globe
    • -
    • icon-wrench
    • -
    • icon-tasks
    • -
    • icon-filter
    • -
    • icon-briefcase
    • -
    • icon-fullscreen
    • -
    +
  • icon-chevron-up
  • +
  • icon-chevron-down
  • +
  • icon-retweet
  • +
  • icon-shopping-cart
  • +
  • icon-folder-close
  • +
  • icon-folder-open
  • +
  • icon-resize-vertical
  • +
  • icon-resize-horizontal
  • +
  • icon-hdd
  • +
  • icon-bullhorn
  • +
  • icon-bell
  • +
  • icon-certificate
  • +
  • icon-thumbs-up
  • +
  • icon-thumbs-down
  • +
  • icon-hand-right
  • +
  • icon-hand-left
  • +
  • icon-hand-up
  • +
  • icon-hand-down
  • +
  • icon-circle-arrow-right
  • +
  • icon-circle-arrow-left
  • +
  • icon-circle-arrow-up
  • +
  • icon-circle-arrow-down
  • +
  • icon-globe
  • +
  • icon-wrench
  • +
  • icon-tasks
  • +
  • icon-filter
  • +
  • icon-briefcase
  • +
  • icon-fullscreen
  • +
-

Glyphicons attribution

-

Glyphicons Halflings are normally not available for free, but an arrangement between Bootstrap and the Glyphicons creators have made this possible at not cost to you as developers. As a thank you, we ask you to include an optional link back to Glyphicons whenever practical.

+

Glyphicons attribution

+

Glyphicons Halflings are normally not available for free, but an arrangement between Bootstrap and the Glyphicons creators have made this possible at not cost to you as developers. As a thank you, we ask you to include an optional link back to Glyphicons whenever practical.

-
+
-

How to use

-

All icons require an <i> tag with a unique class, prefixed with icon-. To use, place the following code just about anywhere:

+

How to use

+

All icons require an <i> tag with a unique class, prefixed with icon-. To use, place the following code just about anywhere:

 <i class="icon-search"></i>
 
-

There are also styles available for inverted (white) icons, made ready with one extra class:

+

There are also styles available for inverted (white) icons, made ready with one extra class:

 <i class="icon-search icon-white"></i>
 
-

- Heads up! - When using beside strings of text, as in buttons or nav links, be sure to leave a space after the <i> tag for proper spacing. -

+

+ Heads up! + When using beside strings of text, as in buttons or nav links, be sure to leave a space after the <i> tag for proper spacing. +

-
+
-

Icon examples

-

Use them in buttons, button groups for a toolbar, navigation, or prepended form inputs.

+

Icon examples

+

Use them in buttons, button groups for a toolbar, navigation, or prepended form inputs.

-

Buttons

-
-
-
- - - - -
- -
-
- -

Navigation

- - -

Form fields

-
-
- -
-
- +

Buttons

+
+
+
+ + + + +
+
- -
+

Navigation

+ + +

Form fields

+
+
+ +
+
+ +
+
+
+
+ +
-
-
-
+
+ +
diff --git a/docs/components.html b/docs/components.html index b176a6d7eb..ca8cfe2ddc 100644 --- a/docs/components.html +++ b/docs/components.html @@ -66,62 +66,62 @@
-
-
-

Components

-

Dozens of reusable components are built into Bootstrap to provide navigation, alerts, popovers, and much more.

+
+

Components

+

Dozens of reusable components built to provide navigation, alerts, popovers, and more.

+
+
- -
- -
+ +
+ +
- - + - -
- - -

Examples

-

Two basic options, along with two more specific variations.

- -

Single button group

-

Wrap a series of buttons with .btn in .btn-group.

-
-
- - - + +
+ + +

Examples

+

Two basic options, along with two more specific variations.

+ +

Single button group

+

Wrap a series of buttons with .btn in .btn-group.

+
+
+ + + +
-
 <div class="btn-group">
   <button class="btn">1</button>
@@ -211,26 +211,26 @@
 </div>
 
-

Multiple button groups

-

Combine sets of <div class="btn-group"> into a <div class="btn-toolbar"> for more complex components.

-
-
-
- - - - -
-
- - - -
-
- +

Multiple button groups

+

Combine sets of <div class="btn-group"> into a <div class="btn-toolbar"> for more complex components.

+
+
+
+ + + + +
+
+ + + +
+
+ +
-
 <div class="btn-toolbar">
   <div class="btn-group">
@@ -239,16 +239,16 @@
 </div>
 
-

Vertical button groups

-

Make a set of buttons appear vertically stacked rather than horizontally.

-
-
- - - - +

Vertical button groups

+

Make a set of buttons appear vertically stacked rather than horizontally.

+
+
+ + + + +
-
 <div class="btn-group btn-group-vertical">
   ...
@@ -256,102 +256,102 @@
 
-
+
-

Checkbox and radio flavors

-

Button groups can also function as radios, where only one button may be active, or checkboxes, where any number of buttons may be active. View the Javascript docs for that.

+

Checkbox and radio flavors

+

Button groups can also function as radios, where only one button may be active, or checkboxes, where any number of buttons may be active. View the Javascript docs for that.

-

Dropdowns in button groups

-

Heads up! Buttons with dropdowns must be individually wrapped in their own .btn-group within a .btn-toolbar for proper rendering.

-
+

Dropdowns in button groups

+

Heads up! Buttons with dropdowns must be individually wrapped in their own .btn-group within a .btn-toolbar for proper rendering.

+ - -
- + +
+ -

Overview and examples

-

Use any button to trigger a dropdown menu by placing it within a .btn-group and providing the proper menu markup.

- +

Overview and examples

+

Use any button to trigger a dropdown menu by placing it within a .btn-group and providing the proper menu markup.

+
 <div class="btn-group">
   <a class="btn dropdown-toggle" data-toggle="dropdown" href="#">
@@ -364,134 +364,134 @@
 </div>
 
-

Works with all button sizes

-

Button dropdowns work at any size. your button sizes to .btn-large, .btn-small, or .btn-mini.

-
-
-
- - -
-
- - -
- -
-
+

Works with all button sizes

+

Button dropdowns work at any size. your button sizes to .btn-large, .btn-small, or .btn-mini.

+
+
+
+ + +
+
+ + +
+ +
+
-

Requires javascript

-

Button dropdowns require the Bootstrap dropdown plugin to function.

-

In some cases—like mobile—dropdown menus will extend outside the viewport. You need to resolve the alignment manually or with custom javascript.

+

Requires javascript

+

Button dropdowns require the Bootstrap dropdown plugin to function.

+

In some cases—like mobile—dropdown menus will extend outside the viewport. You need to resolve the alignment manually or with custom javascript.

-
+
-

Split button dropdowns

-

Building on the button group styles and markup, we can easily create a split button. Split buttons feature a standard action on the left and a dropdown toggle on the right with contextual links.

- +

Split button dropdowns

+

Building on the button group styles and markup, we can easily create a split button. Split buttons feature a standard action on the left and a dropdown toggle on the right with contextual links.

+
 <div class="btn-group">
   <button class="btn">Action</button>
@@ -504,49 +504,49 @@
 </div>
 
-

Sizes

-

Utilize the extra button classes .btn-mini, .btn-small, or .btn-large for sizing.

-
-
-
- - - -
-
-
-
- - - -
-
-
-
- - - -
-
-
+

Sizes

+

Utilize the extra button classes .btn-mini, .btn-small, or .btn-large for sizing.

+
+
+
+ + + +
+
+
+
+ + + +
+
+
+
+ + + +
+
+
 <div class="btn-group">
   <button class="btn btn-mini">Action</button>
@@ -559,34 +559,34 @@
 </div>
 
-

Dropup menus

-

Dropdown menus can also be toggled from the bottom up by adding a single class to the immediate parent of .dropdown-menu. It will flip the direction of the .caret and reposition the menu itself to move from the bottom up instead of top down.

-
-
- -
- - - -
+

Dropup menus

+

Dropdown menus can also be toggled from the bottom up by adding a single class to the immediate parent of .dropdown-menu. It will flip the direction of the .caret and reposition the menu itself to move from the bottom up instead of top down.

+
+
+ +
+ + + +
+
-
 <div class="btn-group dropup">
   <button class="btn">Dropup</button>
@@ -599,29 +599,29 @@
 </div>
 
-
+
- - - - - - - -
- - -

Standard pagination

-

Simple pagination inspired by Rdio, great for apps and search results. The large block is hard to miss, easily scalable, and provides large click areas.

-
-
 <div class="pagination">
   <ul>
@@ -1361,26 +1361,26 @@
 
-
+
-

Options

+

Options

-

Disabled and active states

-

Links are customizable for different circumstances. Use .disabled for unclickable links and .active to indicate the current page.

-
-
 <div class="pagination ">
   <ul>
@@ -1391,39 +1391,39 @@
 </div>
 
-

Alignment

-

Add one of two optional classes to change the alignment of pagination links: .pagination-centered and .pagination-right.

-
-
 <div class="pagination pagination-centered">
   ...
 </div>
 
-
-
 <div class="pagination pagination-right">
   ...
@@ -1431,20 +1431,20 @@
 
-
+
-

Pager

-

Quick previous and next links for simple pagination implementations with light markup and styles. It's great for simple sites like blogs or magazines.

+

Pager

+

Quick previous and next links for simple pagination implementations with light markup and styles. It's great for simple sites like blogs or magazines.

-

Default example

-

By default, the pager centers links.

-
- -
+

Default example

+

By default, the pager centers links.

+
+ +
 <ul class="pager">
   <li><a href="#">Previous</a></li>
@@ -1452,14 +1452,14 @@
 </ul>
 
-

Aligned links

-

Alternatively, you can align each link to the sides:

-
- -
+

Aligned links

+

Alternatively, you can align each link to the sides:

+
+ +
 <ul class="pager">
   <li class="previous">
@@ -1471,14 +1471,14 @@
 </ul>
 
-

Optional disabled state

-

Pager links also use the general .disabled utility class from the pagination.

-
- -
+

Optional disabled state

+

Pager links also use the general .disabled utility class from the pagination.

+
+ +
 <ul class="pager">
   <li class="previous disabled">
@@ -1488,187 +1488,175 @@
 </ul>
 
-
+ - -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
LabelsMarkup
- Default - - <span class="label">Default</span> -
- Success - - <span class="label label-success">Success</span> -
- Warning - - <span class="label label-warning">Warning</span> -
- Important - - <span class="label label-important">Important</span> -
- Info - - <span class="label label-info">Info</span> -
- Inverse - - <span class="label label-inverse">Inverse</span> -
-
- - - - -
- - -

About

-

Badges are small, simple components for displaying an indicator or count of some sort. They're commonly found in email clients like Mail.app or on mobile apps for push notifications.

- -

Available classes

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
NameExampleMarkup
- Default - - 1 - - <span class="badge">1</span> -
- Success - - 2 - - <span class="badge badge-success">2</span> -
- Warning - - 4 - - <span class="badge badge-warning">4</span> -
- Important - - 6 - - <span class="badge badge-important">6</span> -
- Info - - 8 - - <span class="badge badge-info">8</span> -
- Inverse - - 10 - - <span class="badge badge-inverse">10</span> -
- -
- - - - -
- - -

Hero unit

-

A lightweight, flexible component called a hero unit to showcase content on your site. It works well on marketing and content-heavy sites.

-
-
-

Hello, world!

-

This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.

-

Learn more

+ +
+ +

Labels

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
LabelsMarkup
+ Default + + <span class="label">Default</span> +
+ Success + + <span class="label label-success">Success</span> +
+ Warning + + <span class="label label-warning">Warning</span> +
+ Important + + <span class="label label-important">Important</span> +
+ Info + + <span class="label label-info">Info</span> +
+ Inverse + + <span class="label label-inverse">Inverse</span> +
+ +

Badges

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameExampleMarkup
+ Default + + 1 + + <span class="badge">1</span> +
+ Success + + 2 + + <span class="badge badge-success">2</span> +
+ Warning + + 4 + + <span class="badge badge-warning">4</span> +
+ Important + + 6 + + <span class="badge badge-important">6</span> +
+ Info + + 8 + + <span class="badge badge-info">8</span> +
+ Inverse + + 10 + + <span class="badge badge-inverse">10</span> +
+ +
+ + + + +
+ + +

Hero unit

+

A lightweight, flexible component to showcase key content on your site. It works well on marketing and content-heavy sites.

+
+
+

Hello, world!

+

This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.

+

Learn more

+
-
 <div class="hero-unit">
   <h1>Heading</h1>
@@ -1681,105 +1669,105 @@
 </div>
 
-

Page header

-

A simple shell for an h1 to appropriately space out and segment sections of content on a page. It can utilize the h1's default small, element as well most other components (with additional styles).

-
-
 <div class="page-header">
   <h1>Example page header</h1>
 </div>
 
-
+ - -
- + +
+ -

Default thumbnails

-

By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.

-
- -
+

Default thumbnails

+

By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.

+
+ +
-

Highly customizable

-

With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.

-
-
    -
  • -
    - -
    -

    Thumbnail label

    -

    Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

    -

    Action Action

    +

    Highly customizable

    +

    With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.

    +
    +
      +
    • +
      + +
      +

      Thumbnail label

      +

      Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

      +

      Action Action

      +
      -
    -
  • -
  • -
    - -
    -

    Thumbnail label

    -

    Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

    -

    Action Action

    +
  • +
  • +
    + +
    +

    Thumbnail label

    +

    Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

    +

    Action Action

    +
    -
- -
  • -
    - -
    -

    Thumbnail label

    -

    Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

    -

    Action Action

    +
  • +
  • +
    + +
    +

    Thumbnail label

    +

    Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

    +

    Action Action

    +
    -
  • - - -
    + + +
    -

    Why use thumbnails

    -

    Thumbnails (previously .media-grid up until v1.4) are great for grids of photos or videos, image search results, retail products, portfolios, and much more. They can be links or static content.

    +

    Why use thumbnails

    +

    Thumbnails (previously .media-grid up until v1.4) are great for grids of photos or videos, image search results, retail products, portfolios, and much more. They can be links or static content.

    -

    Simple, flexible markup

    -

    Thumbnail markup is simple—a ul with any number of li elements is all that is required. It's also super flexible, allowing for any type of content with just a bit more markup to wrap your contents.

    +

    Simple, flexible markup

    +

    Thumbnail markup is simple—a ul with any number of li elements is all that is required. It's also super flexible, allowing for any type of content with just a bit more markup to wrap your contents.

    -

    Uses grid column sizes

    -

    Lastly, the thumbnails component uses existing grid system classes—like .span2 or .span3—for control of thumbnail dimensions.

    +

    Uses grid column sizes

    +

    Lastly, the thumbnails component uses existing grid system classes—like .span2 or .span3—for control of thumbnail dimensions.

    -

    The markup

    -

    As mentioned previously, the required markup for thumbnails is light and straightforward. Here's a look at the default setup for linked images:

    +

    Markup

    +

    As mentioned previously, the required markup for thumbnails is light and straightforward. Here's a look at the default setup for linked images:

     <ul class="thumbnails">
       <li class="span4">
    @@ -1790,7 +1778,7 @@
       ...
     </ul>
     
    -

    For custom HTML content in thumbnails, the markup changes slightly. To allow block level content anywhere, we swap the <a> for a <div> like so:

    +

    For custom HTML content in thumbnails, the markup changes slightly. To allow block level content anywhere, we swap the <a> for a <div> like so:

     <ul class="thumbnails">
       <li class="span4">
    @@ -1804,65 +1792,55 @@
     </ul>
     
    -

    More examples

    -

    Explore all your options with the various grid classes available to you. You can also mix and match different sizes.

    - +

    More examples

    +

    Explore all your options with the various grid classes available to you. You can also mix and match different sizes.

    + - + - -
    - - -

    Default alert

    -

    Wrap any text and an optional dismiss button in .alert for a basic warning alert message.

    -
    -
    - - Warning! Best check yo self, you're not looking too good. + +
    + + +

    Default alert

    +

    Wrap any text and an optional dismiss button in .alert for a basic warning alert message.

    +
    +
    + + Warning! Best check yo self, you're not looking too good. +
    -
     <div class="alert">
       <button type="button" class="close" data-dismiss="alert">×</button>
    @@ -1870,32 +1848,32 @@
     </div>
     
    -

    Dismiss buttons

    -

    Mobile Safari and Mobile Opera browsers, in addition to the data-dismiss="alert" attribute, require an href="#" for the dismissal of alerts when using an <a> tag.

    +

    Dismiss buttons

    +

    Mobile Safari and Mobile Opera browsers, in addition to the data-dismiss="alert" attribute, require an href="#" for the dismissal of alerts when using an <a> tag.

     <a href="#" class="close" data-dismiss="alert">×</button>
     
    -

    Alternatively, you may use a <button> element with the data attribute, which we have opted to do for our docs. When using <button>, you must include type="button" or your forms may not submit.

    +

    Alternatively, you may use a <button> element with the data attribute, which we have opted to do for our docs. When using <button>, you must include type="button" or your forms may not submit.

     <button type="button" class="close" data-dismiss="alert">×</button>
     
    -

    Dismiss alerts via javascript

    -

    Use the alerts jQuery plugin for quick and easy dismissal of alerts.

    +

    Dismiss alerts via javascript

    +

    Use the alerts jQuery plugin for quick and easy dismissal of alerts.

    -
    +
    -

    Options

    -

    For longer messages, increase the padding on the top and bottom of the alert wrapper by adding .alert-block.

    -
    -
    - -

    Warning!

    -

    Best check yo self, you're not looking too good. Nulla vitae elit libero, a pharetra augue. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.

    +

    Options

    +

    For longer messages, increase the padding on the top and bottom of the alert wrapper by adding .alert-block.

    +
    +
    + +

    Warning!

    +

    Best check yo self, you're not looking too good. Nulla vitae elit libero, a pharetra augue. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.

    +
    -
     <div class="alert alert-block">
       <a class="close" data-dismiss="alert" href="#">&times;</a>
    @@ -1905,97 +1883,97 @@
     
    -
    +
    -

    Contextual alternatives

    -

    Add optional classes to change an alert's connotation.

    +

    Contextual alternatives

    +

    Add optional classes to change an alert's connotation.

    -

    Error or danger

    -
    -
    - - Oh snap! Change a few things up and try submitting again. +

    Error or danger

    +
    +
    + + Oh snap! Change a few things up and try submitting again. +
    -
     <div class="alert alert-error">
       ...
     </div>
     
    -

    Success

    -
    -
    - - Well done! You successfully read this important alert message. +

    Success

    +
    +
    + + Well done! You successfully read this important alert message. +
    -
     <div class="alert alert-success">
       ...
     </div>
     
    -

    Information

    -
    -
    - - Heads up! This alert needs your attention, but it's not super important. +

    Information

    +
    +
    + + Heads up! This alert needs your attention, but it's not super important. +
    -
     <div class="alert alert-info">
       ...
     </div>
     
    -
    + - -
    - - -

    Examples and markup

    - -

    Basic

    -

    Default progress bar with a vertical gradient.

    -
    -
    -
    + +
    + + +

    Examples and markup

    + +

    Basic

    +

    Default progress bar with a vertical gradient.

    +
    +
    +
    +
    -
     <div class="progress">
       <div class="bar" style="width: 60%;"></div>
     </div>
     
    -

    Striped

    -

    Uses a gradient to create a striped effect. Not available in IE7-8.

    -
    -
    -
    +

    Striped

    +

    Uses a gradient to create a striped effect. Not available in IE7-8.

    +
    +
    +
    +
    -
     <div class="progress progress-striped">
       <div class="bar" style="width: 20%;"></div>
     </div>
     
    -

    Animated

    -

    Add .active to .progress-striped to animate the stripes right to left. Not available in all versions of IE.

    -
    -
    -
    +

    Animated

    +

    Add .active to .progress-striped to animate the stripes right to left. Not available in all versions of IE.

    +
    +
    +
    +
    -
     <div class="progress progress-striped active">
       <div class="bar" style="width: 40%;"></div>
    @@ -2003,27 +1981,27 @@
     
    -
    +
    -

    Options

    +

    Options

    -

    Additional colors

    -

    Progress bars use some of the same button and alert classes for consistent styles.

    -
    -
    -
    +

    Additional colors

    +

    Progress bars use some of the same button and alert classes for consistent styles.

    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
     <div class="progress progress-info">
       <div class="bar" style="width: 20%"></div>
    @@ -2039,22 +2017,22 @@
     </div>
     
    -

    Striped bars

    -

    Similar to the solid colors, we have varied striped progress bars.

    -
    -
    -
    +

    Striped bars

    +

    Similar to the solid colors, we have varied striped progress bars.

    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
     <div class="progress progress-info progress-striped">
       <div class="bar" style="width: 20%"></div>
    @@ -2071,74 +2049,74 @@
     
    -
    +
    -

    Browser support

    -

    Progress bars use CSS3 gradients, transitions, and animations to achieve all their effects. These features are not supported in IE7-9 or older versions of Firefox.

    -

    Opera and IE do not support animations at this time.

    +

    Browser support

    +

    Progress bars use CSS3 gradients, transitions, and animations to achieve all their effects. These features are not supported in IE7-9 or older versions of Firefox.

    +

    Opera and IE do not support animations at this time.

    -
    + - -
    - - -

    Wells

    -

    Use the well as a simple effect on an element to give it an inset effect.

    -
    -
    - Look, I'm in a well! + +
    + + +

    Wells

    +

    Use the well as a simple effect on an element to give it an inset effect.

    +
    +
    + Look, I'm in a well! +
    -
     <div class="well">
       ...
     </div>
     
    -

    Optional classes

    -

    Control padding and rounded corners with two optional modifier classes.

    -
    -
    - Look, I'm in a well! +

    Optional classes

    +

    Control padding and rounded corners with two optional modifier classes.

    +
    +
    + Look, I'm in a well! +
    -
     <div class="well well-large">
       ...
     </div>
     
    -
    -
    - Look, I'm in a well! +
    +
    + Look, I'm in a well! +
    -
     <div class="well well-small">
       ...
     </div>
     
    -

    Close icon

    -

    Use the generic close icon for dismissing content like modals and alerts.

    -
    -

    -
    +

    Close icon

    +

    Use the generic close icon for dismissing content like modals and alerts.

    +
    +

    +
    <button class="close">&times;</button>
    -

    iOS devices require an href="#" for click events if you rather use an anchor.

    +

    iOS devices require an href="#" for click events if you rather use an anchor.

    <a class="close" href="#">&times;</a>
    -

    Helper classes

    -

    Simple, focused classes for small display or behavior tweaks.

    +

    Helper classes

    +

    Simple, focused classes for small display or behavior tweaks.

    -

    .pull-left

    -

    Float an element left

    +

    .pull-left

    +

    Float an element left

     class="pull-left"
     
    @@ -2148,8 +2126,8 @@ class="pull-left" } -

    .pull-right

    -

    Float an element right

    +

    .pull-right

    +

    Float an element right

     class="pull-right"
     
    @@ -2159,8 +2137,8 @@ class="pull-right" } -

    .muted

    -

    Change an element's color to #999

    +

    .muted

    +

    Change an element's color to #999

     class="muted"
     
    @@ -2170,8 +2148,8 @@ class="muted" } -

    .clearfix

    -

    Clear the float on any element

    +

    .clearfix

    +

    Clear the float on any element

     class="clearfix"
     
    @@ -2189,14 +2167,14 @@ class="clearfix" } -
    + -
    -
    -
    + + + diff --git a/docs/download.html b/docs/download.html index 6419d13175..2573b45c95 100644 --- a/docs/download.html +++ b/docs/download.html @@ -66,8 +66,6 @@ -
    -
    @@ -416,8 +414,6 @@ -
    -
    @@ -100,8 +98,6 @@ - -
    -

    Extending Bootstrap

    -

    Extend Bootstrap to take advantage of included styles and components, as well as LESS variables and mixins.

    +
    +

    Extending Bootstrap

    +

    Extend Bootstrap to take advantage of included styles and components, as well as LESS variables and mixins.

    +
    +
    - -
    - -
    + +
    + +
    - -
    - + +
    + -

    Why LESS?

    -

    Bootstrap is made with LESS at its core, a dynamic stylesheet language created by our good friend, Alexis Sellier. It makes developing systems-based CSS faster, easier, and more fun.

    +

    Why LESS?

    +

    Bootstrap is made with LESS at its core, a dynamic stylesheet language created by our good friend, Alexis Sellier. It makes developing systems-based CSS faster, easier, and more fun.

    -

    What's included?

    -

    As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.

    +

    What's included?

    +

    As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.

    -

    Learn more

    - LESS CSS -

    Visit the official website at http://lesscss.org to learn more.

    -
    +

    Learn more

    + LESS CSS +

    Visit the official website at http://lesscss.org to learn more.

    +
    - -
    - -
    - Note: If you're submitting a pull request to GitHub with modified CSS, you must recompile the CSS via any of these methods. -
    + +
    + +
    + Note: If you're submitting a pull request to GitHub with modified CSS, you must recompile the CSS via any of these methods. +
    -

    Tools for compiling

    +

    Tools for compiling

    -

    Node with makefile

    -

    Install the LESS command line compiler, JSHint, Recess, and uglify-js globally with npm by running the following command:

    -
    $ npm install -g less jshint recess uglify-js
    -

    Once installed just run make from the root of your bootstrap directory and you're all set.

    -

    Additionally, if you have watchr installed, you may run make watch to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).

    +

    Node with makefile

    +

    Install the LESS command line compiler, JSHint, Recess, and uglify-js globally with npm by running the following command:

    +
    $ npm install -g less jshint recess uglify-js
    +

    Once installed just run make from the root of your bootstrap directory and you're all set.

    +

    Additionally, if you have watchr installed, you may run make watch to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).

    -

    Command line

    -

    Install the LESS command line tool via Node and run the following command:

    -
    $ lessc ./less/bootstrap.less > bootstrap.css
    -

    Be sure to include --compress in that command if you're trying to save some bytes!

    +

    Command line

    +

    Install the LESS command line tool via Node and run the following command:

    +
    $ lessc ./less/bootstrap.less > bootstrap.css
    +

    Be sure to include --compress in that command if you're trying to save some bytes!

    -

    Javascript

    -

    Download the latest Less.js and include the path to it (and Bootstrap) in the <head>.

    +

    Javascript

    +

    Download the latest Less.js and include the path to it (and Bootstrap) in the <head>.

     <link rel="stylesheet/less" href="/path/to/bootstrap.less">
     <script src="/path/to/less.js"></script>
     
    -

    To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.

    +

    To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.

    -

    Unofficial Mac app

    -

    The unofficial Mac app watches directories of .less files and compiles the code to local files after every save of a watched .less file.

    -

    If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.

    +

    Unofficial Mac app

    +

    The unofficial Mac app watches directories of .less files and compiles the code to local files after every save of a watched .less file.

    +

    If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.

    -

    More Mac apps

    -

    Crunch

    -

    Crunch is a great looking LESS editor and compiler built on Adobe Air.

    -

    CodeKit

    -

    Created by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.

    -

    Simpless

    -

    Mac, Linux, and PC app for drag and drop compiling of LESS files. Plus, the source code is on GitHub.

    +

    More Mac apps

    +

    Crunch

    +

    Crunch is a great looking LESS editor and compiler built on Adobe Air.

    +

    CodeKit

    +

    Created by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.

    +

    Simpless

    +

    Mac, Linux, and PC app for drag and drop compiling of LESS files. Plus, the source code is on GitHub.

    -
    +
    - -
    - -

    ...

    -
    + +
    + +

    ...

    +
    -
    -
    -
    +
    + +
    diff --git a/docs/getting-started.html b/docs/getting-started.html index 856964bd94..c0e99542e9 100644 --- a/docs/getting-started.html +++ b/docs/getting-started.html @@ -66,15 +66,17 @@ -
    - +
    +

    Getting started

    Overview of the project, it's contents, and how to get started with a simple template.

    +
    +
    -
    - - + diff --git a/docs/javascript.html b/docs/javascript.html index 1792f75c41..21d0044b09 100644 --- a/docs/javascript.html +++ b/docs/javascript.html @@ -66,112 +66,113 @@ -
    -
    -

    Javascript for Bootstrap

    -

    Bring Bootstrap's components to life—now with 12 custom jQuery plugins. +

    +

    Javascript for Bootstrap

    +

    Bring Bootstrap's components to life—now with 12 custom jQuery plugins. +

    +
    - -
    - -
    - - - - -
    - - -

    Individual or compiled

    -

    If you have downloaded the latest version of Bootstrap, both bootstrap.js and bootstrap.min.js contain all of these plugins.

    - -

    Data attributes

    -

    ...

    - -

    Programmatic API

    -

    ...

    - - - -
    - - - - -
    - -

    About transitions

    -

    For simple transition effects, include bootstrap-transition.js once alongside the other JS files. If you're using the compiled (or minified) bootstrap.js, there is no need to include this—it's already there.

    -

    Use cases

    -

    A few examples of the transition plugin:

    -
    +
    +
    - -
    - + +
    + + +

    Individual or compiled

    +

    If you have downloaded the latest version of Bootstrap, both bootstrap.js and bootstrap.min.js contain all of these plugins.

    + +

    Data attributes

    +

    ...

    + +

    Programmatic API

    +

    ...

    -

    Examples

    -

    Modals are streamlined, but flexible, dialog prompts with the minimum required functionality and smart defaults.

    -

    Static example

    -

    A rendered modal with header, body, and set of actions in the footer.

    -
    -
    + + + + +
    + +

    About transitions

    +

    For simple transition effects, include bootstrap-transition.js once alongside the other JS files. If you're using the compiled (or minified) bootstrap.js, there is no need to include this—it's already there.

    +

    Use cases

    +

    A few examples of the transition plugin:

    +
      +
    • Sliding or fading in modals
    • +
    • Fading out tabs
    • +
    • Fading out alerts
    • +
    • Sliding carousel panes
    • +
    + +
    + + + + +
    + + + +

    Examples

    +

    Modals are streamlined, but flexible, dialog prompts with the minimum required functionality and smart defaults.

    + +

    Static example

    +

    A rendered modal with header, body, and set of actions in the footer.

    +
    +
    -
     <div class="modal hide fade">
       <div class="modal-header">
    @@ -188,43 +189,43 @@
     </div>
     
    -

    Live demo

    -

    Toggle a modal via javascript by clicking the button below. It will slide down and fade in from the top of the page.

    - - -
    +
    + +
    diff --git a/docs/scaffolding.html b/docs/scaffolding.html index 0a94cf49a1..ca94d8a542 100644 --- a/docs/scaffolding.html +++ b/docs/scaffolding.html @@ -66,43 +66,44 @@ -
    -
    -

    Scaffolding

    -

    Bootstrap is built on a responsive 12-column grid. We've also included fixed- and fluid-width layouts based on that system.

    +
    +

    Scaffolding

    +

    Bootstrap is built on a responsive 12-column grid and includes fixed- and fluid-width layouts.

    +
    +
    - -
    - -
    + + +
    + +
    - -
    - + +
    + -

    Requires HTML5 doctype

    -

    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.

    +

    Requires HTML5 doctype

    +

    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.

     <!DOCTYPE html>
     <html lang="en">
    @@ -110,84 +111,84 @@
     </html>
     
    -

    Typography and links

    -

    Bootstrap sets basic global display, typography, and link styles. Specifically, we:

    -
      -
    • Remove margin on the body
    • -
    • Set background-color: white; on the body
    • -
    • Use the @baseFontFamily, @baseFontSize, and @baseLineHeight attributes as our typographyic base
    • -
    • Set the global link color via @linkColor and apply link underlines only on :hover
    • -
    -

    These styles can be found within scaffolding.less.

    +

    Typography and links

    +

    Bootstrap sets basic global display, typography, and link styles. Specifically, we:

    +
      +
    • Remove margin on the body
    • +
    • Set background-color: white; on the body
    • +
    • Use the @baseFontFamily, @baseFontSize, and @baseLineHeight attributes as our typographyic base
    • +
    • Set the global link color via @linkColor and apply link underlines only on :hover
    • +
    +

    These styles can be found within scaffolding.less.

    -

    Reset via Normalize

    -

    With Bootstrap 2, the old reset block has been dropped in favor of Normalize.css, a project by Nicolas Gallagher that also powers the HTML5 Boilerplate. While we use much of Normalize within our reset.less, we have removed some elements specifically for Bootstrap.

    +

    Reset via Normalize

    +

    With Bootstrap 2, the old reset block has been dropped in favor of Normalize.css, a project by Nicolas Gallagher that also powers the HTML5 Boilerplate. While we use much of Normalize within our reset.less, we have removed some elements specifically for Bootstrap.

    -
    +
    - -
    - - -

    Live grid example

    -

    The default Bootstrap grid system utilizes 12 columns, making for a 940px wide container without responsive features 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.

    -
    -
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    + +
    + -
    -
    2
    -
    3
    -
    4
    -
    -
    -
    4
    -
    5
    -
    -
    -
    9
    -
    -
    -

    Basic grid HTML

    -

    For a simple two column layout, create a .row and add the appropriate number of .span* columns. As this is a 12-column grid, each .span* spans a number of those 12 columns, and should always add up to 12 for each row.

    +

    Live grid example

    +

    The default Bootstrap grid system utilizes 12 columns, making for a 940px wide container without responsive features 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.

    +
    +
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    +
    +
    2
    +
    3
    +
    4
    +
    +
    +
    4
    +
    5
    +
    +
    +
    9
    +
    +
    + +

    Basic grid HTML

    +

    For a simple two column layout, create a .row and add the appropriate number of .span* columns. As this is a 12-column grid, each .span* spans a number of those 12 columns, and should always add up to 12 for each row.

     <div class="row">
       <div class="span4">...</div>
       <div class="span8">...</div>
     </div>
     
    -

    Given this example, we have .span4 and .span8, making for 12 total columns and a complete row.

    +

    Given this example, we have .span4 and .span8, making for 12 total columns and a complete row.

    -

    Offsetting columns

    -

    Move columns to the left using .offset* classes. Each class increases the left margin of a column by a whole column. For example, .offset4 moves .span4 over four columns.

    -
    -
    -
    4
    -
    3 offset 2
    -
    -
    -
    3 offset 1
    -
    3 offset 2
    -
    -
    -
    6 offset 3
    -
    -
    +

    Offsetting columns

    +

    Move columns to the left using .offset* classes. Each class increases the left margin of a column by a whole column. For example, .offset4 moves .span4 over four columns.

    +
    +
    +
    4
    +
    3 offset 2
    +
    +
    +
    3 offset 1
    +
    3 offset 2
    +
    +
    +
    6 offset 3
    +
    +
     <div class="row">
       <div class="span4">...</div>
    @@ -195,23 +196,23 @@
     </div>
     
    -

    Nesting columns

    -

    To nest your content with the default grid, add a new .row and set of .span* columns within an existing .span* column. Nested rows should include a set of columns that add up to the number of columns of its parent.

    -

    Example

    -

    Here two nested .span4 columns are placed within a .span8.

    -
    -
    - Level 1 of column -
    -
    - Level 2 -
    -
    - Level 2 +

    Nesting columns

    +

    To nest your content with the default grid, add a new .row and set of .span* columns within an existing .span* column. Nested rows should include a set of columns that add up to the number of columns of its parent.

    +

    Example

    +

    Here two nested .span4 columns are placed within a .span8.

    +
    +
    + Level 1 of column +
    +
    + Level 2 +
    +
    + Level 2 +
    -
     <div class="row">
       <div class="span10">
    @@ -223,54 +224,54 @@
       </div>
     </div>
     
    -
    + - -
    - + +
    + -

    Live fluid grid example

    -

    The fluid grid system uses percents instead of pixels for column widths. It has the same responsive capabilities as our fixed grid system, ensuring proper proportions for key screen resolutions and devices.

    -
    -
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    +

    Live fluid grid example

    +

    The fluid grid system uses percents instead of pixels for column widths. It has the same responsive capabilities as our fixed grid system, ensuring proper proportions for key screen resolutions and devices.

    +
    +
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    +
    +
    4
    +
    4
    +
    4
    +
    +
    +
    4
    +
    8
    +
    +
    +
    6
    +
    6
    +
    +
    +
    12
    +
    -
    -
    4
    -
    4
    -
    4
    -
    -
    -
    4
    -
    8
    -
    -
    -
    6
    -
    6
    -
    -
    -
    12
    -
    -
    -

    Basic fluid grid HTML

    -

    Make any row "fluid" by changing .row to .row-fluid. The column classes stay the exact same, making it easy to flip between fixed and fluid grids.

    +

    Basic fluid grid HTML

    +

    Make any row "fluid" by changing .row to .row-fluid. The column classes stay the exact same, making it easy to flip between fixed and fluid grids.

     <div class="row-fluid">
       <div class="span4">...</div>
    @@ -278,21 +279,21 @@
     </div>
     
    -

    Fluid offsetting

    -

    Operates the same way as the fixed grid system offsetting: add .offset* to any column to offset by that many columns.

    -
    -
    -
    4
    -
    4 offset 4
    -
    -
    -
    3 offset 3
    -
    3 offset 3
    -
    -
    -
    6 offset 6
    -
    -
    +

    Fluid offsetting

    +

    Operates the same way as the fixed grid system offsetting: add .offset* to any column to offset by that many columns.

    +
    +
    +
    4
    +
    4 offset 4
    +
    +
    +
    3 offset 3
    +
    3 offset 3
    +
    +
    +
    6 offset 6
    +
    +
     <div class="row-fluid">
       <div class="span4">...</div>
    @@ -300,21 +301,21 @@
     </div>
     
    -

    Fluid nesting

    -

    Nesting with fluid grids is a bit different: the number of nested columns should not match the parent's number of columns. Instead, each level of nested columns are reset because each row takes up 100% of the parent column.

    -
    -
    - Fluid 12 -
    -
    - Fluid 6 -
    -
    - Fluid 6 +

    Fluid nesting

    +

    Nesting with fluid grids is a bit different: the number of nested columns should not match the parent's number of columns. Instead, each level of nested columns are reset because each row takes up 100% of the parent column.

    +
    +
    + Fluid 12 +
    +
    + Fluid 6 +
    +
    + Fluid 6 +
    -
     <div class="row-fluid">
       <div class="span12">
    @@ -327,78 +328,23 @@
     </div>
     
    -
    +
    - -
    - -

    Variables in LESS

    -

    The default grid is built on a few variables for easy customization via LESS. All variables can be found in variables.less.

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    VariableDefault valueDescription
    @gridColumns12Number of columns
    @gridColumnWidth60pxWidth of each column
    @gridGutterWidth20pxNegative space between columns
    @fluidGridColumnWidth6.382978723%Width of each fluid column
    @fluidGridGutterWidth2.127659574%Negative space between fluid columns
    + +
    + -

    How to customize

    -

    Modifying the grid means changing the three @grid* variables and recompiling Bootstrap. Change the grid variables in variables.less and use one of the four ways documented to recompile. If you're adding more columns, be sure to add the CSS for those in grid.less.

    - -

    Staying responsive

    -

    Customization of the grid only works at the default level, the 940px grid. To maintain the responsive aspects of Bootstrap, you'll also have to manually customize the grids in responsive.less until a future update improves this.

    - -
    - - - - -
    - - -

    Fixed layout

    -

    Provides a common fixed-width (and optionally responsive) layout with only <div class="container"> required.

    -
    -
    -
    +

    Fixed layout

    +

    Provides a common fixed-width (and optionally responsive) layout with only <div class="container"> required.

    +
    +
    +
     <body>
       <div class="container">
    @@ -407,12 +353,12 @@
     </body>
     
    -

    Fluid layout

    -

    Create a fluid, two-column page with <div class="container-fluid">—great for applications and docs.

    -
    -
    -
    -
    +

    Fluid layout

    +

    Create a fluid, two-column page with <div class="container-fluid">—great for applications and docs.

    +
    +
    +
    +
     <div class="container-fluid">
       <div class="row-fluid">
    @@ -425,78 +371,78 @@
       </div>
     </div>
     
    -
    +
    - -
    - + +
    + -

    Enabling responsive features

    -

    Turn on responsive CSS in your project by including the proper meta tag and additional stylesheet within the <head> of your document. If you've compiled Bootstrap from the Customize page, you need only include the meta tag.

    +

    Enabling responsive features

    +

    Turn on responsive CSS in your project by including the proper meta tag and additional stylesheet within the <head> of your document. If you've compiled Bootstrap from the Customize page, you need only include the meta tag.

     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <link href="assets/css/bootstrap-responsive.css" rel="stylesheet">
     
    -

    Heads up! Bootstrap doesn't include responsive features by default at this time as not everything needs to be responsive. Instead of encouraging developers to remove this feature, we figure it best to enable it as needed.

    +

    Heads up! Bootstrap doesn't include responsive features by default at this time as not everything needs to be responsive. Instead of encouraging developers to remove this feature, we figure it best to enable it as needed.

    -

    About responsive Bootstrap

    - Responsive devices -

    Media queries allow for custom CSS based on a number of conditions—ratios, widths, display type, etc—but usually focuses around min-width and max-width.

    -
      -
    • Modify the width of column in our grid
    • -
    • Stack elements instead of float wherever necessary
    • -
    • Resize headings and text to be more appropriate for devices
    • -
    -

    Use media queries responsibly and only as a start to your mobile audiences. For larger projects, do consider dedicated code bases and not layers of media queries.

    +

    About responsive Bootstrap

    + Responsive devices +

    Media queries allow for custom CSS based on a number of conditions—ratios, widths, display type, etc—but usually focuses around min-width and max-width.

    +
      +
    • Modify the width of column in our grid
    • +
    • Stack elements instead of float wherever necessary
    • +
    • Resize headings and text to be more appropriate for devices
    • +
    +

    Use media queries responsibly and only as a start to your mobile audiences. For larger projects, do consider dedicated code bases and not layers of media queries.

    -

    Supported devices

    -

    Bootstrap supports a handful of media queries in a single file to help make your projects more appropriate on different devices and screen resolutions. Here's what's included:

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    LabelLayout widthColumn widthGutter width
    Phones480px and belowFluid columns, no fixed widths
    Phones to tablets767px and belowFluid columns, no fixed widths
    Portrait tablets768px and above42px20px
    Default980px and up60px20px
    Large display1200px and up70px30px
    +

    Supported devices

    +

    Bootstrap supports a handful of media queries in a single file to help make your projects more appropriate on different devices and screen resolutions. Here's what's included:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    LabelLayout widthColumn widthGutter width
    Phones480px and belowFluid columns, no fixed widths
    Phones to tablets767px and belowFluid columns, no fixed widths
    Portrait tablets768px and above42px20px
    Default980px and up60px20px
    Large display1200px and up70px30px
     /* Landscape phones and down */
     @media (max-width: 480px) { ... }
    @@ -512,85 +458,85 @@
     
    -

    Responsive utility classes

    -

    For faster mobile-friendly development, use these utility classes for showing and hiding content by device. Below is a table of the available classes and their effect on a given media query layout (labeled by device). They can be found in responsive.less.

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    ClassPhones 767px and belowTablets 979px to 768pxDesktops Default
    .visible-phoneVisible
    .visible-tabletVisible
    .visible-desktopVisible
    .hidden-phoneVisibleVisible
    .hidden-tabletVisibleVisible
    .hidden-desktopVisibleVisible
    +

    Responsive utility classes

    +

    For faster mobile-friendly development, use these utility classes for showing and hiding content by device. Below is a table of the available classes and their effect on a given media query layout (labeled by device). They can be found in responsive.less.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    ClassPhones 767px and belowTablets 979px to 768pxDesktops Default
    .visible-phoneVisible
    .visible-tabletVisible
    .visible-desktopVisible
    .hidden-phoneVisibleVisible
    .hidden-tabletVisibleVisible
    .hidden-desktopVisibleVisible
    -

    When to use

    -

    Use on a limited basis and avoid creating entirely different versions of the same site. Instead, use them to complement each device's presentation.

    +

    When to use

    +

    Use on a limited basis and avoid creating entirely different versions of the same site. Instead, use them to complement each device's presentation.

    -

    Responsive utilities test case

    -

    Resize your browser or load on different devices to test the above classes.

    -

    Visible on...

    -

    Green checkmarks indicate that class is visible in your current viewport.

    -
      -
    • Phone✔ Phone
    • -
    • Tablet✔ Tablet
    • -
    • Desktop✔ Desktop
    • -
    -

    Hidden on...

    -

    Here, green checkmarks indicate that class is hidden in your current viewport.

    -
      -
    • Phone✔ Phone
    • -
    • Tablet✔ Tablet
    • -
    • Desktop✔ Desktop
    • -
    +

    Responsive utilities test case

    +

    Resize your browser or load on different devices to test the above classes.

    +

    Visible on...

    +

    Green checkmarks indicate that class is visible in your current viewport.

    +
      +
    • Phone✔ Phone
    • +
    • Tablet✔ Tablet
    • +
    • Desktop✔ Desktop
    • +
    +

    Hidden on...

    +

    Here, green checkmarks indicate that class is hidden in your current viewport.

    +
      +
    • Phone✔ Phone
    • +
    • Tablet✔ Tablet
    • +
    • Desktop✔ Desktop
    • +
    -
    +
    -
    -
    -
    +
    + +
    diff --git a/docs/templates/layout.mustache b/docs/templates/layout.mustache index 9808c7b663..cbfae7f26f 100644 --- a/docs/templates/layout.mustache +++ b/docs/templates/layout.mustache @@ -78,12 +78,8 @@
    -
    - {{>body}} -
    {{! /container }} -
    -

    {{_i}}Base CSS{{/i}}

    -

    {{_i}}On top of the scaffolding, basic HTML elements are styled and enhanced with extensible classes to provide a fresh, consistent look and feel.{{/i}}

    +
    +

    {{_i}}Base CSS{{/i}}

    +

    {{_i}}On top of the scaffolding, basic HTML elements are styled and enhanced with extensible classes.{{/i}}

    +
    +
    - -
    - -
    + +
    + +
    - -
    - + +
    + - {{! Headings }} -

    {{_i}}Headings{{/i}}

    -

    {{_i}}All HTML headings, <h1> through <h6> are available.{{/i}}

    -
    -

    h1. {{_i}}Heading 1{{/i}}

    -

    h2. {{_i}}Heading 2{{/i}}

    -

    h3. {{_i}}Heading 3{{/i}}

    -

    h4. {{_i}}Heading 4{{/i}}

    -
    h5. {{_i}}Heading 5{{/i}}
    -
    h6. {{_i}}Heading 6{{/i}}
    -
    + {{! Headings }} +

    {{_i}}Headings{{/i}}

    +

    {{_i}}All HTML headings, <h1> through <h6> are available.{{/i}}

    +
    +

    h1. {{_i}}Heading 1{{/i}}

    +

    h2. {{_i}}Heading 2{{/i}}

    +

    h3. {{_i}}Heading 3{{/i}}

    +

    h4. {{_i}}Heading 4{{/i}}

    +
    h5. {{_i}}Heading 5{{/i}}
    +
    h6. {{_i}}Heading 6{{/i}}
    +
    - {{! Body copy }} -

    {{_i}}Body copy{{/i}}

    -

    {{_i}}Bootstrap's global default font-size is 14px, with a line-height of 20px. This is applied to the <body> and all paragraphs. In addition, <p> (paragraphs) receive a bottom margin of half their line-height (9px by default).{{/i}}

    -
    -

    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.

    -

    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.

    -

    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.

    -
    + {{! Body copy }} +

    {{_i}}Body copy{{/i}}

    +

    {{_i}}Bootstrap's global default font-size is 14px, with a line-height of 20px. This is applied to the <body> and all paragraphs. In addition, <p> (paragraphs) receive a bottom margin of half their line-height (9px by default).{{/i}}

    +
    +

    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.

    +

    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.

    +

    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.

    +
    - {{! Body copy .lead }} -

    {{_i}}Lead body copy{{/i}}

    -

    {{_i}}Make a paragraph stand out by adding .lead.{{/i}}

    -
    -

    Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus.

    -
    + {{! Body copy .lead }} +

    {{_i}}Lead body copy{{/i}}

    +

    {{_i}}Make a paragraph stand out by adding .lead.{{/i}}

    +
    +

    Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus.

    +
    - {{! Using LESS }} -

    {{_i}}Built with Less{{/i}}

    -

    {{_i}}The typographic scale is based on two LESS variables in variables.less: @baseFontSize and @baseLineHeight. 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.{{/i}}

    + {{! Using LESS }} +

    {{_i}}Built with Less{{/i}}

    +

    {{_i}}The typographic scale is based on two LESS variables in variables.less: @baseFontSize and @baseLineHeight. 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.{{/i}}

    -
    +
    - {{! Emphasis }} -

    {{_i}}Emphasis{{/i}}

    -

    {{_i}}Make use of HTML's default emphasis tags, <strong> and <em>.{{/i}}

    + {{! Emphasis }} +

    {{_i}}Emphasis{{/i}}

    +

    {{_i}}Make use of HTML's default emphasis tags, <strong> and <em>.{{/i}}

    -

    <strong>

    -

    {{_i}}For emphasizing a snippet of text with important{{/i}}

    -
    -

    The following snippet of text is rendered as bold text.

    -
    +

    <strong>

    +

    {{_i}}For emphasizing a snippet of text with important{{/i}}

    +
    +

    The following snippet of text is rendered as bold text.

    +
     <strong>rendered as bold text</strong>
     
    -

    <em>

    -

    {{_i}}For emphasizing a snippet of text with stress{{/i}}

    -
    -

    The following snippet of text is rendered as italicized text.

    -
    -
    -    <em>rendered as italicized text</em>
    -    
    +

    <em>

    +

    {{_i}}For emphasizing a snippet of text with stress{{/i}}

    +
    +

    The following snippet of text is rendered as italicized text.

    +
    +
    +<em>rendered as italicized text</em>
    +
    -

    {{_i}}Heads up!{{/i}} {{_i}}Feel free to use <b> and <i> in HTML5. <b> is meant to highlight words or phrases without conveying additional importance while <i> is mostly for voice, technical terms, etc.{{/i}}

    +

    {{_i}}Heads up!{{/i}} {{_i}}Feel free to use <b> and <i> in HTML5. <b> is meant to highlight words or phrases without conveying additional importance while <i> is mostly for voice, technical terms, etc.{{/i}}

    -
    +
    - {{! Abbreviations }} -

    {{_i}}Abbreviations{{/i}}

    -

    {{_i}}Stylized implemenation of HTML's <abbr> element for abbreviations and acronyms to show the expanded version on hover. Abbreviations with a title attribute have a light dotted bottom border and a help cursor on hover, providing additional context on hover.{{/i}}

    + {{! Abbreviations }} +

    {{_i}}Abbreviations{{/i}}

    +

    {{_i}}Stylized implemenation of HTML's <abbr> element for abbreviations and acronyms to show the expanded version on hover. Abbreviations with a title attribute have a light dotted bottom border and a help cursor on hover, providing additional context on hover.{{/i}}

    -

    <abbr>

    -

    {{_i}}For expanded text on long hover of an abbreviation, include the title attribute.{{/i}}

    -
    -

    {{_i}}An abbreviation of the word attribute is attr.{{/i}}

    -
    +

    <abbr>

    +

    {{_i}}For expanded text on long hover of an abbreviation, include the title attribute.{{/i}}

    +
    +

    {{_i}}An abbreviation of the word attribute is attr.{{/i}}

    +
     <abbr title="attribute">attr</abbr>
     
    -

    <abbr class="initialism">

    -

    {{_i}}Add .initialism to an abbreviation for a slightly smaller font-size.{{/i}}

    -
    -

    {{_i}}HTML is the best thing since sliced bread.{{/i}}

    -
    +

    <abbr class="initialism">

    +

    {{_i}}Add .initialism to an abbreviation for a slightly smaller font-size.{{/i}}

    +
    +

    {{_i}}HTML is the best thing since sliced bread.{{/i}}

    +
     <abbr title="attribute" class="initialism">attr</abbr>
     
    -
    +
    - {{! Addresses }} -

    {{_i}}Addresses{{/i}}

    -

    {{_i}}Present contact information for the nearest ancestor or the entire body of work.{{/i}}

    + {{! Addresses }} +

    {{_i}}Addresses{{/i}}

    +

    {{_i}}Present contact information for the nearest ancestor or the entire body of work.{{/i}}

    -

    <address>

    -

    {{_i}}Preserve formatting by ending all lines with <br>.{{/i}}

    -
    -
    - Twitter, Inc.
    - 795 Folsom Ave, Suite 600
    - San Francisco, CA 94107
    - P: (123) 456-7890 -
    -
    - {{_i}}Full Name{{/i}}
    - {{_i}}first.last@gmail.com{{/i}} -
    -
    +

    <address>

    +

    {{_i}}Preserve formatting by ending all lines with <br>.{{/i}}

    +
    +
    + Twitter, Inc.
    + 795 Folsom Ave, Suite 600
    + San Francisco, CA 94107
    + P: (123) 456-7890 +
    +
    + {{_i}}Full Name{{/i}}
    + {{_i}}first.last@gmail.com{{/i}} +
    +
     <address>
       <strong>Twitter, Inc.</strong><br>
    @@ -154,37 +157,37 @@
     
    -
    +
    - {{! Blockquotes }} -

    {{_i}}Blockquotes{{/i}}

    -

    {{_i}}For quoting blocks of content from another source within your document.{{/i}}

    + {{! Blockquotes }} +

    {{_i}}Blockquotes{{/i}}

    +

    {{_i}}For quoting blocks of content from another source within your document.{{/i}}

    -

    {{_i}}Default blockqoute{{/i}}

    -

    {{_i}}Wrap <blockquote> around any HTML as the quote. For straight quotes we recommend a <p>.{{/i}}

    -
    -
    -

    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

    -
    -
    +

    {{_i}}Default blockqoute{{/i}}

    +

    {{_i}}Wrap <blockquote> around any HTML as the quote. For straight quotes we recommend a <p>.{{/i}}

    +
    +
    +

    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

    +
    +
     <blockquote>
       <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
     </blockquote>
     
    -

    {{_i}}Blockquote options{{/i}}

    -

    {{_i}}Style and content changes for simple variations on a standard blockquote.{{/i}}

    +

    {{_i}}Blockquote options{{/i}}

    +

    {{_i}}Style and content changes for simple variations on a standard blockquote.{{/i}}

    -

    {{_i}}Naming a source{{/i}}

    -

    {{_i}}Add <small> tag for identifying the source. Wrap the name of the source work in <cite>.{{/i}}

    -
    -
    -

    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

    - {{_i}}Someone famous in Source Title{{/i}} -
    -
    +

    {{_i}}Naming a source{{/i}}

    +

    {{_i}}Add <small> tag for identifying the source. Wrap the name of the source work in <cite>.{{/i}}

    +
    +
    +

    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

    + {{_i}}Someone famous in Source Title{{/i}} +
    +
     <blockquote>
       <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
    @@ -192,14 +195,14 @@
     </blockquote>
     
    -

    {{_i}}Alternate displays{{/i}}

    -

    {{_i}}Use .pull-left and .pull-right classes for floated, right-aligned blockquote content.{{/i}}

    -
    -
    -

    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

    - {{_i}}Someone famous in Source Title{{/i}} -
    -
    +

    {{_i}}Alternate displays{{/i}}

    +

    {{_i}}Use .pull-left and .pull-right classes for floated, right-aligned blockquote content.{{/i}}

    +
    +
    +

    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.

    + {{_i}}Someone famous in Source Title{{/i}} +
    +
     <blockquote class="pull-right">
       <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p>
    @@ -208,16 +211,63 @@
     
    -
    +
    - -

    {{_i}}Lists{{/i}}

    + +

    {{_i}}Lists{{/i}}

    -

    {{_i}}Unordered{{/i}}

    -

    {{_i}}A list of items in which the order does not explicitly matter.{{/i}}

    +

    {{_i}}Unordered{{/i}}

    +

    {{_i}}A list of items in which the order does not explicitly matter.{{/i}}

    +
    +
      +
    • Lorem ipsum dolor sit amet
    • +
    • Consectetur adipiscing elit
    • +
    • Integer molestie lorem at massa
    • +
    • Facilisis in pretium nisl aliquet
    • +
    • Nulla volutpat aliquam velit +
        +
      • Phasellus iaculis neque
      • +
      • Purus sodales ultricies
      • +
      • Vestibulum laoreet porttitor sem
      • +
      • Ac tristique libero volutpat at
      • +
      +
    • +
    • Faucibus porta lacus fringilla vel
    • +
    • Aenean sit amet erat nunc
    • +
    • Eget porttitor lorem
    • +
    +
    +
    +<ul>
    +  <li>...</li>
    +</ul>
    +
    + +

    {{_i}}Ordered{{/i}}

    +

    {{_i}}A list of items in which the order does explicitly matter.{{/i}}

    +
    +
      +
    1. Lorem ipsum dolor sit amet
    2. +
    3. Consectetur adipiscing elit
    4. +
    5. Integer molestie lorem at massa
    6. +
    7. Facilisis in pretium nisl aliquet
    8. +
    9. Nulla volutpat aliquam velit
    10. +
    11. Faucibus porta lacus fringilla vel
    12. +
    13. Aenean sit amet erat nunc
    14. +
    15. Eget porttitor lorem
    16. +
    +
    +
    +<ol>
    +  <li>...</li>
    +</ol>
    +
    + +

    {{_i}}Unstyled{{/i}}

    +

    {{_i}}A list of items with no list-style or additional left padding.{{/i}}

    -
      +
      • Lorem ipsum dolor sit amet
      • Consectetur adipiscing elit
      • Integer molestie lorem at massa
      • @@ -236,71 +286,24 @@
    -<ul>
    -  <li>...</li>
    -</ul>
    -
    - -

    {{_i}}Ordered{{/i}}

    -

    {{_i}}A list of items in which the order does explicitly matter.{{/i}}

    -
    -
      -
    1. Lorem ipsum dolor sit amet
    2. -
    3. Consectetur adipiscing elit
    4. -
    5. Integer molestie lorem at massa
    6. -
    7. Facilisis in pretium nisl aliquet
    8. -
    9. Nulla volutpat aliquam velit
    10. -
    11. Faucibus porta lacus fringilla vel
    12. -
    13. Aenean sit amet erat nunc
    14. -
    15. Eget porttitor lorem
    16. -
    -
    -
    -<ol>
    -  <li>...</li>
    -</ol>
    -
    - -

    {{_i}}Unstyled{{/i}}

    -

    {{_i}}A list of items with no list-style or additional left padding.{{/i}}

    -
    -
      -
    • Lorem ipsum dolor sit amet
    • -
    • Consectetur adipiscing elit
    • -
    • Integer molestie lorem at massa
    • -
    • Facilisis in pretium nisl aliquet
    • -
    • Nulla volutpat aliquam velit -
        -
      • Phasellus iaculis neque
      • -
      • Purus sodales ultricies
      • -
      • Vestibulum laoreet porttitor sem
      • -
      • Ac tristique libero volutpat at
      • -
      -
    • -
    • Faucibus porta lacus fringilla vel
    • -
    • Aenean sit amet erat nunc
    • -
    • Eget porttitor lorem
    • -
    -
    -
     <ul class="unstyled">
       <li>...</li>
     </ul>
     
    -

    {{_i}}Description{{/i}}

    -

    {{_i}}A list of terms with their associated descriptions.{{/i}}

    -
    -
    -
    {{_i}}Description lists{{/i}}
    -
    {{_i}}A description list is perfect for defining terms.{{/i}}
    -
    Euismod
    -
    Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.
    -
    Donec id elit non mi porta gravida at eget metus.
    -
    Malesuada porta
    -
    Etiam porta sem malesuada magna mollis euismod.
    -
    -
    +

    {{_i}}Description{{/i}}

    +

    {{_i}}A list of terms with their associated descriptions.{{/i}}

    +
    +
    +
    {{_i}}Description lists{{/i}}
    +
    {{_i}}A description list is perfect for defining terms.{{/i}}
    +
    Euismod
    +
    Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.
    +
    Donec id elit non mi porta gravida at eget metus.
    +
    Malesuada porta
    +
    Etiam porta sem malesuada magna mollis euismod.
    +
    +
     <dl>
       <dt>...</dt>
    @@ -308,50 +311,50 @@
     </dl>
     
    -

    {{_i}}Horizontal description{{/i}}

    -

    {{_i}}Make terms and descriptions in <dl> line up side-by-side.{{/i}}

    -
    -
    -
    {{_i}}Description lists{{/i}}
    -
    {{_i}}A description list is perfect for defining terms.{{/i}}
    -
    Euismod
    -
    Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.
    -
    Donec id elit non mi porta gravida at eget metus.
    -
    Malesuada porta
    -
    Etiam porta sem malesuada magna mollis euismod.
    -
    Felis euismod semper eget lacinia
    -
    Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.
    -
    -
    +

    {{_i}}Horizontal description{{/i}}

    +

    {{_i}}Make terms and descriptions in <dl> line up side-by-side.{{/i}}

    +
    +
    +
    {{_i}}Description lists{{/i}}
    +
    {{_i}}A description list is perfect for defining terms.{{/i}}
    +
    Euismod
    +
    Vestibulum id ligula porta felis euismod semper eget lacinia odio sem nec elit.
    +
    Donec id elit non mi porta gravida at eget metus.
    +
    Malesuada porta
    +
    Etiam porta sem malesuada magna mollis euismod.
    +
    Felis euismod semper eget lacinia
    +
    Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus.
    +
    +
     <dl class="dl-horizontal">
       <dt>...</dt>
       <dd>...</dd>
     </dl>
     
    -

    - {{_i}}Heads up!{{/i}} - {{_i}}Horizontal description lists will truncate terms that are too long to fit in the left column fix text-overflow. In narrower viewports, they will change to the default stacked layout.{{/i}} -

    -
    +

    + {{_i}}Heads up!{{/i}} + {{_i}}Horizontal description lists will truncate terms that are too long to fit in the left column fix text-overflow. In narrower viewports, they will change to the default stacked layout.{{/i}} +

    +
    - -
    - + +
    + -

    Inline

    -

    Wrap inline snippets of code with <code>.

    +

    Inline

    +

    Wrap inline snippets of code with <code>.

     {{_i}}For example, <code>section</code> should be wrapped as inline.{{/i}}
     
    -

    Basic block

    -

    {{_i}}Use <pre> for multiple lines of code. Be sure to escape any angle brackets in the code for proper rendering.{{/i}}

    +

    Basic block

    +

    {{_i}}Use <pre> for multiple lines of code. Be sure to escape any angle brackets in the code for proper rendering.{{/i}}

     <p>{{_i}}Sample text here...{{/i}}</p>
     
    @@ -360,53 +363,53 @@ &lt;p&gt;{{_i}}Sample text here...{{/i}}&lt;/p&gt; </pre> -

    {{_i}}Note: Be sure to keep code within <pre> tags as close to the left as possible; it will render all tabs.{{/i}}

    -

    {{_i}}You may optionally add the .pre-scrollable class which will set a max-height of 350px and provide a y-axis scrollbar.{{/i}}

    -
    +

    {{_i}}Note: Be sure to keep code within <pre> tags as close to the left as possible; it will render all tabs.{{/i}}

    +

    {{_i}}You may optionally add the .pre-scrollable class which will set a max-height of 350px and provide a y-axis scrollbar.{{/i}}

    +
    - -
    - + +
    + -

    {{_i}}Default styles{{/i}}

    -

    {{_i}}For basic styling—light padding and only horizontal dividers—add the base class .table to any <table>.{{/i}}

    -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    #{{_i}}First Name{{/i}}{{_i}}Last Name{{/i}}{{_i}}Username{{/i}}
    1MarkOtto@mdo
    2JacobThornton@fat
    3Larrythe Bird@twitter
    -
    {{! /example }} +

    {{_i}}Default styles{{/i}}

    +

    {{_i}}For basic styling—light padding and only horizontal dividers—add the base class .table to any <table>.{{/i}}

    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    #{{_i}}First Name{{/i}}{{_i}}Last Name{{/i}}{{_i}}Username{{/i}}
    1MarkOtto@mdo
    2JacobThornton@fat
    3Larrythe Bird@twitter
    +
    {{! /example }}
     <table class="table">
       …
    @@ -414,168 +417,168 @@
     
    -
    +
    -

    {{_i}}Optional classes{{/i}}

    -

    {{_i}}Add any of the follow classes to the .table base class.{{/i}}

    +

    {{_i}}Optional classes{{/i}}

    +

    {{_i}}Add any of the follow classes to the .table base class.{{/i}}

    -

    {{_i}}.table-striped{{/i}}

    -

    {{_i}}Adds zebra-striping to any table row within the <tbody> via the :nth-child CSS selector (not available in IE7-IE8).{{/i}}

    -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    #{{_i}}First Name{{/i}}{{_i}}Last Name{{/i}}{{_i}}Username{{/i}}
    1MarkOtto@mdo
    2JacobThornton@fat
    3Larrythe Bird@twitter
    -
    {{! /example }} +

    {{_i}}.table-striped{{/i}}

    +

    {{_i}}Adds zebra-striping to any table row within the <tbody> via the :nth-child CSS selector (not available in IE7-IE8).{{/i}}

    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    #{{_i}}First Name{{/i}}{{_i}}Last Name{{/i}}{{_i}}Username{{/i}}
    1MarkOtto@mdo
    2JacobThornton@fat
    3Larrythe Bird@twitter
    +
    {{! /example }}
     <table class="table table-striped">
       …
     </table>
     
    -

    {{_i}}.table-bordered{{/i}}

    -

    {{_i}}Add borders and rounded corners to the table.{{/i}}

    -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    #{{_i}}First Name{{/i}}{{_i}}Last Name{{/i}}{{_i}}Username{{/i}}
    1MarkOtto@mdo
    MarkOtto@TwBootstrap
    2JacobThornton@fat
    3Larry the Bird@twitter
    -
    {{! /example }} +

    {{_i}}.table-bordered{{/i}}

    +

    {{_i}}Add borders and rounded corners to the table.{{/i}}

    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    #{{_i}}First Name{{/i}}{{_i}}Last Name{{/i}}{{_i}}Username{{/i}}
    1MarkOtto@mdo
    MarkOtto@TwBootstrap
    2JacobThornton@fat
    3Larry the Bird@twitter
    +
    {{! /example }}
     <table class="table table-bordered">
       …
     </table>
     
    -

    {{_i}}.table-hover{{/i}}

    -

    {{_i}}Enable a hover state on table rows within a <tbody>.{{/i}}

    -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    #{{_i}}First Name{{/i}}{{_i}}Last Name{{/i}}{{_i}}Username{{/i}}
    1MarkOtto@mdo
    2JacobThornton@fat
    3Larry the Bird@twitter
    -
    {{! /example }} +

    {{_i}}.table-hover{{/i}}

    +

    {{_i}}Enable a hover state on table rows within a <tbody>.{{/i}}

    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    #{{_i}}First Name{{/i}}{{_i}}Last Name{{/i}}{{_i}}Username{{/i}}
    1MarkOtto@mdo
    2JacobThornton@fat
    3Larry the Bird@twitter
    +
    {{! /example }}
     <table class="table table-hover">
       …
     </table>
     
    -

    {{_i}}.table-condensed{{/i}}

    -

    {{_i}}Makes tables more compact by cutting cell padding in half.{{/i}}

    -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    #{{_i}}First Name{{/i}}{{_i}}Last Name{{/i}}{{_i}}Username{{/i}}
    1MarkOtto@mdo
    2JacobThornton@fat
    3Larry the Bird@twitter
    -
    {{! /example }} +

    {{_i}}.table-condensed{{/i}}

    +

    {{_i}}Makes tables more compact by cutting cell padding in half.{{/i}}

    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    #{{_i}}First Name{{/i}}{{_i}}Last Name{{/i}}{{_i}}Username{{/i}}
    1MarkOtto@mdo
    2JacobThornton@fat
    3Larry the Bird@twitter
    +
    {{! /example }}
     <table class="table table-condensed">
       …
    @@ -583,82 +586,82 @@
     
    -
    +
    -

    {{_i}}Supported table markup{{/i}}

    -

    {{_i}}List of supported table HTML elements and how they should be used.{{/i}}

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    {{_i}}Tag{{/i}}{{_i}}Description{{/i}}
    - <table> - - {{_i}}Wrapping element for displaying data in a tabular format{{/i}} -
    - <thead> - - {{_i}}Container element for table header rows (<tr>) to label table columns{{/i}} -
    - <tbody> - - {{_i}}Container element for table rows (<tr>) in the body of the table{{/i}} -
    - <tr> - - {{_i}}Container element for a set of table cells (<td> or <th>) that appears on a single row{{/i}} -
    - <td> - - {{_i}}Default table cell{{/i}} -
    - <th> - - {{_i}}Special table cell for column (or row, depending on scope and placement) labels{{/i}}
    - {{_i}}Must be used within a <thead>{{/i}} -
    - <caption> - - {{_i}}Description or summary of what the table holds, especially useful for screen readers{{/i}} -
    +

    {{_i}}Supported table markup{{/i}}

    +

    {{_i}}List of supported table HTML elements and how they should be used.{{/i}}

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    {{_i}}Tag{{/i}}{{_i}}Description{{/i}}
    + <table> + + {{_i}}Wrapping element for displaying data in a tabular format{{/i}} +
    + <thead> + + {{_i}}Container element for table header rows (<tr>) to label table columns{{/i}} +
    + <tbody> + + {{_i}}Container element for table rows (<tr>) in the body of the table{{/i}} +
    + <tr> + + {{_i}}Container element for a set of table cells (<td> or <th>) that appears on a single row{{/i}} +
    + <td> + + {{_i}}Default table cell{{/i}} +
    + <th> + + {{_i}}Special table cell for column (or row, depending on scope and placement) labels{{/i}}
    + {{_i}}Must be used within a <thead>{{/i}} +
    + <caption> + + {{_i}}Description or summary of what the table holds, especially useful for screen readers{{/i}} +
     <table>
       <thead>
    @@ -676,29 +679,29 @@
     </table>
     
    -
    +
    - -
    - + +
    + -

    {{_i}}Default styles{{/i}}

    -

    {{_i}}Individual form controls receive styling, but without any required base class on the <form> or large changes in markup. Results in stacked, left-aligned labels on top of form controls.{{/i}}

    -
    - Legend - - -

    {{_i}}Example block-level help text here.{{/i}}

    - - -
    {{! /example }} +

    {{_i}}Default styles{{/i}}

    +

    {{_i}}Individual form controls receive styling, but without any required base class on the <form> or large changes in markup. Results in stacked, left-aligned labels on top of form controls.{{/i}}

    +
    + Legend + + +

    {{_i}}Example block-level help text here.{{/i}}

    + + +
    {{! /example }}
     <form class="well">
       <label>{{_i}}Label name{{/i}}</label>
    @@ -712,18 +715,18 @@
     
    -
    +
    -

    {{_i}}Optional layouts{{/i}}

    -

    {{_i}}Included with Bootstrap are three optional form layouts for common use cases.{{/i}}

    +

    {{_i}}Optional layouts{{/i}}

    +

    {{_i}}Included with Bootstrap are three optional form layouts for common use cases.{{/i}}

    -

    {{_i}}Search form{{/i}}

    -

    {{_i}}Add .form-search to the form and .search-query to the <input> for an extra-rounded text input.{{/i}}

    - {{! /example }} +

    {{_i}}Search form{{/i}}

    +

    {{_i}}Add .form-search to the form and .search-query to the <input> for an extra-rounded text input.{{/i}}

    + {{! /example }}
     <form class="form-search">
       <input type="text" class="input-medium search-query">
    @@ -731,16 +734,16 @@
     </form>
     
    -

    {{_i}}Inline form{{/i}}

    -

    {{_i}}Add .form-inline for left-aligned labels and inline-block controls for a compact layout.{{/i}}

    -
    - - - - -
    {{! /example }} +

    {{_i}}Inline form{{/i}}

    +

    {{_i}}Add .form-inline for left-aligned labels and inline-block controls for a compact layout.{{/i}}

    +
    + + + + +
    {{! /example }}
     <form class="form-inline">
       <input type="text" class="input-small" placeholder="{{_i}}Email{{/i}}">
    @@ -752,37 +755,37 @@
     </form>
     
    -

    {{_i}}Horizontal form{{/i}}

    -

    {{_i}}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:{{/i}}

    -
      -
    • {{_i}}Add .form-horizontal to the form{{/i}}
    • -
    • {{_i}}Wrap labels and controls in .control-group{{/i}}
    • -
    • {{_i}}Add .control-label to the label{{/i}}
    • -
    • {{_i}}Wrap any associated controls in .controls for proper alignment{{/i}}
    • -
    -
    - Legend -
    - -
    - +

    {{_i}}Horizontal form{{/i}}

    +

    {{_i}}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:{{/i}}

    +
      +
    • {{_i}}Add .form-horizontal to the form{{/i}}
    • +
    • {{_i}}Wrap labels and controls in .control-group{{/i}}
    • +
    • {{_i}}Add .control-label to the label{{/i}}
    • +
    • {{_i}}Wrap any associated controls in .controls for proper alignment{{/i}}
    • +
    + + Legend +
    + +
    + +
    -
    -
    - -
    - +
    + +
    + +
    -
    -
    -
    - - +
    +
    + + +
    -
    - +
     <form class="form-horizontal">
       <div class="control-group">
    @@ -809,49 +812,49 @@
     
    -
    +
    -

    {{_i}}Supported form controls{{/i}}

    -

    {{_i}}Examples of standard form controls supported in an example form layout.{{/i}}

    +

    {{_i}}Supported form controls{{/i}}

    +

    {{_i}}Examples of standard form controls supported in an example form layout.{{/i}}

    -

    {{_i}}Inputs{{/i}}

    -

    {{_i}}Most common form control, text-based input fields. Includes support for all HTML5 types: text, password, datetime, datetime-local, date, month, time, week, number, email, url, search, tel, and color.{{/i}}

    -

    {{_i}}Requires the use of a specified type at all times.{{/i}}

    -
    - -
    +

    {{_i}}Inputs{{/i}}

    +

    {{_i}}Most common form control, text-based input fields. Includes support for all HTML5 types: text, password, datetime, datetime-local, date, month, time, week, number, email, url, search, tel, and color.{{/i}}

    +

    {{_i}}Requires the use of a specified type at all times.{{/i}}

    +
    + +
     <input type="text" placeholder="Text input">
     
    -

    {{_i}}Textarea{{/i}}

    -

    {{_i}}Form control which supports multiple lines of text. Change row attribute as necessary.{{/i}}

    -
    - -
    +

    {{_i}}Textarea{{/i}}

    +

    {{_i}}Form control which supports multiple lines of text. Change row attribute as necessary.{{/i}}

    +
    + +
     <textarea id="textarea" rows="3"></textarea>
     
    -

    {{_i}}Checkboxes and radios{{/i}}

    -

    {{_i}}Checkboxes are for selecting one or several options in a list while radios are for selecting one option from many.{{/i}}

    -

    {{_i}}Default (stacked){{/i}}

    -
    - -
    - - -
    +

    {{_i}}Checkboxes and radios{{/i}}

    +

    {{_i}}Checkboxes are for selecting one or several options in a list while radios are for selecting one option from many.{{/i}}

    +

    {{_i}}Default (stacked){{/i}}

    +
    + +
    + + +
     <label class="checkbox">
       <input type="checkbox" value="">
    @@ -868,19 +871,19 @@
     </label>
     
    -

    {{_i}}Inline checkboxes{{/i}}

    -

    {{_i}}Add the .inline class to a series of checkboxes or radios for controls appear on the same line.{{/i}}

    -
    - - - -
    +

    {{_i}}Inline checkboxes{{/i}}

    +

    {{_i}}Add the .inline class to a series of checkboxes or radios for controls appear on the same line.{{/i}}

    +
    + + + +
     <label class="checkbox inline">
       <input type="checkbox" id="inlineCheckbox1" value="option1"> 1
    @@ -893,25 +896,25 @@
     </label>
     
    -

    {{_i}}Selects{{/i}}

    -

    {{_i}}Use the default option or specify a multiple="multiple" to show multiple options at once.{{/i}}

    -
    - -
    - -
    +

    {{_i}}Selects{{/i}}

    +

    {{_i}}Use the default option or specify a multiple="multiple" to show multiple options at once.{{/i}}

    +
    + +
    + +
     <select>
       <option>something</option>
    @@ -931,28 +934,28 @@
     
    -
    +
    -

    {{_i}}Extending form controls{{/i}}

    -

    {{_i}}Adding on top of existing browser controls, Bootstrap includes other useful form components.{{/i}}

    +

    {{_i}}Extending form controls{{/i}}

    +

    {{_i}}Adding on top of existing browser controls, Bootstrap includes other useful form components.{{/i}}

    -

    {{_i}}Prepended and appended inputs{{/i}}

    -

    {{_i}}Add text or buttons before or after any text-based input. Do note that select elements are not supported here.{{/i}}

    +

    {{_i}}Prepended and appended inputs{{/i}}

    +

    {{_i}}Add text or buttons before or after any text-based input. Do note that select elements are not supported here.{{/i}}

    -

    {{_i}}Default options{{/i}}

    -

    {{_i}}Wrap a .add-on and an input with one of two classes to prepend or append text to an input.{{/i}}

    -
    -
    - @ - -
    -
    -
    - - .00 -
    -
    +

    {{_i}}Default options{{/i}}

    +

    {{_i}}Wrap a .add-on and an input with one of two classes to prepend or append text to an input.{{/i}}

    +
    +
    + @ + +
    +
    +
    + + .00 +
    +
     <div class="input-prepend">
       <span class="add-on">@</span><input class="span2" id="prependedInput" size="16" type="text" placeholder="{{_i}}Username{{/i}}">
    @@ -962,35 +965,35 @@
     </div>
     
    -

    {{_i}}Combined{{/i}}

    -

    {{_i}}Use both classes and two instances of .add-on to prepend and append an input.{{/i}}

    -
    -
    - $ - - .00 -
    -
    +

    {{_i}}Combined{{/i}}

    +

    {{_i}}Use both classes and two instances of .add-on to prepend and append an input.{{/i}}

    +
    +
    + $ + + .00 +
    +
     <div class="input-prepend input-append">
       <span class="add-on">$</span><input class="span2" id="appendedPrependedInput" size="16" type="text"><span class="add-on">.00</span>
     </div>
     
    -

    {{_i}}Buttons instead of text{{/i}}

    -

    {{_i}}Instead of a <span> with text, use a .btn to attach a button (or two) to an input.{{/i}}

    -
    -
    - - -
    -
    -
    - - - -
    -
    +

    {{_i}}Buttons instead of text{{/i}}

    +

    {{_i}}Instead of a <span> with text, use a .btn to attach a button (or two) to an input.{{/i}}

    +
    +
    + + +
    +
    +
    + + + +
    +
     <div class="input-append">
       <input class="span2" id="appendedInputButton" size="16" type="text"><button class="btn" type="button">Go!</button>
    @@ -1001,17 +1004,17 @@
     </div>
     
    -

    {{_i}}Search form{{/i}}

    - {{! /example }} +

    {{_i}}Search form{{/i}}

    + {{! /example }}
     <form class="form-search">
       <input type="text" class="span2 search-query">
    @@ -1019,20 +1022,20 @@
     </form>
     
    -

    {{_i}}Control sizing{{/i}}

    -

    {{_i}}Use relative sizing classes like .input-large or match your inputs to the grid column sizes using .span* classes.{{/i}}

    +

    {{_i}}Control sizing{{/i}}

    +

    {{_i}}Use relative sizing classes like .input-large or match your inputs to the grid column sizes using .span* classes.{{/i}}

    -

    {{_i}}Relative sizing{{/i}}

    -
    -
    - - - - - - -
    -
    +

    {{_i}}Relative sizing{{/i}}

    +
    +
    + + + + + + +
    +
     <input class="input-mini" type="text">
     <input class="input-small" type="text">
    @@ -1041,68 +1044,68 @@
     <input class="input-xlarge" type="text">
     <input class="input-xxlarge" type="text">
     
    -

    - {{_i}}Heads up!{{/i}} In future versions, we'll be altering the use of these relative input classes to match our button sizes. For example, .input-large will increase the padding and font-size of an input. -

    +

    + {{_i}}Heads up!{{/i}} In future versions, we'll be altering the use of these relative input classes to match our button sizes. For example, .input-large will increase the padding and font-size of an input. +

    -

    {{_i}}Grid sizing{{/i}}

    -

    {{_i}}Use .span1 to .span12 for inputs that match the same sizes of the grid columns.{{/i}}

    -
    -
    - - - - - - -
    -
    +

    {{_i}}Grid sizing{{/i}}

    +

    {{_i}}Use .span1 to .span12 for inputs that match the same sizes of the grid columns.{{/i}}

    +
    +
    + + + + + + +
    +
     <input class="span1" type="text">
     <input class="span2" type="text">
     <input class="span3" type="text">
     
    -

    {{_i}}For multiple grid inputs per line, use the .controls-row modifier class for proper spacing. It floats the inputs to collapse white-space, sets the proper margins, and the clears the float.{{/i}}

    -
    -
    - -
    -
    - - -
    -
    - - -
    -
    - - -
    -
    - - -
    -
    +

    {{_i}}For multiple grid inputs per line, use the .controls-row modifier class for proper spacing. It floats the inputs to collapse white-space, sets the proper margins, and the clears the float.{{/i}}

    +
    +
    + +
    +
    + + +
    +
    + + +
    +
    + + +
    +
    + + +
    +
     <div class="controls controls-row">
       <input class="span4" type="text" placeholder=".span4">
    @@ -1110,23 +1113,23 @@
     </div>
     
    -

    {{_i}}Uneditable inputs{{/i}}

    -

    {{_i}}Present data in a form that's not editable without using actual form markup.{{/i}}

    -
    - Some value here -
    +

    {{_i}}Uneditable inputs{{/i}}

    +

    {{_i}}Present data in a form that's not editable without using actual form markup.{{/i}}

    +
    + Some value here +
       <span class="input-xlarge uneditable-input">Some value here</span>
     
    -

    {{_i}}Form actions{{/i}}

    -

    {{_i}}End a form with a group of actions (buttons). When placed within a .form-horizontal, the buttons will automatically indent to line up with the form controls.{{/i}}

    -
    -
    - - -
    -
    +

    {{_i}}Form actions{{/i}}

    +

    {{_i}}End a form with a group of actions (buttons). When placed within a .form-horizontal, the buttons will automatically indent to line up with the form controls.{{/i}}

    +
    +
    + + +
    +
     <div class="form-actions">
       <button type="submit" class="btn btn-primary">{{_i}}Save changes{{/i}}</button>
    @@ -1134,76 +1137,76 @@
     </div>
     
    -

    {{_i}}Help text{{/i}}

    -

    {{_i}}Inline and block level support for help text that appears around form controls.{{/i}}

    -

    {{_i}}Inline help{{/i}}

    -
    - Inline help text -
    +

    {{_i}}Help text{{/i}}

    +

    {{_i}}Inline and block level support for help text that appears around form controls.{{/i}}

    +

    {{_i}}Inline help{{/i}}

    +
    + Inline help text +
     <span class="help-inline">Inline help text</span>
     
    -

    {{_i}}Block help{{/i}}

    -
    - - A longer block of help text that breaks onto a new line and may extend beyond one line. -
    +

    {{_i}}Block help{{/i}}

    +
    + + A longer block of help text that breaks onto a new line and may extend beyond one line. +
     <span class="help-block">A longer block of help text that breaks onto a new line and may extend beyond one line.</span>
     
    -
    +
    -

    {{_i}}Form control states{{/i}}

    -

    {{_i}}Provide feedback to users or visitors with basic feedback states on form controls and labels.{{/i}}

    +

    {{_i}}Form control states{{/i}}

    +

    {{_i}}Provide feedback to users or visitors with basic feedback states on form controls and labels.{{/i}}

    -

    {{_i}}Input focus{{/i}}

    -

    {{_i}}We remove the default outline styles on some form controls and apply a box-shadow in its place for :focus.{{/i}}

    -
    - -
    +

    {{_i}}Input focus{{/i}}

    +

    {{_i}}We remove the default outline styles on some form controls and apply a box-shadow in its place for :focus.{{/i}}

    +
    + +
     <input class="input-xlarge" id="focusedInput" type="text" value="{{_i}}This is focused...{{/i}}">
     
    -

    {{_i}}Disabled inputs{{/i}}

    -

    {{_i}}Add the disabled attribute on an input to prevent user input and trigger a slightly different look.{{/i}}

    -
    - -
    +

    {{_i}}Disabled inputs{{/i}}

    +

    {{_i}}Add the disabled attribute on an input to prevent user input and trigger a slightly different look.{{/i}}

    +
    + +
     <input class="input-xlarge" id="disabledInput" type="text" placeholder="{{_i}}Disabled input here...{{/i}}" disabled>
     
    -

    {{_i}}Validation states{{/i}}

    -

    {{_i}}Bootstrap includes validation styles for error, warning, and success messages. To use, add the appropriate class to the surrounding .control-group.{{/i}}

    +

    {{_i}}Validation states{{/i}}

    +

    {{_i}}Bootstrap includes validation styles for error, warning, and success messages. To use, add the appropriate class to the surrounding .control-group.{{/i}}

    -
    -
    - -
    - - {{_i}}Something may have gone wrong{{/i}} + +
    + +
    + + {{_i}}Something may have gone wrong{{/i}} +
    -
    -
    - -
    - - {{_i}}Please correct the error{{/i}} +
    + +
    + + {{_i}}Please correct the error{{/i}} +
    -
    -
    - -
    - - {{_i}}Woohoo!{{/i}} +
    + +
    + + {{_i}}Woohoo!{{/i}} +
    -
    - +
     <div class="control-group warning">
       <label class="control-label" for="inputWarning">{{_i}}Input with warning{{/i}}</label>
    @@ -1228,133 +1231,133 @@
     </div>
     
    -
    +
    - -
    - + +
    + -

    Default buttons

    -

    {{_i}}Button styles can be applied to anything with the .btn class applied. However, typically you'll want to apply these to only <a> and <button> elements for the best rendering.{{/i}}

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    {{_i}}Button{{/i}}{{_i}}class=""{{/i}}{{_i}}Description{{/i}}
    btn{{_i}}Standard gray button with gradient{{/i}}
    btn btn-primary{{_i}}Provides extra visual weight and identifies the primary action in a set of buttons{{/i}}
    btn btn-info{{_i}}Used as an alternative to the default styles{{/i}}
    btn btn-success{{_i}}Indicates a successful or positive action{{/i}}
    btn btn-warning{{_i}}Indicates caution should be taken with this action{{/i}}
    btn btn-danger{{_i}}Indicates a dangerous or potentially negative action{{/i}}
    btn btn-inverse{{_i}}Alternate dark gray button, not tied to a semantic action or use{{/i}}
    +

    Default buttons

    +

    {{_i}}Button styles can be applied to anything with the .btn class applied. However, typically you'll want to apply these to only <a> and <button> elements for the best rendering.{{/i}}

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    {{_i}}Button{{/i}}{{_i}}class=""{{/i}}{{_i}}Description{{/i}}
    btn{{_i}}Standard gray button with gradient{{/i}}
    btn btn-primary{{_i}}Provides extra visual weight and identifies the primary action in a set of buttons{{/i}}
    btn btn-info{{_i}}Used as an alternative to the default styles{{/i}}
    btn btn-success{{_i}}Indicates a successful or positive action{{/i}}
    btn btn-warning{{_i}}Indicates caution should be taken with this action{{/i}}
    btn btn-danger{{_i}}Indicates a dangerous or potentially negative action{{/i}}
    btn btn-inverse{{_i}}Alternate dark gray button, not tied to a semantic action or use{{/i}}
    -

    {{_i}}Cross browser compatibility{{/i}}

    -

    {{_i}}IE9 doesn't crop background gradients on rounded corners, so we remove it. Related, IE9 jankifies disabled button elements, rendering text gray with a nasty text-shadow that we cannot fix.{{/i}}

    +

    {{_i}}Cross browser compatibility{{/i}}

    +

    {{_i}}IE9 doesn't crop background gradients on rounded corners, so we remove it. Related, IE9 jankifies disabled button elements, rendering text gray with a nasty text-shadow that we cannot fix.{{/i}}

    -
    +
    -

    {{_i}}Button sizes{{/i}}

    -

    {{_i}}Fancy larger or smaller buttons? Add .btn-large, .btn-small, or .btn-mini for two additional sizes.{{/i}}

    -

    - - -

    -

    - - -

    -

    - - -

    +

    {{_i}}Button sizes{{/i}}

    +

    {{_i}}Fancy larger or smaller buttons? Add .btn-large, .btn-small, or .btn-mini for two additional sizes.{{/i}}

    +

    + + +

    +

    + + +

    +

    + + +

    -
    +
    -

    {{_i}}Disabled state{{/i}}

    -

    {{_i}}Make buttons look unclickable by fading them back 50%.{{/i}}

    +

    {{_i}}Disabled state{{/i}}

    +

    {{_i}}Make buttons look unclickable by fading them back 50%.{{/i}}

    -

    Anchor element

    -

    {{_i}}Add the .disabled class to <a> buttons.{{/i}}

    -

    - {{_i}}Primary link{{/i}} - {{_i}}Link{{/i}} -

    +

    Anchor element

    +

    {{_i}}Add the .disabled class to <a> buttons.{{/i}}

    +

    + {{_i}}Primary link{{/i}} + {{_i}}Link{{/i}} +

     <a href="#" class="btn btn-large btn-primary disabled">{{_i}}Primary link{{/i}}</a>
     <a href="#" class="btn btn-large disabled">{{_i}}Link{{/i}}</a>
     
    -

    - {{_i}}Heads up!{{/i}} - {{_i}}We use .disabled as a utility class here, similar to the common .active class, so no prefix is required.{{/i}} -

    +

    + {{_i}}Heads up!{{/i}} + {{_i}}We use .disabled as a utility class here, similar to the common .active class, so no prefix is required.{{/i}} +

    -

    Button element

    -

    {{_i}}Add the disabled attribute to <button> buttons.{{/i}}

    -

    - - -

    +

    Button element

    +

    {{_i}}Add the disabled attribute to <button> buttons.{{/i}}

    +

    + + +

     <button type="button" class="btn btn-large btn-primary disabled" disabled="disabled">{{_i}}Primary button{{/i}}</button>
     <button type="button" class="btn btn-large" disabled>{{_i}}Button{{/i}}</button>
     
    -
    +
    -

    {{_i}}One class, multiple tags{{/i}}

    -

    {{_i}}Use the .btn class on an <a>, <button>, or <input> element.{{/i}}

    -
    - {{_i}}Link{{/i}} - - - -
    +

    {{_i}}One class, multiple tags{{/i}}

    +

    {{_i}}Use the .btn class on an <a>, <button>, or <input> element.{{/i}}

    +
    + {{_i}}Link{{/i}} + + + +
     <a class="btn" href="">{{_i}}Link{{/i}}</a>
     <button class="btn" type="submit">
    @@ -1365,246 +1368,248 @@
     <input class="btn" type="submit"
              value="{{_i}}Submit{{/i}}">
     
    -

    {{_i}}As a best practice, try to match the element for you context to ensure matching cross-browser rendering. If you have an input, use an <input type="submit"> for your button.{{/i}}

    +

    {{_i}}As a best practice, try to match the element for you context to ensure matching cross-browser rendering. If you have an input, use an <input type="submit"> for your button.{{/i}}

    -
    +
    - -
    - + +
    + -

    {{_i}}Icon glyphs{{/i}}

    -

    {{_i}}140 icons in sprite form, available in dark gray (default) and white, provided by Glyphicons.{{/i}}

    -
      -
    • icon-glass
    • -
    • icon-music
    • -
    • icon-search
    • -
    • icon-envelope
    • -
    • icon-heart
    • -
    • icon-star
    • -
    • icon-star-empty
    • -
    • icon-user
    • -
    • icon-film
    • -
    • icon-th-large
    • -
    • icon-th
    • -
    • icon-th-list
    • -
    • icon-ok
    • -
    • icon-remove
    • -
    • icon-zoom-in
    • -
    • icon-zoom-out
    • -
    • icon-off
    • -
    • icon-signal
    • -
    • icon-cog
    • -
    • icon-trash
    • -
    • icon-home
    • -
    • icon-file
    • -
    • icon-time
    • -
    • icon-road
    • -
    • icon-download-alt
    • -
    • icon-download
    • -
    • icon-upload
    • -
    • icon-inbox
    • +

      {{_i}}Icon glyphs{{/i}}

      +

      {{_i}}140 icons in sprite form, available in dark gray (default) and white, provided by Glyphicons.{{/i}}

      +
        +
      • icon-glass
      • +
      • icon-music
      • +
      • icon-search
      • +
      • icon-envelope
      • +
      • icon-heart
      • +
      • icon-star
      • +
      • icon-star-empty
      • +
      • icon-user
      • +
      • icon-film
      • +
      • icon-th-large
      • +
      • icon-th
      • +
      • icon-th-list
      • +
      • icon-ok
      • +
      • icon-remove
      • +
      • icon-zoom-in
      • +
      • icon-zoom-out
      • +
      • icon-off
      • +
      • icon-signal
      • +
      • icon-cog
      • +
      • icon-trash
      • +
      • icon-home
      • +
      • icon-file
      • +
      • icon-time
      • +
      • icon-road
      • +
      • icon-download-alt
      • +
      • icon-download
      • +
      • icon-upload
      • +
      • icon-inbox
      • -
      • icon-play-circle
      • -
      • icon-repeat
      • -
      • icon-refresh
      • -
      • icon-list-alt
      • -
      • icon-lock
      • -
      • icon-flag
      • -
      • icon-headphones
      • -
      • icon-volume-off
      • -
      • icon-volume-down
      • -
      • icon-volume-up
      • -
      • icon-qrcode
      • -
      • icon-barcode
      • -
      • icon-tag
      • -
      • icon-tags
      • -
      • icon-book
      • -
      • icon-bookmark
      • -
      • icon-print
      • -
      • icon-camera
      • -
      • icon-font
      • -
      • icon-bold
      • -
      • icon-italic
      • -
      • icon-text-height
      • -
      • icon-text-width
      • -
      • icon-align-left
      • -
      • icon-align-center
      • -
      • icon-align-right
      • -
      • icon-align-justify
      • -
      • icon-list
      • +
      • icon-play-circle
      • +
      • icon-repeat
      • +
      • icon-refresh
      • +
      • icon-list-alt
      • +
      • icon-lock
      • +
      • icon-flag
      • +
      • icon-headphones
      • +
      • icon-volume-off
      • +
      • icon-volume-down
      • +
      • icon-volume-up
      • +
      • icon-qrcode
      • +
      • icon-barcode
      • +
      • icon-tag
      • +
      • icon-tags
      • +
      • icon-book
      • +
      • icon-bookmark
      • +
      • icon-print
      • +
      • icon-camera
      • +
      • icon-font
      • +
      • icon-bold
      • +
      • icon-italic
      • +
      • icon-text-height
      • +
      • icon-text-width
      • +
      • icon-align-left
      • +
      • icon-align-center
      • +
      • icon-align-right
      • +
      • icon-align-justify
      • +
      • icon-list
      • -
      • icon-indent-left
      • -
      • icon-indent-right
      • -
      • icon-facetime-video
      • -
      • icon-picture
      • -
      • icon-pencil
      • -
      • icon-map-marker
      • -
      • icon-adjust
      • -
      • icon-tint
      • -
      • icon-edit
      • -
      • icon-share
      • -
      • icon-check
      • -
      • icon-move
      • -
      • icon-step-backward
      • -
      • icon-fast-backward
      • -
      • icon-backward
      • -
      • icon-play
      • -
      • icon-pause
      • -
      • icon-stop
      • -
      • icon-forward
      • -
      • icon-fast-forward
      • -
      • icon-step-forward
      • -
      • icon-eject
      • -
      • icon-chevron-left
      • -
      • icon-chevron-right
      • -
      • icon-plus-sign
      • -
      • icon-minus-sign
      • -
      • icon-remove-sign
      • -
      • icon-ok-sign
      • +
      • icon-indent-left
      • +
      • icon-indent-right
      • +
      • icon-facetime-video
      • +
      • icon-picture
      • +
      • icon-pencil
      • +
      • icon-map-marker
      • +
      • icon-adjust
      • +
      • icon-tint
      • +
      • icon-edit
      • +
      • icon-share
      • +
      • icon-check
      • +
      • icon-move
      • +
      • icon-step-backward
      • +
      • icon-fast-backward
      • +
      • icon-backward
      • +
      • icon-play
      • +
      • icon-pause
      • +
      • icon-stop
      • +
      • icon-forward
      • +
      • icon-fast-forward
      • +
      • icon-step-forward
      • +
      • icon-eject
      • +
      • icon-chevron-left
      • +
      • icon-chevron-right
      • +
      • icon-plus-sign
      • +
      • icon-minus-sign
      • +
      • icon-remove-sign
      • +
      • icon-ok-sign
      • -
      • icon-question-sign
      • -
      • icon-info-sign
      • -
      • icon-screenshot
      • -
      • icon-remove-circle
      • -
      • icon-ok-circle
      • -
      • icon-ban-circle
      • -
      • icon-arrow-left
      • -
      • icon-arrow-right
      • -
      • icon-arrow-up
      • -
      • icon-arrow-down
      • -
      • icon-share-alt
      • -
      • icon-resize-full
      • -
      • icon-resize-small
      • -
      • icon-plus
      • -
      • icon-minus
      • -
      • icon-asterisk
      • -
      • icon-exclamation-sign
      • -
      • icon-gift
      • -
      • icon-leaf
      • -
      • icon-fire
      • -
      • icon-eye-open
      • -
      • icon-eye-close
      • -
      • icon-warning-sign
      • -
      • icon-plane
      • -
      • icon-calendar
      • -
      • icon-random
      • -
      • icon-comment
      • -
      • icon-magnet
      • +
      • icon-question-sign
      • +
      • icon-info-sign
      • +
      • icon-screenshot
      • +
      • icon-remove-circle
      • +
      • icon-ok-circle
      • +
      • icon-ban-circle
      • +
      • icon-arrow-left
      • +
      • icon-arrow-right
      • +
      • icon-arrow-up
      • +
      • icon-arrow-down
      • +
      • icon-share-alt
      • +
      • icon-resize-full
      • +
      • icon-resize-small
      • +
      • icon-plus
      • +
      • icon-minus
      • +
      • icon-asterisk
      • +
      • icon-exclamation-sign
      • +
      • icon-gift
      • +
      • icon-leaf
      • +
      • icon-fire
      • +
      • icon-eye-open
      • +
      • icon-eye-close
      • +
      • icon-warning-sign
      • +
      • icon-plane
      • +
      • icon-calendar
      • +
      • icon-random
      • +
      • icon-comment
      • +
      • icon-magnet
      • -
      • icon-chevron-up
      • -
      • icon-chevron-down
      • -
      • icon-retweet
      • -
      • icon-shopping-cart
      • -
      • icon-folder-close
      • -
      • icon-folder-open
      • -
      • icon-resize-vertical
      • -
      • icon-resize-horizontal
      • -
      • icon-hdd
      • -
      • icon-bullhorn
      • -
      • icon-bell
      • -
      • icon-certificate
      • -
      • icon-thumbs-up
      • -
      • icon-thumbs-down
      • -
      • icon-hand-right
      • -
      • icon-hand-left
      • -
      • icon-hand-up
      • -
      • icon-hand-down
      • -
      • icon-circle-arrow-right
      • -
      • icon-circle-arrow-left
      • -
      • icon-circle-arrow-up
      • -
      • icon-circle-arrow-down
      • -
      • icon-globe
      • -
      • icon-wrench
      • -
      • icon-tasks
      • -
      • icon-filter
      • -
      • icon-briefcase
      • -
      • icon-fullscreen
      • -
      +
    • icon-chevron-up
    • +
    • icon-chevron-down
    • +
    • icon-retweet
    • +
    • icon-shopping-cart
    • +
    • icon-folder-close
    • +
    • icon-folder-open
    • +
    • icon-resize-vertical
    • +
    • icon-resize-horizontal
    • +
    • icon-hdd
    • +
    • icon-bullhorn
    • +
    • icon-bell
    • +
    • icon-certificate
    • +
    • icon-thumbs-up
    • +
    • icon-thumbs-down
    • +
    • icon-hand-right
    • +
    • icon-hand-left
    • +
    • icon-hand-up
    • +
    • icon-hand-down
    • +
    • icon-circle-arrow-right
    • +
    • icon-circle-arrow-left
    • +
    • icon-circle-arrow-up
    • +
    • icon-circle-arrow-down
    • +
    • icon-globe
    • +
    • icon-wrench
    • +
    • icon-tasks
    • +
    • icon-filter
    • +
    • icon-briefcase
    • +
    • icon-fullscreen
    • +
    -

    Glyphicons attribution

    -

    {{_i}}Glyphicons Halflings are normally not available for free, but an arrangement between Bootstrap and the Glyphicons creators have made this possible at not cost to you as developers. As a thank you, we ask you to include an optional link back to Glyphicons whenever practical.{{/i}}

    +

    Glyphicons attribution

    +

    {{_i}}Glyphicons Halflings are normally not available for free, but an arrangement between Bootstrap and the Glyphicons creators have made this possible at not cost to you as developers. As a thank you, we ask you to include an optional link back to Glyphicons whenever practical.{{/i}}

    -
    +
    -

    {{_i}}How to use{{/i}}

    -

    {{_i}}All icons require an <i> tag with a unique class, prefixed with icon-. To use, place the following code just about anywhere:{{/i}}

    +

    {{_i}}How to use{{/i}}

    +

    {{_i}}All icons require an <i> tag with a unique class, prefixed with icon-. To use, place the following code just about anywhere:{{/i}}

     <i class="icon-search"></i>
     
    -

    {{_i}}There are also styles available for inverted (white) icons, made ready with one extra class:{{/i}}

    +

    {{_i}}There are also styles available for inverted (white) icons, made ready with one extra class:{{/i}}

     <i class="icon-search icon-white"></i>
     
    -

    - {{_i}}Heads up!{{/i}} - {{_i}}When using beside strings of text, as in buttons or nav links, be sure to leave a space after the <i> tag for proper spacing.{{/i}} -

    +

    + {{_i}}Heads up!{{/i}} + {{_i}}When using beside strings of text, as in buttons or nav links, be sure to leave a space after the <i> tag for proper spacing.{{/i}} +

    -
    +
    -

    {{_i}}Icon examples{{/i}}

    -

    {{_i}}Use them in buttons, button groups for a toolbar, navigation, or prepended form inputs.{{/i}}

    +

    {{_i}}Icon examples{{/i}}

    +

    {{_i}}Use them in buttons, button groups for a toolbar, navigation, or prepended form inputs.{{/i}}

    -

    {{_i}}Buttons{{/i}}

    - {{! /bs-docs-example }} - -

    {{_i}}Navigation{{/i}}

    - {{! /bs-docs-example }} - -

    {{_i}}Form fields{{/i}}

    -
    -
    - -
    -
    - +

    {{_i}}Buttons{{/i}}

    + - +
    {{! /bs-docs-example }} -
    +

    {{_i}}Navigation{{/i}}

    + {{! /bs-docs-example }} + +

    {{_i}}Form fields{{/i}}

    +
    +
    + +
    +
    + +
    +
    +
    +
    + +
    -
    {{! /span9 }} -
    {{! row}} +
    {{! /span9 }} +
    {{! row}} + +
    {{! /container }} diff --git a/docs/templates/pages/components.mustache b/docs/templates/pages/components.mustache index 450433d3b2..c2005dbc62 100644 --- a/docs/templates/pages/components.mustache +++ b/docs/templates/pages/components.mustache @@ -1,57 +1,59 @@
    -

    {{_i}}Components{{/i}}

    -

    {{_i}}Dozens of reusable components are built into Bootstrap to provide navigation, alerts, popovers, and much more.{{/i}}

    +
    +

    {{_i}}Components{{/i}}

    +

    {{_i}}Dozens of reusable components built to provide navigation, alerts, popovers, and more.{{/i}}

    +
    +
    - -
    - -
    + +
    + +
    - - + - -
    - - -

    {{_i}}Examples{{/i}}

    -

    {{_i}}Two basic options, along with two more specific variations.{{/i}}

    - -

    {{_i}}Single button group{{/i}}

    -

    {{_i}}Wrap a series of buttons with .btn in .btn-group.{{/i}}

    -
    -
    - - - + +
    + + +

    {{_i}}Examples{{/i}}

    +

    {{_i}}Two basic options, along with two more specific variations.{{/i}}

    + +

    {{_i}}Single button group{{/i}}

    +

    {{_i}}Wrap a series of buttons with .btn in .btn-group.{{/i}}

    +
    +
    + + + +
    -
     <div class="btn-group">
       <button class="btn">1</button>
    @@ -141,26 +143,26 @@
     </div>
     
    -

    {{_i}}Multiple button groups{{/i}}

    -

    {{_i}}Combine sets of <div class="btn-group"> into a <div class="btn-toolbar"> for more complex components.{{/i}}

    -
    -
    -
    - - - - -
    -
    - - - -
    -
    - +

    {{_i}}Multiple button groups{{/i}}

    +

    {{_i}}Combine sets of <div class="btn-group"> into a <div class="btn-toolbar"> for more complex components.{{/i}}

    +
    +
    +
    + + + + +
    +
    + + + +
    +
    + +
    -
     <div class="btn-toolbar">
       <div class="btn-group">
    @@ -169,16 +171,16 @@
     </div>
     
    -

    {{_i}}Vertical button groups{{/i}}

    -

    {{_i}}Make a set of buttons appear vertically stacked rather than horizontally.{{/i}}

    -
    -
    - - - - +

    {{_i}}Vertical button groups{{/i}}

    +

    {{_i}}Make a set of buttons appear vertically stacked rather than horizontally.{{/i}}

    +
    +
    + + + + +
    -
     <div class="btn-group btn-group-vertical">
       ...
    @@ -186,102 +188,102 @@
     
    -
    +
    -

    {{_i}}Checkbox and radio flavors{{/i}}

    -

    {{_i}}Button groups can also function as radios, where only one button may be active, or checkboxes, where any number of buttons may be active. View the Javascript docs for that.{{/i}}

    +

    {{_i}}Checkbox and radio flavors{{/i}}

    +

    {{_i}}Button groups can also function as radios, where only one button may be active, or checkboxes, where any number of buttons may be active. View the Javascript docs for that.{{/i}}

    -

    {{_i}}Dropdowns in button groups{{/i}}

    -

    {{_i}}Heads up!{{/i}} {{_i}}Buttons with dropdowns must be individually wrapped in their own .btn-group within a .btn-toolbar for proper rendering.{{/i}}

    -
    +

    {{_i}}Dropdowns in button groups{{/i}}

    +

    {{_i}}Heads up!{{/i}} {{_i}}Buttons with dropdowns must be individually wrapped in their own .btn-group within a .btn-toolbar for proper rendering.{{/i}}

    + - -
    - + +
    + -

    {{_i}}Overview and examples{{/i}}

    -

    {{_i}}Use any button to trigger a dropdown menu by placing it within a .btn-group and providing the proper menu markup.{{/i}}

    - {{! /example }} +

    {{_i}}Overview and examples{{/i}}

    +

    {{_i}}Use any button to trigger a dropdown menu by placing it within a .btn-group and providing the proper menu markup.{{/i}}

    + {{! /example }}
     <div class="btn-group">
       <a class="btn dropdown-toggle" data-toggle="dropdown" href="#">
    @@ -294,134 +296,134 @@
     </div>
     
    -

    {{_i}}Works with all button sizes{{/i}}

    -

    {{_i}}Button dropdowns work at any size. your button sizes to .btn-large, .btn-small, or .btn-mini.{{/i}}

    - {{! /example }} +

    {{_i}}Works with all button sizes{{/i}}

    +

    {{_i}}Button dropdowns work at any size. your button sizes to .btn-large, .btn-small, or .btn-mini.{{/i}}

    + {{! /example }} -

    {{_i}}Requires javascript{{/i}}

    -

    {{_i}}Button dropdowns require the Bootstrap dropdown plugin to function.{{/i}}

    -

    {{_i}}In some cases—like mobile—dropdown menus will extend outside the viewport. You need to resolve the alignment manually or with custom javascript.{{/i}}

    +

    {{_i}}Requires javascript{{/i}}

    +

    {{_i}}Button dropdowns require the Bootstrap dropdown plugin to function.{{/i}}

    +

    {{_i}}In some cases—like mobile—dropdown menus will extend outside the viewport. You need to resolve the alignment manually or with custom javascript.{{/i}}

    -
    +
    -

    {{_i}}Split button dropdowns{{/i}}

    -

    {{_i}}Building on the button group styles and markup, we can easily create a split button. Split buttons feature a standard action on the left and a dropdown toggle on the right with contextual links.{{/i}}

    - {{! /example }} +

    {{_i}}Split button dropdowns{{/i}}

    +

    {{_i}}Building on the button group styles and markup, we can easily create a split button. Split buttons feature a standard action on the left and a dropdown toggle on the right with contextual links.{{/i}}

    + {{! /example }}
     <div class="btn-group">
       <button class="btn">{{_i}}Action{{/i}}</button>
    @@ -434,49 +436,49 @@
     </div>
     
    -

    {{_i}}Sizes{{/i}}

    -

    {{_i}}Utilize the extra button classes .btn-mini, .btn-small, or .btn-large for sizing.{{/i}}

    - {{! /example }} +

    {{_i}}Sizes{{/i}}

    +

    {{_i}}Utilize the extra button classes .btn-mini, .btn-small, or .btn-large for sizing.{{/i}}

    + {{! /example }}
     <div class="btn-group">
       <button class="btn btn-mini">{{_i}}Action{{/i}}</button>
    @@ -489,34 +491,34 @@
     </div>
     
    -

    {{_i}}Dropup menus{{/i}}

    -

    {{_i}}Dropdown menus can also be toggled from the bottom up by adding a single class to the immediate parent of .dropdown-menu. It will flip the direction of the .caret and reposition the menu itself to move from the bottom up instead of top down.{{/i}}

    - {{! /example }} +

    {{_i}}Dropup menus{{/i}}

    +

    {{_i}}Dropdown menus can also be toggled from the bottom up by adding a single class to the immediate parent of .dropdown-menu. It will flip the direction of the .caret and reposition the menu itself to move from the bottom up instead of top down.{{/i}}

    + {{! /example }}
     <div class="btn-group dropup">
       <button class="btn">{{_i}}Dropup{{/i}}</button>
    @@ -529,29 +531,29 @@
     </div>
     
    -
    +
    - - - - + - - - -
    - - -

    {{_i}}Standard pagination{{/i}}

    -

    {{_i}}Simple pagination inspired by Rdio, great for apps and search results. The large block is hard to miss, easily scalable, and provides large click areas.{{/i}}

    -
    -
     <div class="pagination">
       <ul>
    @@ -1291,26 +1293,26 @@
     
    -
    +
    -

    {{_i}}Options{{/i}}

    +

    {{_i}}Options{{/i}}

    -

    {{_i}}Disabled and active states{{/i}}

    -

    {{_i}}Links are customizable for different circumstances. Use .disabled for unclickable links and .active to indicate the current page.{{/i}}

    -
    -
     <div class="pagination ">
       <ul>
    @@ -1321,39 +1323,39 @@
     </div>
     
    -

    {{_i}}Alignment{{/i}}

    -

    {{_i}}Add one of two optional classes to change the alignment of pagination links: .pagination-centered and .pagination-right.{{/i}}

    -
    -
     <div class="pagination pagination-centered">
       ...
     </div>
     
    -
    -
     <div class="pagination pagination-right">
       ...
    @@ -1361,20 +1363,20 @@
     
    -
    +
    -

    {{_i}}Pager{{/i}}

    -

    {{_i}}Quick previous and next links for simple pagination implementations with light markup and styles. It's great for simple sites like blogs or magazines.{{/i}}

    +

    {{_i}}Pager{{/i}}

    +

    {{_i}}Quick previous and next links for simple pagination implementations with light markup and styles. It's great for simple sites like blogs or magazines.{{/i}}

    -

    {{_i}}Default example{{/i}}

    -

    {{_i}}By default, the pager centers links.{{/i}}

    - +

    {{_i}}Default example{{/i}}

    +

    {{_i}}By default, the pager centers links.{{/i}}

    +
     <ul class="pager">
       <li><a href="#">{{_i}}Previous{{/i}}</a></li>
    @@ -1382,14 +1384,14 @@
     </ul>
     
    -

    {{_i}}Aligned links{{/i}}

    -

    {{_i}}Alternatively, you can align each link to the sides:{{/i}}

    - +

    {{_i}}Aligned links{{/i}}

    +

    {{_i}}Alternatively, you can align each link to the sides:{{/i}}

    +
     <ul class="pager">
       <li class="previous">
    @@ -1401,14 +1403,14 @@
     </ul>
     
    -

    {{_i}}Optional disabled state{{/i}}

    -

    {{_i}}Pager links also use the general .disabled utility class from the pagination.{{/i}}

    - +

    {{_i}}Optional disabled state{{/i}}

    +

    {{_i}}Pager links also use the general .disabled utility class from the pagination.{{/i}}

    +
     <ul class="pager">
       <li class="previous disabled">
    @@ -1418,187 +1420,175 @@
     </ul>
     
    -
    + - -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    {{_i}}Labels{{/i}}{{_i}}Markup{{/i}}
    - {{_i}}Default{{/i}} - - <span class="label">{{_i}}Default{{/i}}</span> -
    - {{_i}}Success{{/i}} - - <span class="label label-success">{{_i}}Success{{/i}}</span> -
    - {{_i}}Warning{{/i}} - - <span class="label label-warning">{{_i}}Warning{{/i}}</span> -
    - {{_i}}Important{{/i}} - - <span class="label label-important">{{_i}}Important{{/i}}</span> -
    - {{_i}}Info{{/i}} - - <span class="label label-info">{{_i}}Info{{/i}}</span> -
    - {{_i}}Inverse{{/i}} - - <span class="label label-inverse">{{_i}}Inverse{{/i}}</span> -
    -
    - - - - -
    - - -

    About

    -

    {{_i}}Badges are small, simple components for displaying an indicator or count of some sort. They're commonly found in email clients like Mail.app or on mobile apps for push notifications.{{/i}}

    - -

    Available classes

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    {{_i}}Name{{/i}}{{_i}}Example{{/i}}{{_i}}Markup{{/i}}
    - {{_i}}Default{{/i}} - - 1 - - <span class="badge">1</span> -
    - {{_i}}Success{{/i}} - - 2 - - <span class="badge badge-success">2</span> -
    - {{_i}}Warning{{/i}} - - 4 - - <span class="badge badge-warning">4</span> -
    - {{_i}}Important{{/i}} - - 6 - - <span class="badge badge-important">6</span> -
    - {{_i}}Info{{/i}} - - 8 - - <span class="badge badge-info">8</span> -
    - {{_i}}Inverse{{/i}} - - 10 - - <span class="badge badge-inverse">10</span> -
    - -
    - - - - -
    - - -

    {{_i}}Hero unit{{/i}}

    -

    {{_i}}A lightweight, flexible component called a hero unit to showcase content on your site. It works well on marketing and content-heavy sites.{{/i}}

    -
    -
    -

    {{_i}}Hello, world!{{/i}}

    -

    {{_i}}This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.{{/i}}

    -

    {{_i}}Learn more{{/i}}

    + +
    + +

    {{_i}}Labels{{/i}}

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    {{_i}}Labels{{/i}}{{_i}}Markup{{/i}}
    + {{_i}}Default{{/i}} + + <span class="label">{{_i}}Default{{/i}}</span> +
    + {{_i}}Success{{/i}} + + <span class="label label-success">{{_i}}Success{{/i}}</span> +
    + {{_i}}Warning{{/i}} + + <span class="label label-warning">{{_i}}Warning{{/i}}</span> +
    + {{_i}}Important{{/i}} + + <span class="label label-important">{{_i}}Important{{/i}}</span> +
    + {{_i}}Info{{/i}} + + <span class="label label-info">{{_i}}Info{{/i}}</span> +
    + {{_i}}Inverse{{/i}} + + <span class="label label-inverse">{{_i}}Inverse{{/i}}</span> +
    + +

    {{_i}}Badges{{/i}}

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    {{_i}}Name{{/i}}{{_i}}Example{{/i}}{{_i}}Markup{{/i}}
    + {{_i}}Default{{/i}} + + 1 + + <span class="badge">1</span> +
    + {{_i}}Success{{/i}} + + 2 + + <span class="badge badge-success">2</span> +
    + {{_i}}Warning{{/i}} + + 4 + + <span class="badge badge-warning">4</span> +
    + {{_i}}Important{{/i}} + + 6 + + <span class="badge badge-important">6</span> +
    + {{_i}}Info{{/i}} + + 8 + + <span class="badge badge-info">8</span> +
    + {{_i}}Inverse{{/i}} + + 10 + + <span class="badge badge-inverse">10</span> +
    + +
    + + + + +
    + + +

    {{_i}}Hero unit{{/i}}

    +

    {{_i}}A lightweight, flexible component to showcase key content on your site. It works well on marketing and content-heavy sites.{{/i}}

    +
    +
    +

    {{_i}}Hello, world!{{/i}}

    +

    {{_i}}This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.{{/i}}

    +

    {{_i}}Learn more{{/i}}

    +
    -
     <div class="hero-unit">
       <h1>{{_i}}Heading{{/i}}</h1>
    @@ -1611,105 +1601,105 @@
     </div>
     
    -

    {{_i}}Page header{{/i}}

    -

    {{_i}}A simple shell for an h1 to appropriately space out and segment sections of content on a page. It can utilize the h1's default small, element as well most other components (with additional styles).{{/i}}

    -
    -
     <div class="page-header">
       <h1>{{_i}}Example page header{{/i}}</h1>
     </div>
     
    -
    + - -
    - + +
    + -

    {{_i}}Default thumbnails{{/i}}

    -

    {{_i}}By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.{{/i}}

    -
    - -
    +

    {{_i}}Default thumbnails{{/i}}

    +

    {{_i}}By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.{{/i}}

    +
    + +
    -

    {{_i}}Highly customizable{{/i}}

    -

    {{_i}}With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.{{/i}}

    -
    -
      -
    • -
      - -
      -

      {{_i}}Thumbnail label{{/i}}

      -

      Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

      -

      {{_i}}Action{{/i}} {{_i}}Action{{/i}}

      +

      {{_i}}Highly customizable{{/i}}

      +

      {{_i}}With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.{{/i}}

      +
      +
        +
      • +
        + +
        +

        {{_i}}Thumbnail label{{/i}}

        +

        Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

        +

        {{_i}}Action{{/i}} {{_i}}Action{{/i}}

        +
        -
      -
    • -
    • -
      - -
      -

      {{_i}}Thumbnail label{{/i}}

      -

      Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

      -

      {{_i}}Action{{/i}} {{_i}}Action{{/i}}

      +
    • +
    • +
      + +
      +

      {{_i}}Thumbnail label{{/i}}

      +

      Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

      +

      {{_i}}Action{{/i}} {{_i}}Action{{/i}}

      +
      -
    - -
  • -
    - -
    -

    {{_i}}Thumbnail label{{/i}}

    -

    Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

    -

    {{_i}}Action{{/i}} {{_i}}Action{{/i}}

    +
  • +
  • +
    + +
    +

    {{_i}}Thumbnail label{{/i}}

    +

    Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida at eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

    +

    {{_i}}Action{{/i}} {{_i}}Action{{/i}}

    +
    -
  • - - -
    + + +
    -

    {{_i}}Why use thumbnails{{/i}}

    -

    {{_i}}Thumbnails (previously .media-grid up until v1.4) are great for grids of photos or videos, image search results, retail products, portfolios, and much more. They can be links or static content.{{/i}}

    +

    {{_i}}Why use thumbnails{{/i}}

    +

    {{_i}}Thumbnails (previously .media-grid up until v1.4) are great for grids of photos or videos, image search results, retail products, portfolios, and much more. They can be links or static content.{{/i}}

    -

    {{_i}}Simple, flexible markup{{/i}}

    -

    {{_i}}Thumbnail markup is simple—a ul with any number of li elements is all that is required. It's also super flexible, allowing for any type of content with just a bit more markup to wrap your contents.{{/i}}

    +

    {{_i}}Simple, flexible markup{{/i}}

    +

    {{_i}}Thumbnail markup is simple—a ul with any number of li elements is all that is required. It's also super flexible, allowing for any type of content with just a bit more markup to wrap your contents.{{/i}}

    -

    {{_i}}Uses grid column sizes{{/i}}

    -

    {{_i}}Lastly, the thumbnails component uses existing grid system classes—like .span2 or .span3—for control of thumbnail dimensions.{{/i}}

    +

    {{_i}}Uses grid column sizes{{/i}}

    +

    {{_i}}Lastly, the thumbnails component uses existing grid system classes—like .span2 or .span3—for control of thumbnail dimensions.{{/i}}

    -

    {{_i}}The markup{{/i}}

    -

    {{_i}}As mentioned previously, the required markup for thumbnails is light and straightforward. Here's a look at the default setup for linked images:{{/i}}

    +

    {{_i}}Markup{{/i}}

    +

    {{_i}}As mentioned previously, the required markup for thumbnails is light and straightforward. Here's a look at the default setup for linked images:{{/i}}

     <ul class="thumbnails">
       <li class="span4">
    @@ -1720,7 +1710,7 @@
       ...
     </ul>
     
    -

    {{_i}}For custom HTML content in thumbnails, the markup changes slightly. To allow block level content anywhere, we swap the <a> for a <div> like so:{{/i}}

    +

    {{_i}}For custom HTML content in thumbnails, the markup changes slightly. To allow block level content anywhere, we swap the <a> for a <div> like so:{{/i}}

     <ul class="thumbnails">
       <li class="span4">
    @@ -1734,65 +1724,55 @@
     </ul>
     
    -

    {{_i}}More examples{{/i}}

    -

    {{_i}}Explore all your options with the various grid classes available to you. You can also mix and match different sizes.{{/i}}

    - +

    {{_i}}More examples{{/i}}

    +

    {{_i}}Explore all your options with the various grid classes available to you. You can also mix and match different sizes.{{/i}}

    + - + - -
    - - -

    {{_i}}Default alert{{/i}}

    -

    {{_i}}Wrap any text and an optional dismiss button in .alert for a basic warning alert message.{{/i}}

    -
    -
    - - {{_i}}Warning!{{/i}} {{_i}}Best check yo self, you're not looking too good.{{/i}} + +
    + + +

    {{_i}}Default alert{{/i}}

    +

    {{_i}}Wrap any text and an optional dismiss button in .alert for a basic warning alert message.{{/i}}

    +
    +
    + + {{_i}}Warning!{{/i}} {{_i}}Best check yo self, you're not looking too good.{{/i}} +
    -
     <div class="alert">
       <button type="button" class="close" data-dismiss="alert">×</button>
    @@ -1800,32 +1780,32 @@
     </div>
     
    -

    {{_i}}Dismiss buttons{{/i}}

    -

    {{_i}}Mobile Safari and Mobile Opera browsers, in addition to the data-dismiss="alert" attribute, require an href="#" for the dismissal of alerts when using an <a> tag.{{/i}}

    +

    {{_i}}Dismiss buttons{{/i}}

    +

    {{_i}}Mobile Safari and Mobile Opera browsers, in addition to the data-dismiss="alert" attribute, require an href="#" for the dismissal of alerts when using an <a> tag.{{/i}}

     <a href="#" class="close" data-dismiss="alert">×</button>
     
    -

    {{_i}}Alternatively, you may use a <button> element with the data attribute, which we have opted to do for our docs. When using <button>, you must include type="button" or your forms may not submit.{{/i}}

    +

    {{_i}}Alternatively, you may use a <button> element with the data attribute, which we have opted to do for our docs. When using <button>, you must include type="button" or your forms may not submit.{{/i}}

     <button type="button" class="close" data-dismiss="alert">×</button>
     
    -

    {{_i}}Dismiss alerts via javascript{{/i}}

    -

    {{_i}}Use the alerts jQuery plugin for quick and easy dismissal of alerts.{{/i}}

    +

    {{_i}}Dismiss alerts via javascript{{/i}}

    +

    {{_i}}Use the alerts jQuery plugin for quick and easy dismissal of alerts.{{/i}}

    -
    +
    -

    {{_i}}Options{{/i}}

    -

    {{_i}}For longer messages, increase the padding on the top and bottom of the alert wrapper by adding .alert-block.{{/i}}

    -
    -
    - -

    {{_i}}Warning!{{/i}}

    -

    {{_i}}Best check yo self, you're not looking too good.{{/i}} Nulla vitae elit libero, a pharetra augue. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.

    +

    {{_i}}Options{{/i}}

    +

    {{_i}}For longer messages, increase the padding on the top and bottom of the alert wrapper by adding .alert-block.{{/i}}

    +
    +
    + +

    {{_i}}Warning!{{/i}}

    +

    {{_i}}Best check yo self, you're not looking too good.{{/i}} Nulla vitae elit libero, a pharetra augue. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.

    +
    -
     <div class="alert alert-block">
       <a class="close" data-dismiss="alert" href="#">&times;</a>
    @@ -1835,97 +1815,97 @@
     
    -
    +
    -

    {{_i}}Contextual alternatives{{/i}}

    -

    {{_i}}Add optional classes to change an alert's connotation.{{/i}}

    +

    {{_i}}Contextual alternatives{{/i}}

    +

    {{_i}}Add optional classes to change an alert's connotation.{{/i}}

    -

    {{_i}}Error or danger{{/i}}

    -
    -
    - - {{_i}}Oh snap!{{/i}} {{_i}}Change a few things up and try submitting again.{{/i}} +

    {{_i}}Error or danger{{/i}}

    +
    +
    + + {{_i}}Oh snap!{{/i}} {{_i}}Change a few things up and try submitting again.{{/i}} +
    -
     <div class="alert alert-error">
       ...
     </div>
     
    -

    {{_i}}Success{{/i}}

    -
    -
    - - {{_i}}Well done!{{/i}} {{_i}}You successfully read this important alert message.{{/i}} +

    {{_i}}Success{{/i}}

    +
    +
    + + {{_i}}Well done!{{/i}} {{_i}}You successfully read this important alert message.{{/i}} +
    -
     <div class="alert alert-success">
       ...
     </div>
     
    -

    {{_i}}Information{{/i}}

    -
    -
    - - {{_i}}Heads up!{{/i}} {{_i}}This alert needs your attention, but it's not super important.{{/i}} +

    {{_i}}Information{{/i}}

    +
    +
    + + {{_i}}Heads up!{{/i}} {{_i}}This alert needs your attention, but it's not super important.{{/i}} +
    -
     <div class="alert alert-info">
       ...
     </div>
     
    -
    + - -
    - - -

    {{_i}}Examples and markup{{/i}}

    - -

    {{_i}}Basic{{/i}}

    -

    {{_i}}Default progress bar with a vertical gradient.{{/i}}

    -
    -
    -
    + +
    + + +

    {{_i}}Examples and markup{{/i}}

    + +

    {{_i}}Basic{{/i}}

    +

    {{_i}}Default progress bar with a vertical gradient.{{/i}}

    +
    +
    +
    +
    -
     <div class="progress">
       <div class="bar" style="width: 60%;"></div>
     </div>
     
    -

    {{_i}}Striped{{/i}}

    -

    {{_i}}Uses a gradient to create a striped effect. Not available in IE7-8.{{/i}}

    -
    -
    -
    +

    {{_i}}Striped{{/i}}

    +

    {{_i}}Uses a gradient to create a striped effect. Not available in IE7-8.{{/i}}

    +
    +
    +
    +
    -
     <div class="progress progress-striped">
       <div class="bar" style="width: 20%;"></div>
     </div>
     
    -

    {{_i}}Animated{{/i}}

    -

    {{_i}}Add .active to .progress-striped to animate the stripes right to left. Not available in all versions of IE.{{/i}}

    -
    -
    -
    +

    {{_i}}Animated{{/i}}

    +

    {{_i}}Add .active to .progress-striped to animate the stripes right to left. Not available in all versions of IE.{{/i}}

    +
    +
    +
    +
    -
     <div class="progress progress-striped active">
       <div class="bar" style="width: 40%;"></div>
    @@ -1933,27 +1913,27 @@
     
    -
    +
    -

    {{_i}}Options{{/i}}

    +

    {{_i}}Options{{/i}}

    -

    {{_i}}Additional colors{{/i}}

    -

    {{_i}}Progress bars use some of the same button and alert classes for consistent styles.{{/i}}

    -
    -
    -
    +

    {{_i}}Additional colors{{/i}}

    +

    {{_i}}Progress bars use some of the same button and alert classes for consistent styles.{{/i}}

    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
     <div class="progress progress-info">
       <div class="bar" style="width: 20%"></div>
    @@ -1969,22 +1949,22 @@
     </div>
     
    -

    {{_i}}Striped bars{{/i}}

    -

    {{_i}}Similar to the solid colors, we have varied striped progress bars.{{/i}}

    -
    -
    -
    +

    {{_i}}Striped bars{{/i}}

    +

    {{_i}}Similar to the solid colors, we have varied striped progress bars.{{/i}}

    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    -
    -
    -
    -
    -
    -
    -
    -
    -
    -
     <div class="progress progress-info progress-striped">
       <div class="bar" style="width: 20%"></div>
    @@ -2001,74 +1981,74 @@
     
    -
    +
    -

    {{_i}}Browser support{{/i}}

    -

    {{_i}}Progress bars use CSS3 gradients, transitions, and animations to achieve all their effects. These features are not supported in IE7-9 or older versions of Firefox.{{/i}}

    -

    {{_i}}Opera and IE do not support animations at this time.{{/i}}

    +

    {{_i}}Browser support{{/i}}

    +

    {{_i}}Progress bars use CSS3 gradients, transitions, and animations to achieve all their effects. These features are not supported in IE7-9 or older versions of Firefox.{{/i}}

    +

    {{_i}}Opera and IE do not support animations at this time.{{/i}}

    -
    + - -
    - - -

    {{_i}}Wells{{/i}}

    -

    {{_i}}Use the well as a simple effect on an element to give it an inset effect.{{/i}}

    -
    -
    - {{_i}}Look, I'm in a well!{{/i}} + +
    + + +

    {{_i}}Wells{{/i}}

    +

    {{_i}}Use the well as a simple effect on an element to give it an inset effect.{{/i}}

    +
    +
    + {{_i}}Look, I'm in a well!{{/i}} +
    -
     <div class="well">
       ...
     </div>
     
    -

    {{_i}}Optional classes{{/i}}

    -

    {{_i}}Control padding and rounded corners with two optional modifier classes.{{/i}}

    -
    -
    - {{_i}}Look, I'm in a well!{{/i}} +

    {{_i}}Optional classes{{/i}}

    +

    {{_i}}Control padding and rounded corners with two optional modifier classes.{{/i}}

    +
    +
    + {{_i}}Look, I'm in a well!{{/i}} +
    -
     <div class="well well-large">
       ...
     </div>
     
    -
    -
    - {{_i}}Look, I'm in a well!{{/i}} +
    +
    + {{_i}}Look, I'm in a well!{{/i}} +
    -
     <div class="well well-small">
       ...
     </div>
     
    -

    {{_i}}Close icon{{/i}}

    -

    {{_i}}Use the generic close icon for dismissing content like modals and alerts.{{/i}}

    -
    -

    -
    +

    {{_i}}Close icon{{/i}}

    +

    {{_i}}Use the generic close icon for dismissing content like modals and alerts.{{/i}}

    +
    +

    +
    <button class="close">&times;</button>
    -

    {{_i}}iOS devices require an href="#" for click events if you rather use an anchor.{{/i}}

    +

    {{_i}}iOS devices require an href="#" for click events if you rather use an anchor.{{/i}}

    <a class="close" href="#">&times;</a>
    -

    {{_i}}Helper classes{{/i}}

    -

    {{_i}}Simple, focused classes for small display or behavior tweaks.{{/i}}

    +

    {{_i}}Helper classes{{/i}}

    +

    {{_i}}Simple, focused classes for small display or behavior tweaks.{{/i}}

    -

    {{_i}}.pull-left{{/i}}

    -

    {{_i}}Float an element left{{/i}}

    +

    {{_i}}.pull-left{{/i}}

    +

    {{_i}}Float an element left{{/i}}

     class="pull-left"
     
    @@ -2078,8 +2058,8 @@ class="pull-left" } -

    {{_i}}.pull-right{{/i}}

    -

    {{_i}}Float an element right{{/i}}

    +

    {{_i}}.pull-right{{/i}}

    +

    {{_i}}Float an element right{{/i}}

     class="pull-right"
     
    @@ -2089,8 +2069,8 @@ class="pull-right" } -

    {{_i}}.muted{{/i}}

    -

    {{_i}}Change an element's color to #999{{/i}}

    +

    {{_i}}.muted{{/i}}

    +

    {{_i}}Change an element's color to #999{{/i}}

     class="muted"
     
    @@ -2100,8 +2080,8 @@ class="muted" } -

    {{_i}}.clearfix{{/i}}

    -

    {{_i}}Clear the float on any element{{/i}}

    +

    {{_i}}.clearfix{{/i}}

    +

    {{_i}}Clear the float on any element{{/i}}

     class="clearfix"
     
    @@ -2119,9 +2099,11 @@ class="clearfix" } -
    + -
    {{! /span9 }} -
    {{! row}} + {{! /span9 }} + {{! row}} + +{{! /container }} diff --git a/docs/templates/pages/extend.mustache b/docs/templates/pages/extend.mustache index 2449ae8390..914d22a8e7 100644 --- a/docs/templates/pages/extend.mustache +++ b/docs/templates/pages/extend.mustache @@ -1,103 +1,108 @@
    -

    {{_i}}Extending Bootstrap{{/i}}

    -

    {{_i}}Extend Bootstrap to take advantage of included styles and components, as well as LESS variables and mixins.{{/i}}

    +
    +

    {{_i}}Extending Bootstrap{{/i}}

    +

    {{_i}}Extend Bootstrap to take advantage of included styles and components, as well as LESS variables and mixins.{{/i}}

    +
    +
    - -
    - -
    + +
    + +
    - -
    - + +
    + -

    {{_i}}Why LESS?{{/i}}

    -

    {{_i}}Bootstrap is made with LESS at its core, a dynamic stylesheet language created by our good friend, Alexis Sellier. It makes developing systems-based CSS faster, easier, and more fun.{{/i}}

    +

    {{_i}}Why LESS?{{/i}}

    +

    {{_i}}Bootstrap is made with LESS at its core, a dynamic stylesheet language created by our good friend, Alexis Sellier. It makes developing systems-based CSS faster, easier, and more fun.{{/i}}

    -

    {{_i}}What's included?{{/i}}

    -

    {{_i}}As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.{{/i}}

    +

    {{_i}}What's included?{{/i}}

    +

    {{_i}}As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.{{/i}}

    -

    {{_i}}Learn more{{/i}}

    - LESS CSS -

    {{_i}}Visit the official website at http://lesscss.org to learn more.{{/i}}

    -
    +

    {{_i}}Learn more{{/i}}

    + LESS CSS +

    {{_i}}Visit the official website at http://lesscss.org to learn more.{{/i}}

    +
    - -
    - -
    - {{_i}}Note: If you're submitting a pull request to GitHub with modified CSS, you must recompile the CSS via any of these methods.{{/i}} -
    + +
    + +
    + {{_i}}Note: If you're submitting a pull request to GitHub with modified CSS, you must recompile the CSS via any of these methods.{{/i}} +
    -

    {{_i}}Tools for compiling{{/i}}

    +

    {{_i}}Tools for compiling{{/i}}

    -

    {{_i}}Node with makefile{{/i}}

    -

    {{_i}}Install the LESS command line compiler, JSHint, Recess, and uglify-js globally with npm by running the following command:{{/i}}

    -
    $ npm install -g less jshint recess uglify-js
    -

    {{_i}}Once installed just run make from the root of your bootstrap directory and you're all set.{{/i}}

    -

    {{_i}}Additionally, if you have watchr installed, you may run make watch to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).{{/i}}

    +

    {{_i}}Node with makefile{{/i}}

    +

    {{_i}}Install the LESS command line compiler, JSHint, Recess, and uglify-js globally with npm by running the following command:{{/i}}

    +
    $ npm install -g less jshint recess uglify-js
    +

    {{_i}}Once installed just run make from the root of your bootstrap directory and you're all set.{{/i}}

    +

    {{_i}}Additionally, if you have watchr installed, you may run make watch to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).{{/i}}

    -

    {{_i}}Command line{{/i}}

    -

    {{_i}}Install the LESS command line tool via Node and run the following command:{{/i}}

    -
    $ lessc ./less/bootstrap.less > bootstrap.css
    -

    {{_i}}Be sure to include --compress in that command if you're trying to save some bytes!{{/i}}

    +

    {{_i}}Command line{{/i}}

    +

    {{_i}}Install the LESS command line tool via Node and run the following command:{{/i}}

    +
    $ lessc ./less/bootstrap.less > bootstrap.css
    +

    {{_i}}Be sure to include --compress in that command if you're trying to save some bytes!{{/i}}

    -

    {{_i}}Javascript{{/i}}

    -

    {{_i}}Download the latest Less.js and include the path to it (and Bootstrap) in the <head>.{{/i}}

    +

    {{_i}}Javascript{{/i}}

    +

    {{_i}}Download the latest Less.js and include the path to it (and Bootstrap) in the <head>.{{/i}}

     <link rel="stylesheet/less" href="/path/to/bootstrap.less">
     <script src="/path/to/less.js"></script>
     
    -

    {{_i}}To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.{{/i}}

    +

    {{_i}}To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.{{/i}}

    -

    {{_i}}Unofficial Mac app{{/i}}

    -

    {{_i}}The unofficial Mac app watches directories of .less files and compiles the code to local files after every save of a watched .less file.{{/i}}

    -

    {{_i}}If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.{{/i}}

    +

    {{_i}}Unofficial Mac app{{/i}}

    +

    {{_i}}The unofficial Mac app watches directories of .less files and compiles the code to local files after every save of a watched .less file.{{/i}}

    +

    {{_i}}If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.{{/i}}

    -

    {{_i}}More Mac apps{{/i}}

    -

    Crunch

    -

    {{_i}}Crunch is a great looking LESS editor and compiler built on Adobe Air.{{/i}}

    -

    CodeKit

    -

    {{_i}}Created by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.{{/i}}

    -

    Simpless

    -

    {{_i}}Mac, Linux, and PC app for drag and drop compiling of LESS files. Plus, the source code is on GitHub.{{/i}}

    +

    {{_i}}More Mac apps{{/i}}

    +

    Crunch

    +

    {{_i}}Crunch is a great looking LESS editor and compiler built on Adobe Air.{{/i}}

    +

    CodeKit

    +

    {{_i}}Created by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.{{/i}}

    +

    Simpless

    +

    {{_i}}Mac, Linux, and PC app for drag and drop compiling of LESS files. Plus, the source code is on GitHub.{{/i}}

    -
    +
    - -
    - -

    ...

    -
    + +
    + +

    ...

    +
    -
    {{! /span9 }} -
    {{! row}} +
    {{! /span9 }} +
    {{! row}} + +
    {{! /container }} diff --git a/docs/templates/pages/getting-started.mustache b/docs/templates/pages/getting-started.mustache index 5e1407436c..c6a03ec0a0 100644 --- a/docs/templates/pages/getting-started.mustache +++ b/docs/templates/pages/getting-started.mustache @@ -1,10 +1,14 @@ +
    +

    {{_i}}Getting started{{/i}}

    {{_i}}Overview of the project, it's contents, and how to get started with a simple template.{{/i}}

    +
    +
    -

    Bootstrap

    Sleek, intuitive, and powerful front-end framework for faster and easier web development.

    {{_i}}Download Bootstrap{{/i}}

    + +
    {{! /container }} diff --git a/docs/templates/pages/javascript.mustache b/docs/templates/pages/javascript.mustache index 4c25bb08b6..81ef75209d 100644 --- a/docs/templates/pages/javascript.mustache +++ b/docs/templates/pages/javascript.mustache @@ -1,109 +1,112 @@
    -

    {{_i}}Javascript for Bootstrap{{/i}}

    -

    {{_i}}Bring Bootstrap's components to life—now with 12 custom jQuery plugins.{{/i}} +

    +

    {{_i}}Javascript for Bootstrap{{/i}}

    +

    {{_i}}Bring Bootstrap's components to life—now with 12 custom jQuery plugins.{{/i}} +

    +
    - -
    - -
    - - - - -
    - - -

    {{_i}}Individual or compiled{{/i}}

    -

    {{_i}}If you have downloaded the latest version of Bootstrap, both bootstrap.js and bootstrap.min.js contain all of these plugins.{{/i}}

    - -

    {{_i}}Data attributes{{/i}}

    -

    {{_i}}...{{/i}}

    - -

    {{_i}}Programmatic API{{/i}}

    -

    {{_i}}...{{/i}}

    - - - {{! Thought: consider porting much of the JS readme here? }} - -
    - - - - -
    - -

    {{_i}}About transitions{{/i}}

    -

    {{_i}}For simple transition effects, include bootstrap-transition.js once alongside the other JS files. If you're using the compiled (or minified) bootstrap.js, there is no need to include this—it's already there.{{/i}}

    -

    {{_i}}Use cases{{/i}}

    -

    {{_i}}A few examples of the transition plugin:{{/i}}

    -
    +
    +
    - -
    - - - -

    {{_i}}Examples{{/i}}

    -

    {{_i}}Modals are streamlined, but flexible, dialog prompts with the minimum required functionality and smart defaults.{{/i}}

    - -

    {{_i}}Static example{{/i}}

    -

    {{_i}}A rendered modal with header, body, and set of actions in the footer.{{/i}}

    -
    - {{! /example }} + +

    {{_i}}Individual or compiled{{/i}}

    +

    {{_i}}If you have downloaded the latest version of Bootstrap, both bootstrap.js and bootstrap.min.js contain all of these plugins.{{/i}}

    + +

    {{_i}}Data attributes{{/i}}

    +

    {{_i}}...{{/i}}

    + +

    {{_i}}Programmatic API{{/i}}

    +

    {{_i}}...{{/i}}

    + + + {{! Thought: consider porting much of the JS readme here? }} + +
    + + + + +
    + +

    {{_i}}About transitions{{/i}}

    +

    {{_i}}For simple transition effects, include bootstrap-transition.js once alongside the other JS files. If you're using the compiled (or minified) bootstrap.js, there is no need to include this—it's already there.{{/i}}

    +

    {{_i}}Use cases{{/i}}

    +

    {{_i}}A few examples of the transition plugin:{{/i}}

    +
      +
    • {{_i}}Sliding or fading in modals{{/i}}
    • +
    • {{_i}}Fading out tabs{{/i}}
    • +
    • {{_i}}Fading out alerts{{/i}}
    • +
    • {{_i}}Sliding carousel panes{{/i}}
    • +
    + + {{! Ideas: include docs for .fade.in, .slide.in, etc }} +
    + + + + +
    + + + +

    {{_i}}Examples{{/i}}

    +

    {{_i}}Modals are streamlined, but flexible, dialog prompts with the minimum required functionality and smart defaults.{{/i}}

    + +

    {{_i}}Static example{{/i}}

    +

    {{_i}}A rendered modal with header, body, and set of actions in the footer.{{/i}}

    +
    + +
    {{! /example }}
     <div class="modal hide fade">
       <div class="modal-header">
    @@ -120,43 +123,43 @@
     </div>
     
    -

    {{_i}}Live demo{{/i}}

    -

    {{_i}}Toggle a modal via javascript by clicking the button below. It will slide down and fade in from the top of the page.{{/i}}

    - -
    +}) + + - - - -
    - + +
    + -

    {{_i}}Example in navbar{{/i}}

    -

    {{_i}}The ScrollSpy plugin is for automatically updating nav targets based on scroll position. Scroll the area below the navbar and watch the active class change. The dropdown sub items will be highlighted as well.{{/i}}

    -
    -
    +

    {{_i}}Events{{/i}}

    + + + + + + + + + + + + + +
    {{_i}}Event{{/i}}{{_i}}Description{{/i}}
    {{_i}}activate{{/i}}{{_i}}This event fires whenever a new item becomes activated by the scrollspy.{{/i}}
    +
    - -
    - - - -

    {{_i}}Example tabs{{/i}}

    -

    {{_i}}Add quick, dynamic tab functionality to transiton through panes of local content, even via dropdown menus.{{/i}}

    -
    - -
    -
    -

    Raw denim you probably haven't heard of them jean shorts Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Mustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Cosby sweater eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan american apparel, butcher voluptate nisi qui.

    -
    -
    -

    Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.

    -
    - - + +
    + -
    {{! /example }} -
    +

    {{_i}}Example tabs{{/i}}

    +

    {{_i}}Add quick, dynamic tab functionality to transiton through panes of local content, even via dropdown menus.{{/i}}

    +
    + +
    +
    +

    Raw denim you probably haven't heard of them jean shorts Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Mustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Cosby sweater eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan american apparel, butcher voluptate nisi qui.

    +
    +
    +

    Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.

    +
    + + +
    +
    {{! /example }} -

    {{_i}}Usage{{/i}}

    -

    {{_i}}Enable tabbable tabs via javascript (each tab needs to be activated individually):{{/i}}

    +
    + + +

    {{_i}}Usage{{/i}}

    +

    {{_i}}Enable tabbable tabs via javascript (each tab needs to be activated individually):{{/i}}

     $('#myTab a').click(function (e) {
       e.preventDefault();
       $(this).tab('show');
     })
    -

    {{_i}}You can activate individual tabs in several ways:{{/i}}

    +

    {{_i}}You can activate individual tabs in several ways:{{/i}}

     $('#myTab a[href="#profile"]').tab('show'); // Select tab by name
     $('#myTab a:first').tab('show'); // Select first tab
    @@ -593,8 +597,8 @@ $('#myTab a:last').tab('show'); // Select last tab
     $('#myTab li:eq(2) a').tab('show'); // Select third tab (0-indexed)
     
    -

    {{_i}}Markup{{/i}}

    -

    {{_i}}You can activate a tab or pill navigation without writing any javascript by simply specifying data-toggle="tab" or data-toggle="pill" on an element. Adding the nav and nav-tabs classes to the tab ul will apply the bootstrap tab styling.{{/i}}

    +

    {{_i}}Markup{{/i}}

    +

    {{_i}}You can activate a tab or pill navigation without writing any javascript by simply specifying data-toggle="tab" or data-toggle="pill" on an element. Adding the nav and nav-tabs classes to the tab ul will apply the bootstrap tab styling.{{/i}}

     <ul class="nav nav-tabs">
       <li><a href="#home" data-toggle="tab">{{_i}}Home{{/i}}</a></li>
    @@ -603,11 +607,11 @@ $('#myTab li:eq(2) a').tab('show'); // Select third tab (0-indexed)
       <li><a href="#settings" data-toggle="tab">{{_i}}Settings{{/i}}</a></li>
     </ul>
    -

    {{_i}}Methods{{/i}}

    -

    $().tab

    -

    - {{_i}}Activates a tab element and content container. Tab should have either a data-target or an href targeting a container node in the DOM.{{/i}} -

    +

    {{_i}}Methods{{/i}}

    +

    $().tab

    +

    + {{_i}}Activates a tab element and content container. Tab should have either a data-target or an href targeting a container node in the DOM.{{/i}} +

     <ul class="nav nav-tabs" id="myTab">
       <li class="active"><a href="#home">{{_i}}Home{{/i}}</a></li>
    @@ -627,429 +631,432 @@ $('#myTab li:eq(2) a').tab('show'); // Select third tab (0-indexed)
       $(function () {
         $('#myTab a:last').tab('show');
       })
    -</script>
    +</script> + -

    {{_i}}Events{{/i}}

    - - - - - - - - - - - - - - - - - -
    {{_i}}Event{{/i}}{{_i}}Description{{/i}}
    {{_i}}show{{/i}}{{_i}}This event fires on tab show, but before the new tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively.{{/i}}
    {{_i}}shown{{/i}}{{_i}}This event fires on tab show after a tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively.{{/i}}
    +

    {{_i}}Events{{/i}}

    + + + + + + + + + + + + + + + + + +
    {{_i}}Event{{/i}}{{_i}}Description{{/i}}
    {{_i}}show{{/i}}{{_i}}This event fires on tab show, but before the new tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively.{{/i}}
    {{_i}}shown{{/i}}{{_i}}This event fires on tab show after a tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively.{{/i}}
     $('a[data-toggle="tab"]').on('shown', function (e) {
       e.target // activated tab
       e.relatedTarget // previous tab
    -})
    -
    +}) + + - -
    - - - -

    {{_i}}Examples{{/i}}

    -

    {{_i}}Inspired by the excellent jQuery.tipsy plugin written by Jason Frame; Tooltips are an updated version, which don't rely on images, use CSS3 for animations, and data-attributes for local title storage.{{/i}}

    -

    {{_i}}Hover over the links below to see tooltips:{{/i}}

    -
    -

    {{_i}}Tight pants next level keffiyeh you probably haven't heard of them. Photo booth beard raw denim letterpress vegan messenger bag stumptown. Farm-to-table seitan, mcsweeney's fixie sustainable quinoa 8-bit american apparel have a terry richardson vinyl chambray. Beard stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, four loko mcsweeney's cleanse vegan chambray. A really ironic artisan whatever keytar, scenester farm-to-table banksy Austin twitter handle freegan cred raw denim single-origin coffee viral.{{/i}} -

    -
    {{! /example }} - -

    {{_i}}Four directions{{/i}}

    - {{! /example }} - - -
    - - -

    {{_i}}Usage{{/i}}

    -

    {{_i}}Trigger the tooltip via javascript:{{/i}}

    -
    $('#example').tooltip({{_i}}options{{/i}})
    - -

    {{_i}}Options{{/i}}

    -

    {{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-, as in data-animation="".{{/i}}

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    {{_i}}Name{{/i}}{{_i}}type{{/i}}{{_i}}default{{/i}}{{_i}}description{{/i}}
    {{_i}}animation{{/i}}{{_i}}boolean{{/i}}true{{_i}}apply a css fade transition to the tooltip{{/i}}
    {{_i}}html{{/i}}{{_i}}boolean{{/i}}true{{_i}}Insert html into the tooltip. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks.{{/i}}
    {{_i}}placement{{/i}}{{_i}}string|function{{/i}}'top'{{_i}}how to position the tooltip{{/i}} - top | bottom | left | right
    {{_i}}selector{{/i}}{{_i}}string{{/i}}false{{_i}}If a selector is provided, tooltip objects will be delegated to the specified targets.{{/i}}
    {{_i}}title{{/i}}{{_i}}string | function{{/i}}''{{_i}}default title value if `title` tag isn't present{{/i}}
    {{_i}}trigger{{/i}}{{_i}}string{{/i}}'hover'{{_i}}how tooltip is triggered{{/i}} - hover | focus | manual
    {{_i}}delay{{/i}}{{_i}}number | object{{/i}}0 -

    {{_i}}delay showing and hiding the tooltip (ms) - does not apply to manual trigger type{{/i}}

    -

    {{_i}}If a number is supplied, delay is applied to both hide/show{{/i}}

    -

    {{_i}}Object structure is: delay: { show: 500, hide: 100 }{{/i}}

    -
    -
    - {{_i}}Heads up!{{/i}} - {{_i}}Options for individual tooltips can alternatively be specified through the use of data attributes.{{/i}} -
    - -

    {{_i}}Markup{{/i}}

    -

    {{_i}}For performance reasons, the Tooltip and Popover data-apis are opt in. If you would like to use them just specify a selector option.{{/i}}

    -
    -    <a href="#" rel="tooltip" title="{{_i}}first tooltip{{/i}}">{{_i}}hover over me{{/i}}</a>
    -    
    - -

    {{_i}}Methods{{/i}}

    -

    $().tooltip({{_i}}options{{/i}})

    -

    {{_i}}Attaches a tooltip handler to an element collection.{{/i}}

    -

    .tooltip('show')

    -

    {{_i}}Reveals an element's tooltip.{{/i}}

    -
    $('#element').tooltip('show')
    -

    .tooltip('hide')

    -

    {{_i}}Hides an element's tooltip.{{/i}}

    -
    $('#element').tooltip('hide')
    -

    .tooltip('toggle')

    -

    {{_i}}Toggles an element's tooltip.{{/i}}

    -
    $('#element').tooltip('toggle')
    -

    .tooltip('destroy')

    -

    {{_i}}Destroys an element's tooltip.{{/i}}

    -
    $('#element').tooltip('destroy')
    -
    - - - - -
    - - -

    {{_i}}Examples{{/i}}

    -

    {{_i}}Add small overlays of content, like those on the iPad, to any element for housing secondary information. Hover over the button to trigger the popover. Requires Tooltip to be included.{{/i}}

    - -

    {{_i}}Static popover{{/i}}

    -

    {{_i}}Four options are available: top, right, bottom, and left aligned.{{/i}}

    -
    -
    -
    -

    Popover top

    -
    -

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    -
    + +
    + -
    -
    -

    Popover right

    -
    -

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    -
    -
    -
    -
    -

    Popover bottom

    -
    -

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    -
    -
    - -
    -
    -

    Popover left

    -
    -

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    -
    -
    - -
    -
    -

    {{_i}}No markup shown as popovers are generated from javascript and content within a data attribute.{{/i}}

    - -

    Live demo

    - - - -
    - - -

    {{_i}}Usage{{/i}}

    -

    {{_i}}Enable popovers via javascript:{{/i}}

    -
    $('#example').popover({{_i}}options{{/i}})
    - -

    {{_i}}Options{{/i}}

    -

    {{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-, as in data-animation="".{{/i}}

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    {{_i}}Name{{/i}}{{_i}}type{{/i}}{{_i}}default{{/i}}{{_i}}description{{/i}}
    {{_i}}animation{{/i}}{{_i}}boolean{{/i}}true{{_i}}apply a css fade transition to the tooltip{{/i}}
    {{_i}}html{{/i}}{{_i}}boolean{{/i}}true{{_i}}Insert html into the popover. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks.{{/i}}
    {{_i}}placement{{/i}}{{_i}}string|function{{/i}}'right'{{_i}}how to position the popover{{/i}} - top | bottom | left | right
    {{_i}}selector{{/i}}{{_i}}string{{/i}}false{{_i}}if a selector is provided, tooltip objects will be delegated to the specified targets{{/i}}
    {{_i}}trigger{{/i}}{{_i}}string{{/i}}'hover'{{_i}}how popover is triggered{{/i}} - hover | focus | manual
    {{_i}}title{{/i}}{{_i}}string | function{{/i}}''{{_i}}default title value if `title` attribute isn't present{{/i}}
    {{_i}}content{{/i}}{{_i}}string | function{{/i}}''{{_i}}default content value if `data-content` attribute isn't present{{/i}}
    {{_i}}delay{{/i}}{{_i}}number | object{{/i}}0 -

    {{_i}}delay showing and hiding the popover (ms) - does not apply to manual trigger type{{/i}}

    -

    {{_i}}If a number is supplied, delay is applied to both hide/show{{/i}}

    -

    {{_i}}Object structure is: delay: { show: 500, hide: 100 }{{/i}}

    -
    -
    - {{_i}}Heads up!{{/i}} - {{_i}}Options for individual popovers can alternatively be specified through the use of data attributes.{{/i}} -
    - -

    {{_i}}Markup{{/i}}

    -

    {{_i}}For performance reasons, the Tooltip and Popover data-apis are opt in. If you would like to use them just specify a selector option.{{/i}}

    - -

    {{_i}}Methods{{/i}}

    -

    $().popover({{_i}}options{{/i}})

    -

    {{_i}}Initializes popovers for an element collection.{{/i}}

    -

    .popover('show')

    -

    {{_i}}Reveals an elements popover.{{/i}}

    -
    $('#element').popover('show')
    -

    .popover('hide')

    -

    {{_i}}Hides an elements popover.{{/i}}

    -
    $('#element').popover('hide')
    -

    .popover('toggle')

    -

    {{_i}}Toggles an elements popover.{{/i}}

    -
    $('#element').popover('toggle')
    -

    .popover('destroy')

    -

    {{_i}}Destroys an element's popover.{{/i}}

    -
    $('#element').popover('destroy')
    -
    - - - - -
    - - - -

    {{_i}}Example alerts{{/i}}

    -

    {{_i}}Add dismiss functionality to all alerge messages with this plugin.{{/i}}

    -
    -
    - - {{_i}}Holy guacamole!{{/i}} {{_i}}Best check yo self, you're not looking too good.{{/i}} -
    -
    {{! /example }} - -
    -
    - -

    {{_i}}Oh snap! You got an error!{{/i}}

    -

    {{_i}}Change this and that and try again. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.{{/i}}

    -

    - {{_i}}Take this action{{/i}} {{_i}}Or do this{{/i}} +

    {{_i}}Examples{{/i}}

    +

    {{_i}}Inspired by the excellent jQuery.tipsy plugin written by Jason Frame; Tooltips are an updated version, which don't rely on images, use CSS3 for animations, and data-attributes for local title storage.{{/i}}

    +

    {{_i}}Hover over the links below to see tooltips:{{/i}}

    +
    +

    {{_i}}Tight pants next level keffiyeh you probably haven't heard of them. Photo booth beard raw denim letterpress vegan messenger bag stumptown. Farm-to-table seitan, mcsweeney's fixie sustainable quinoa 8-bit american apparel have a terry richardson vinyl chambray. Beard stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, four loko mcsweeney's cleanse vegan chambray. A really ironic artisan whatever keytar, scenester farm-to-table banksy Austin twitter handle freegan cred raw denim single-origin coffee viral.{{/i}}

    +
    {{! /example }} + +

    {{_i}}Four directions{{/i}}

    + {{! /example }} + + +
    + + +

    {{_i}}Usage{{/i}}

    +

    {{_i}}Trigger the tooltip via javascript:{{/i}}

    +
    $('#example').tooltip({{_i}}options{{/i}})
    + +

    {{_i}}Options{{/i}}

    +

    {{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-, as in data-animation="".{{/i}}

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    {{_i}}Name{{/i}}{{_i}}type{{/i}}{{_i}}default{{/i}}{{_i}}description{{/i}}
    {{_i}}animation{{/i}}{{_i}}boolean{{/i}}true{{_i}}apply a css fade transition to the tooltip{{/i}}
    {{_i}}html{{/i}}{{_i}}boolean{{/i}}true{{_i}}Insert html into the tooltip. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks.{{/i}}
    {{_i}}placement{{/i}}{{_i}}string|function{{/i}}'top'{{_i}}how to position the tooltip{{/i}} - top | bottom | left | right
    {{_i}}selector{{/i}}{{_i}}string{{/i}}false{{_i}}If a selector is provided, tooltip objects will be delegated to the specified targets.{{/i}}
    {{_i}}title{{/i}}{{_i}}string | function{{/i}}''{{_i}}default title value if `title` tag isn't present{{/i}}
    {{_i}}trigger{{/i}}{{_i}}string{{/i}}'hover'{{_i}}how tooltip is triggered{{/i}} - hover | focus | manual
    {{_i}}delay{{/i}}{{_i}}number | object{{/i}}0 +

    {{_i}}delay showing and hiding the tooltip (ms) - does not apply to manual trigger type{{/i}}

    +

    {{_i}}If a number is supplied, delay is applied to both hide/show{{/i}}

    +

    {{_i}}Object structure is: delay: { show: 500, hide: 100 }{{/i}}

    +
    +
    + {{_i}}Heads up!{{/i}} + {{_i}}Options for individual tooltips can alternatively be specified through the use of data attributes.{{/i}}
    -
    {{! /example }} + +

    {{_i}}Markup{{/i}}

    +

    {{_i}}For performance reasons, the Tooltip and Popover data-apis are opt in. If you would like to use them just specify a selector option.{{/i}}

    +
    +<a href="#" rel="tooltip" title="{{_i}}first tooltip{{/i}}">{{_i}}hover over me{{/i}}</a>
    +
    + +

    {{_i}}Methods{{/i}}

    +

    $().tooltip({{_i}}options{{/i}})

    +

    {{_i}}Attaches a tooltip handler to an element collection.{{/i}}

    +

    .tooltip('show')

    +

    {{_i}}Reveals an element's tooltip.{{/i}}

    +
    $('#element').tooltip('show')
    +

    .tooltip('hide')

    +

    {{_i}}Hides an element's tooltip.{{/i}}

    +
    $('#element').tooltip('hide')
    +

    .tooltip('toggle')

    +

    {{_i}}Toggles an element's tooltip.{{/i}}

    +
    $('#element').tooltip('toggle')
    +

    .tooltip('destroy')

    +

    {{_i}}Destroys an element's tooltip.{{/i}}

    +
    $('#element').tooltip('destroy')
    +
    -
    + + +
    + + +

    {{_i}}Examples{{/i}}

    +

    {{_i}}Add small overlays of content, like those on the iPad, to any element for housing secondary information. Hover over the button to trigger the popover. Requires Tooltip to be included.{{/i}}

    + +

    {{_i}}Static popover{{/i}}

    +

    {{_i}}Four options are available: top, right, bottom, and left aligned.{{/i}}

    +
    +
    +
    +

    Popover top

    +
    +

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    +
    +
    + +
    +
    +

    Popover right

    +
    +

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    +
    +
    + +
    +
    +

    Popover bottom

    +
    +

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    +
    +
    + +
    +
    +

    Popover left

    +
    +

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    +
    +
    + +
    +
    +

    {{_i}}No markup shown as popovers are generated from javascript and content within a data attribute.{{/i}}

    + +

    Live demo

    + -

    {{_i}}Usage{{/i}}

    -

    {{_i}}Enable dismissal of an alert via javascript:{{/i}}

    -
    $(".alert").alert()
    - -

    {{_i}}Markup{{/i}}

    -

    {{_i}}Just add data-dismiss="alert" to your close button to automatically give an alert close functionality.{{/i}}

    -
    <a class="close" data-dismiss="alert" href="#">&times;</a>
    - -

    {{_i}}Methods{{/i}}

    -

    $().alert()

    -

    {{_i}}Wraps all alerts with close functionality. To have your alerts animate out when closed, make sure they have the .fade and .in class already applied to them.{{/i}}

    -

    .alert('close')

    -

    {{_i}}Closes an alert.{{/i}}

    -
    $(".alert").alert('close')
    +
    -

    {{_i}}Events{{/i}}

    -

    {{_i}}Bootstrap's alert class exposes a few events for hooking into alert functionality.{{/i}}

    - - - - - - - - - - - - - - - - - -
    {{_i}}Event{{/i}}{{_i}}Description{{/i}}
    {{_i}}close{{/i}}{{_i}}This event fires immediately when the close instance method is called.{{/i}}
    {{_i}}closed{{/i}}{{_i}}This event is fired when the alert has been closed (will wait for css transitions to complete).{{/i}}
    +

    {{_i}}Usage{{/i}}

    +

    {{_i}}Enable popovers via javascript:{{/i}}

    +
    $('#example').popover({{_i}}options{{/i}})
    + +

    {{_i}}Options{{/i}}

    +

    {{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-, as in data-animation="".{{/i}}

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    {{_i}}Name{{/i}}{{_i}}type{{/i}}{{_i}}default{{/i}}{{_i}}description{{/i}}
    {{_i}}animation{{/i}}{{_i}}boolean{{/i}}true{{_i}}apply a css fade transition to the tooltip{{/i}}
    {{_i}}html{{/i}}{{_i}}boolean{{/i}}true{{_i}}Insert html into the popover. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks.{{/i}}
    {{_i}}placement{{/i}}{{_i}}string|function{{/i}}'right'{{_i}}how to position the popover{{/i}} - top | bottom | left | right
    {{_i}}selector{{/i}}{{_i}}string{{/i}}false{{_i}}if a selector is provided, tooltip objects will be delegated to the specified targets{{/i}}
    {{_i}}trigger{{/i}}{{_i}}string{{/i}}'hover'{{_i}}how popover is triggered{{/i}} - hover | focus | manual
    {{_i}}title{{/i}}{{_i}}string | function{{/i}}''{{_i}}default title value if `title` attribute isn't present{{/i}}
    {{_i}}content{{/i}}{{_i}}string | function{{/i}}''{{_i}}default content value if `data-content` attribute isn't present{{/i}}
    {{_i}}delay{{/i}}{{_i}}number | object{{/i}}0 +

    {{_i}}delay showing and hiding the popover (ms) - does not apply to manual trigger type{{/i}}

    +

    {{_i}}If a number is supplied, delay is applied to both hide/show{{/i}}

    +

    {{_i}}Object structure is: delay: { show: 500, hide: 100 }{{/i}}

    +
    +
    + {{_i}}Heads up!{{/i}} + {{_i}}Options for individual popovers can alternatively be specified through the use of data attributes.{{/i}} +
    + +

    {{_i}}Markup{{/i}}

    +

    {{_i}}For performance reasons, the Tooltip and Popover data-apis are opt in. If you would like to use them just specify a selector option.{{/i}}

    + +

    {{_i}}Methods{{/i}}

    +

    $().popover({{_i}}options{{/i}})

    +

    {{_i}}Initializes popovers for an element collection.{{/i}}

    +

    .popover('show')

    +

    {{_i}}Reveals an elements popover.{{/i}}

    +
    $('#element').popover('show')
    +

    .popover('hide')

    +

    {{_i}}Hides an elements popover.{{/i}}

    +
    $('#element').popover('hide')
    +

    .popover('toggle')

    +

    {{_i}}Toggles an elements popover.{{/i}}

    +
    $('#element').popover('toggle')
    +

    .popover('destroy')

    +

    {{_i}}Destroys an element's popover.{{/i}}

    +
    $('#element').popover('destroy')
    +
    + + + + +
    + + + +

    {{_i}}Example alerts{{/i}}

    +

    {{_i}}Add dismiss functionality to all alerge messages with this plugin.{{/i}}

    +
    +
    + + {{_i}}Holy guacamole!{{/i}} {{_i}}Best check yo self, you're not looking too good.{{/i}} +
    +
    {{! /example }} + +
    +
    + +

    {{_i}}Oh snap! You got an error!{{/i}}

    +

    {{_i}}Change this and that and try again. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.{{/i}}

    +

    + {{_i}}Take this action{{/i}} {{_i}}Or do this{{/i}} +

    +
    +
    {{! /example }} + + +
    + + +

    {{_i}}Usage{{/i}}

    +

    {{_i}}Enable dismissal of an alert via javascript:{{/i}}

    +
    $(".alert").alert()
    + +

    {{_i}}Markup{{/i}}

    +

    {{_i}}Just add data-dismiss="alert" to your close button to automatically give an alert close functionality.{{/i}}

    +
    <a class="close" data-dismiss="alert" href="#">&times;</a>
    + +

    {{_i}}Methods{{/i}}

    +

    $().alert()

    +

    {{_i}}Wraps all alerts with close functionality. To have your alerts animate out when closed, make sure they have the .fade and .in class already applied to them.{{/i}}

    +

    .alert('close')

    +

    {{_i}}Closes an alert.{{/i}}

    +
    $(".alert").alert('close')
    + + +

    {{_i}}Events{{/i}}

    +

    {{_i}}Bootstrap's alert class exposes a few events for hooking into alert functionality.{{/i}}

    + + + + + + + + + + + + + + + + + +
    {{_i}}Event{{/i}}{{_i}}Description{{/i}}
    {{_i}}close{{/i}}{{_i}}This event fires immediately when the close instance method is called.{{/i}}
    {{_i}}closed{{/i}}{{_i}}This event is fired when the alert has been closed (will wait for css transitions to complete).{{/i}}
     $('#my-alert').bind('closed', function () {
       // {{_i}}do something…{{/i}}
    -})
    -
    +}) + + - -
    - + +
    + -

    {{_i}}Example uses{{/i}}

    -

    {{_i}}Do more with buttons. Control button states or create groups of buttons for more components like toolbars.{{/i}}

    +

    {{_i}}Example uses{{/i}}

    +

    {{_i}}Do more with buttons. Control button states or create groups of buttons for more components like toolbars.{{/i}}

    -

    {{_i}}Stateful{{/i}}

    -

    {{_i}}Add data-loading-text="Loading..." to use a loading state on a button.{{/i}}

    -
    - -
    {{! /example }} +

    {{_i}}Stateful{{/i}}

    +

    {{_i}}Add data-loading-text="Loading..." to use a loading state on a button.{{/i}}

    +
    + +
    {{! /example }}
     <button type="button" class="btn btn-primary" data-loading-text="Loading...">Loading state</button>
     
    -

    {{_i}}Single toggle{{/i}}

    -

    {{_i}}Add data-toggle="button" to activate toggling on a single button.{{/i}}

    -
    - -
    {{! /example }} +

    {{_i}}Single toggle{{/i}}

    +

    {{_i}}Add data-toggle="button" to activate toggling on a single button.{{/i}}

    +
    + +
    {{! /example }}
     <button type="button" class="btn" data-toggle="button">Single Toggle</button>
     
    -

    {{_i}}Checkbox{{/i}}

    -

    {{_i}}Add data-toggle="buttons-checkbox" for checkbox style toggling on btn-group.{{/i}}

    -
    -
    - - - -
    -
    {{! /example }} +

    {{_i}}Checkbox{{/i}}

    +

    {{_i}}Add data-toggle="buttons-checkbox" for checkbox style toggling on btn-group.{{/i}}

    +
    +
    + + + +
    +
    {{! /example }}
     <div class="btn-group" data-toggle="buttons-checkbox">
       <button type="button" class="btn">Left</button>
    @@ -1058,15 +1065,15 @@ $('#my-alert').bind('closed', function () {
     </div>
     
    -

    {{_i}}Radio{{/i}}

    -

    {{_i}}Add data-toggle="buttons-radio" for radio style toggling on btn-group.{{/i}}

    -
    -
    - - - -
    -
    {{! /example }} +

    {{_i}}Radio{{/i}}

    +

    {{_i}}Add data-toggle="buttons-radio" for radio style toggling on btn-group.{{/i}}

    +
    +
    + + + +
    +
    {{! /example }}
     <div class="btn-group" data-toggle="buttons-radio">
       <button type="button" class="btn">Left</button>
    @@ -1076,101 +1083,101 @@ $('#my-alert').bind('closed', function () {
     
    -
    +
    -

    {{_i}}Usage{{/i}}

    -

    {{_i}}Enable buttons via javascript:{{/i}}

    -
    $('.nav-tabs').button()
    +

    {{_i}}Usage{{/i}}

    +

    {{_i}}Enable buttons via javascript:{{/i}}

    +
    $('.nav-tabs').button()
    -

    {{_i}}Markup{{/i}}

    -

    {{_i}}Data attributes are integral to the button plugin. Check out the example code below for the various markup types.{{/i}}

    +

    {{_i}}Markup{{/i}}

    +

    {{_i}}Data attributes are integral to the button plugin. Check out the example code below for the various markup types.{{/i}}

    -

    {{_i}}Options{{/i}}

    -

    {{_i}}None{{/i}}

    +

    {{_i}}Options{{/i}}

    +

    {{_i}}None{{/i}}

    -

    {{_i}}Methods{{/i}}

    -

    $().button('toggle')

    -

    {{_i}}Toggles push state. Gives the button the appearance that it has been activated.{{/i}}

    -
    - {{_i}}Heads up!{{/i}} - {{_i}}You can enable auto toggling of a button by using the data-toggle attribute.{{/i}} -
    -
    <button type="button" class="btn" data-toggle="button" >…</button>
    -

    $().button('loading')

    -

    {{_i}}Sets button state to loading - disables button and swaps text to loading text. Loading text should be defined on the button element using the data attribute data-loading-text.{{/i}} -

    -
    <button type="button" class="btn" data-loading-text="loading stuff..." >...</button>
    -
    - {{_i}}Heads up!{{/i}} - {{_i}}Firefox persists the disabled state across page loads. A workaround for this is to use autocomplete="off".{{/i}} -
    -

    $().button('reset')

    -

    {{_i}}Resets button state - swaps text to original text.{{/i}}

    -

    $().button(string)

    -

    {{_i}}Resets button state - swaps text to any data defined text state.{{/i}}

    +

    {{_i}}Methods{{/i}}

    +

    $().button('toggle')

    +

    {{_i}}Toggles push state. Gives the button the appearance that it has been activated.{{/i}}

    +
    + {{_i}}Heads up!{{/i}} + {{_i}}You can enable auto toggling of a button by using the data-toggle attribute.{{/i}} +
    +
    <button type="button" class="btn" data-toggle="button" >…</button>
    +

    $().button('loading')

    +

    {{_i}}Sets button state to loading - disables button and swaps text to loading text. Loading text should be defined on the button element using the data attribute data-loading-text.{{/i}} +

    +
    <button type="button" class="btn" data-loading-text="loading stuff..." >...</button>
    +
    + {{_i}}Heads up!{{/i}} + {{_i}}Firefox persists the disabled state across page loads. A workaround for this is to use autocomplete="off".{{/i}} +
    +

    $().button('reset')

    +

    {{_i}}Resets button state - swaps text to original text.{{/i}}

    +

    $().button(string)

    +

    {{_i}}Resets button state - swaps text to any data defined text state.{{/i}}

    <button type="button" class="btn" data-complete-text="finished!" >...</button>
     <script>
       $('.btn').button('complete')
     </script>
    -
    +
    - -
    - - -

    {{_i}}About{{/i}}

    -

    {{_i}}Get base styles and flexible support for collapsible components like accordions and navigation.{{/i}}

    -

    * {{_i}}Requires the Transitions plugin to be included.{{/i}}

    - -

    {{_i}}Example accordion{{/i}}

    -

    {{_i}}Using the collapse plugin, we built a simple accordion style widget:{{/i}}

    - -
    -
    -
    - -
    -
    - Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS. -
    -
    -
    -
    - -
    -
    - Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS. -
    -
    -
    -
    - -
    -
    - Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS. -
    -
    -
    + +
    + -
    {{! /example }} + +

    {{_i}}About{{/i}}

    +

    {{_i}}Get base styles and flexible support for collapsible components like accordions and navigation.{{/i}}

    +

    * {{_i}}Requires the Transitions plugin to be included.{{/i}}

    + +

    {{_i}}Example accordion{{/i}}

    +

    {{_i}}Using the collapse plugin, we built a simple accordion style widget:{{/i}}

    + +
    +
    +
    + +
    +
    + Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS. +
    +
    +
    +
    + +
    +
    + Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS. +
    +
    +
    +
    + +
    +
    + Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS. +
    +
    +
    +
    +
    {{! /example }}
     <button type="button" class="btn btn-danger" data-toggle="collapse" data-target="#demo">
       {{_i}}simple collapsible{{/i}}
    @@ -1180,137 +1187,137 @@ $('#my-alert').bind('closed', function () {
     
    -
    +
    -

    {{_i}}Usage{{/i}}

    +

    {{_i}}Usage{{/i}}

    -

    {{_i}}Via data attributes{{/i}}

    -

    {{_i}}Just add data-toggle="collapse" and a data-target to element to automatically assign control of a collapsible element. The data-target attribute accepts a css selector to apply the collapse to. Be sure to add the class collapse to the collapsible element. If you'd like it to default open, add the additional class in.{{/i}}

    -

    {{_i}}To add accordion-like group management to a collapsible control, add the data attribute data-parent="#selector". Refer to the demo to see this in action.{{/i}}

    +

    {{_i}}Via data attributes{{/i}}

    +

    {{_i}}Just add data-toggle="collapse" and a data-target to element to automatically assign control of a collapsible element. The data-target attribute accepts a css selector to apply the collapse to. Be sure to add the class collapse to the collapsible element. If you'd like it to default open, add the additional class in.{{/i}}

    +

    {{_i}}To add accordion-like group management to a collapsible control, add the data attribute data-parent="#selector". Refer to the demo to see this in action.{{/i}}

    -

    {{_i}}Via javascript{{/i}}

    -

    {{_i}}Enable manually with:{{/i}}

    -
    $(".collapse").collapse()
    +

    {{_i}}Via javascript{{/i}}

    +

    {{_i}}Enable manually with:{{/i}}

    +
    $(".collapse").collapse()
    -

    {{_i}}Options{{/i}}

    -

    {{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-, as in data-parent="".{{/i}}

    - - - - - - - - - - - - - - - - - - - - - - - -
    {{_i}}Name{{/i}}{{_i}}type{{/i}}{{_i}}default{{/i}}{{_i}}description{{/i}}
    {{_i}}parent{{/i}}{{_i}}selector{{/i}}false{{_i}}If selector then all collapsible elements under the specified parent will be closed when this collapsible item is shown. (similar to traditional accordion behavior){{/i}}
    {{_i}}toggle{{/i}}{{_i}}boolean{{/i}}true{{_i}}Toggles the collapsible element on invocation{{/i}}
    +

    {{_i}}Options{{/i}}

    +

    {{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-, as in data-parent="".{{/i}}

    + + + + + + + + + + + + + + + + + + + + + + + +
    {{_i}}Name{{/i}}{{_i}}type{{/i}}{{_i}}default{{/i}}{{_i}}description{{/i}}
    {{_i}}parent{{/i}}{{_i}}selector{{/i}}false{{_i}}If selector then all collapsible elements under the specified parent will be closed when this collapsible item is shown. (similar to traditional accordion behavior){{/i}}
    {{_i}}toggle{{/i}}{{_i}}boolean{{/i}}true{{_i}}Toggles the collapsible element on invocation{{/i}}
    -

    {{_i}}Methods{{/i}}

    -

    .collapse({{_i}}options{{/i}})

    -

    {{_i}}Activates your content as a collapsible element. Accepts an optional options object.{{/i}} +

    {{_i}}Methods{{/i}}

    +

    .collapse({{_i}}options{{/i}})

    +

    {{_i}}Activates your content as a collapsible element. Accepts an optional options object.{{/i}}

     $('#myCollapsible').collapse({
       toggle: false
     })
    -

    .collapse('toggle')

    -

    {{_i}}Toggles a collapsible element to shown or hidden.{{/i}}

    -

    .collapse('show')

    -

    {{_i}}Shows a collapsible element.{{/i}}

    -

    .collapse('hide')

    -

    {{_i}}Hides a collapsible element.{{/i}}

    +

    .collapse('toggle')

    +

    {{_i}}Toggles a collapsible element to shown or hidden.{{/i}}

    +

    .collapse('show')

    +

    {{_i}}Shows a collapsible element.{{/i}}

    +

    .collapse('hide')

    +

    {{_i}}Hides a collapsible element.{{/i}}

    -

    {{_i}}Events{{/i}}

    -

    {{_i}}Bootstrap's collapse class exposes a few events for hooking into collapse functionality.{{/i}}

    - - - - - - - - - - - - - - - - - - - - - - - - - -
    {{_i}}Event{{/i}}{{_i}}Description{{/i}}
    {{_i}}show{{/i}}{{_i}}This event fires immediately when the show instance method is called.{{/i}}
    {{_i}}shown{{/i}}{{_i}}This event is fired when a collapse element has been made visible to the user (will wait for css transitions to complete).{{/i}}
    {{_i}}hide{{/i}} - {{_i}}This event is fired immediately when the hide method has been called.{{/i}} -
    {{_i}}hidden{{/i}}{{_i}}This event is fired when a collapse element has been hidden from the user (will wait for css transitions to complete).{{/i}}
    +

    {{_i}}Events{{/i}}

    +

    {{_i}}Bootstrap's collapse class exposes a few events for hooking into collapse functionality.{{/i}}

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    {{_i}}Event{{/i}}{{_i}}Description{{/i}}
    {{_i}}show{{/i}}{{_i}}This event fires immediately when the show instance method is called.{{/i}}
    {{_i}}shown{{/i}}{{_i}}This event is fired when a collapse element has been made visible to the user (will wait for css transitions to complete).{{/i}}
    {{_i}}hide{{/i}} + {{_i}}This event is fired immediately when the hide method has been called.{{/i}} +
    {{_i}}hidden{{/i}}{{_i}}This event is fired when a collapse element has been hidden from the user (will wait for css transitions to complete).{{/i}}
     $('#myCollapsible').on('hidden', function () {
       // {{_i}}do something…{{/i}}
     })
    -
    + - - +

    {{_i}}Events{{/i}}

    +

    {{_i}}Bootstrap's carousel class exposes two events for hooking into carousel functionality.{{/i}}

    + + + + + + + + + + + + + + + + + +
    {{_i}}Event{{/i}}{{_i}}Description{{/i}}
    {{_i}}slide{{/i}}{{_i}}This event fires immediately when the slide instance method is invoked.{{/i}}
    {{_i}}slid{{/i}}{{_i}}This event is fired when the carousel has completed its slide transition.{{/i}}
    + - -
    - + +
    + -

    {{_i}}Example{{/i}}

    -

    {{_i}}A basic, easily extended plugin for quickly creating elegant typeaheads with any form text input.{{/i}}

    -
    - -
    {{! /example }} +

    {{_i}}Example{{/i}}

    +

    {{_i}}A basic, easily extended plugin for quickly creating elegant typeaheads with any form text input.{{/i}}

    +
    + +
    {{! /example }}
     <input type="text" data-provide="typeahead">
     
    -
    +
    -

    {{_i}}Usage{{/i}}

    +

    {{_i}}Usage{{/i}}

    -

    {{_i}}Via data attributes{{/i}}

    -

    {{_i}}Add data attributes to register an element with typeahead functionality as shown in the example above.{{/i}}

    +

    {{_i}}Via data attributes{{/i}}

    +

    {{_i}}Add data attributes to register an element with typeahead functionality as shown in the example above.{{/i}}

    -

    {{_i}}Via javascript{{/i}}

    -

    {{_i}}Call the typeahead manually with:{{/i}}

    -
    $('.typeahead').typeahead()
    +

    {{_i}}Via javascript{{/i}}

    +

    {{_i}}Call the typeahead manually with:{{/i}}

    +
    $('.typeahead').typeahead()
    -

    {{_i}}Options{{/i}}

    -

    {{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-, as in data-source="".{{/i}}

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    {{_i}}Name{{/i}}{{_i}}type{{/i}}{{_i}}default{{/i}}{{_i}}description{{/i}}
    {{_i}}source{{/i}}{{_i}}array, function{{/i}}[ ]{{_i}}The data source to query against. May be an array of strings or a function. The function is passed two arguments, the query value in the input field and the process callback. The function may be used synchronously by returning the data source directly or asynchronously via the process callback's single argument.{{/i}}
    {{_i}}items{{/i}}{{_i}}number{{/i}}8{{_i}}The max number of items to display in the dropdown.{{/i}}
    {{_i}}matcher{{/i}}{{_i}}function{{/i}}{{_i}}case insensitive{{/i}}{{_i}}The method used to determine if a query matches an item. Accepts a single argument, the item against which to test the query. Access the current query with this.query. Return a boolean true if query is a match.{{/i}}
    {{_i}}sorter{{/i}}{{_i}}function{{/i}}{{_i}}exact match,
    case sensitive,
    case insensitive{{/i}}
    {{_i}}Method used to sort autocomplete results. Accepts a single argument items and has the scope of the typeahead instance. Reference the current query with this.query.{{/i}}
    {{_i}}highlighter{{/i}}{{_i}}function{{/i}}{{_i}}highlights all default matches{{/i}}{{_i}}Method used to highlight autocomplete results. Accepts a single argument item and has the scope of the typeahead instance. Should return html.{{/i}}
    +

    {{_i}}Options{{/i}}

    +

    {{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-, as in data-source="".{{/i}}

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    {{_i}}Name{{/i}}{{_i}}type{{/i}}{{_i}}default{{/i}}{{_i}}description{{/i}}
    {{_i}}source{{/i}}{{_i}}array, function{{/i}}[ ]{{_i}}The data source to query against. May be an array of strings or a function. The function is passed two arguments, the query value in the input field and the process callback. The function may be used synchronously by returning the data source directly or asynchronously via the process callback's single argument.{{/i}}
    {{_i}}items{{/i}}{{_i}}number{{/i}}8{{_i}}The max number of items to display in the dropdown.{{/i}}
    {{_i}}matcher{{/i}}{{_i}}function{{/i}}{{_i}}case insensitive{{/i}}{{_i}}The method used to determine if a query matches an item. Accepts a single argument, the item against which to test the query. Access the current query with this.query. Return a boolean true if query is a match.{{/i}}
    {{_i}}sorter{{/i}}{{_i}}function{{/i}}{{_i}}exact match,
    case sensitive,
    case insensitive{{/i}}
    {{_i}}Method used to sort autocomplete results. Accepts a single argument items and has the scope of the typeahead instance. Reference the current query with this.query.{{/i}}
    {{_i}}highlighter{{/i}}{{_i}}function{{/i}}{{_i}}highlights all default matches{{/i}}{{_i}}Method used to highlight autocomplete results. Accepts a single argument item and has the scope of the typeahead instance. Should return html.{{/i}}
    -

    {{_i}}Methods{{/i}}

    -

    .typeahead({{_i}}options{{/i}})

    -

    {{_i}}Initializes an input with a typeahead.{{/i}}

    -
    +

    {{_i}}Methods{{/i}}

    +

    .typeahead({{_i}}options{{/i}})

    +

    {{_i}}Initializes an input with a typeahead.{{/i}}

    +
    - -
    - + +
    + -

    {{_i}}...{{/i}}

    -

    {{_i}}...{{/i}}

    -
    +

    {{_i}}...{{/i}}

    +

    {{_i}}...{{/i}}

    +
    -
    +
     ...
     
    -
    +
    -
    {{! /span9 }} -
    {{! row}} +
    {{! /span9 }} +
    {{! row}} + +{{! /container }} diff --git a/docs/templates/pages/scaffolding.mustache b/docs/templates/pages/scaffolding.mustache index 05e1c4e2ad..86806bb563 100644 --- a/docs/templates/pages/scaffolding.mustache +++ b/docs/templates/pages/scaffolding.mustache @@ -1,38 +1,41 @@
    -

    {{_i}}Scaffolding{{/i}}

    -

    {{_i}}Bootstrap is built on a responsive 12-column grid. We've also included fixed- and fluid-width layouts based on that system.{{/i}}

    +
    +

    {{_i}}Scaffolding{{/i}}

    +

    {{_i}}Bootstrap is built on a responsive 12-column grid and includes fixed- and fluid-width layouts.{{/i}}

    +
    +
    - -
    - -
    + + +
    + +
    - -
    - + +
    + -

    {{_i}}Requires HTML5 doctype{{/i}}

    -

    {{_i}}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.{{/i}}

    +

    {{_i}}Requires HTML5 doctype{{/i}}

    +

    {{_i}}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.{{/i}}

     <!DOCTYPE html>
     <html lang="en">
    @@ -40,84 +43,84 @@
     </html>
     
    -

    {{_i}}Typography and links{{/i}}

    -

    {{_i}}Bootstrap sets basic global display, typography, and link styles. Specifically, we:{{/i}}

    -
      -
    • {{_i}}Remove margin on the body{{/i}}
    • -
    • {{_i}}Set background-color: white; on the body{{/i}}
    • -
    • {{_i}}Use the @baseFontFamily, @baseFontSize, and @baseLineHeight attributes as our typographyic base{{/i}}
    • -
    • {{_i}}Set the global link color via @linkColor and apply link underlines only on :hover{{/i}}
    • -
    -

    {{_i}}These styles can be found within scaffolding.less.{{/i}}

    +

    {{_i}}Typography and links{{/i}}

    +

    {{_i}}Bootstrap sets basic global display, typography, and link styles. Specifically, we:{{/i}}

    +
      +
    • {{_i}}Remove margin on the body{{/i}}
    • +
    • {{_i}}Set background-color: white; on the body{{/i}}
    • +
    • {{_i}}Use the @baseFontFamily, @baseFontSize, and @baseLineHeight attributes as our typographyic base{{/i}}
    • +
    • {{_i}}Set the global link color via @linkColor and apply link underlines only on :hover{{/i}}
    • +
    +

    {{_i}}These styles can be found within scaffolding.less.{{/i}}

    -

    {{_i}}Reset via Normalize{{/i}}

    -

    {{_i}}With Bootstrap 2, the old reset block has been dropped in favor of Normalize.css, a project by Nicolas Gallagher that also powers the HTML5 Boilerplate. While we use much of Normalize within our reset.less, we have removed some elements specifically for Bootstrap.{{/i}}

    +

    {{_i}}Reset via Normalize{{/i}}

    +

    {{_i}}With Bootstrap 2, the old reset block has been dropped in favor of Normalize.css, a project by Nicolas Gallagher that also powers the HTML5 Boilerplate. While we use much of Normalize within our reset.less, we have removed some elements specifically for Bootstrap.{{/i}}

    -
    +
    - -
    - - -

    {{_i}}Live grid example{{/i}}

    -

    {{_i}}The default Bootstrap grid system utilizes 12 columns, making for a 940px wide container without responsive features 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.{{/i}}

    -
    -
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    + +
    + -
    -
    2
    -
    3
    -
    4
    -
    -
    -
    4
    -
    5
    -
    -
    -
    9
    -
    -
    -

    {{_i}}Basic grid HTML{{/i}}

    -

    {{_i}}For a simple two column layout, create a .row and add the appropriate number of .span* columns. As this is a 12-column grid, each .span* spans a number of those 12 columns, and should always add up to 12 for each row.{{/i}}

    +

    {{_i}}Live grid example{{/i}}

    +

    {{_i}}The default Bootstrap grid system utilizes 12 columns, making for a 940px wide container without responsive features 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.{{/i}}

    +
    +
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    +
    +
    2
    +
    3
    +
    4
    +
    +
    +
    4
    +
    5
    +
    +
    +
    9
    +
    +
    + +

    {{_i}}Basic grid HTML{{/i}}

    +

    {{_i}}For a simple two column layout, create a .row and add the appropriate number of .span* columns. As this is a 12-column grid, each .span* spans a number of those 12 columns, and should always add up to 12 for each row.{{/i}}

     <div class="row">
       <div class="span4">...</div>
       <div class="span8">...</div>
     </div>
     
    -

    {{_i}}Given this example, we have .span4 and .span8, making for 12 total columns and a complete row.{{/i}}

    +

    {{_i}}Given this example, we have .span4 and .span8, making for 12 total columns and a complete row.{{/i}}

    -

    {{_i}}Offsetting columns{{/i}}

    -

    {{_i}}Move columns to the left using .offset* classes. Each class increases the left margin of a column by a whole column. For example, .offset4 moves .span4 over four columns.{{/i}}

    -
    -
    -
    4
    -
    3 offset 2
    -
    -
    -
    3 offset 1
    -
    3 offset 2
    -
    -
    -
    6 offset 3
    -
    -
    +

    {{_i}}Offsetting columns{{/i}}

    +

    {{_i}}Move columns to the left using .offset* classes. Each class increases the left margin of a column by a whole column. For example, .offset4 moves .span4 over four columns.{{/i}}

    +
    +
    +
    4
    +
    3 offset 2
    +
    +
    +
    3 offset 1
    +
    3 offset 2
    +
    +
    +
    6 offset 3
    +
    +
     <div class="row">
       <div class="span4">...</div>
    @@ -125,23 +128,23 @@
     </div>
     
    -

    {{_i}}Nesting columns{{/i}}

    -

    {{_i}}To nest your content with the default grid, add a new .row and set of .span* columns within an existing .span* column. Nested rows should include a set of columns that add up to the number of columns of its parent.{{/i}}

    -

    {{_i}}Example{{/i}}

    -

    {{_i}}Here two nested .span4 columns are placed within a .span8.{{/i}}

    -
    -
    - {{_i}}Level 1 of column{{/i}} -
    -
    - {{_i}}Level 2{{/i}} -
    -
    - {{_i}}Level 2{{/i}} +

    {{_i}}Nesting columns{{/i}}

    +

    {{_i}}To nest your content with the default grid, add a new .row and set of .span* columns within an existing .span* column. Nested rows should include a set of columns that add up to the number of columns of its parent.{{/i}}

    +

    {{_i}}Example{{/i}}

    +

    {{_i}}Here two nested .span4 columns are placed within a .span8.{{/i}}

    +
    +
    + {{_i}}Level 1 of column{{/i}} +
    +
    + {{_i}}Level 2{{/i}} +
    +
    + {{_i}}Level 2{{/i}} +
    -
     <div class="row">
       <div class="span10">
    @@ -153,54 +156,54 @@
       </div>
     </div>
     
    -
    + - -
    - + +
    + -

    {{_i}}Live fluid grid example{{/i}}

    -

    {{_i}}The fluid grid system uses percents instead of pixels for column widths. It has the same responsive capabilities as our fixed grid system, ensuring proper proportions for key screen resolutions and devices.{{/i}}

    -
    -
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    -
    1
    +

    {{_i}}Live fluid grid example{{/i}}

    +

    {{_i}}The fluid grid system uses percents instead of pixels for column widths. It has the same responsive capabilities as our fixed grid system, ensuring proper proportions for key screen resolutions and devices.{{/i}}

    +
    +
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    1
    +
    +
    +
    4
    +
    4
    +
    4
    +
    +
    +
    4
    +
    8
    +
    +
    +
    6
    +
    6
    +
    +
    +
    12
    +
    -
    -
    4
    -
    4
    -
    4
    -
    -
    -
    4
    -
    8
    -
    -
    -
    6
    -
    6
    -
    -
    -
    12
    -
    -
    -

    {{_i}}Basic fluid grid HTML{{/i}}

    -

    {{_i}}Make any row "fluid" by changing .row to .row-fluid. The column classes stay the exact same, making it easy to flip between fixed and fluid grids.{{/i}}

    +

    {{_i}}Basic fluid grid HTML{{/i}}

    +

    {{_i}}Make any row "fluid" by changing .row to .row-fluid. The column classes stay the exact same, making it easy to flip between fixed and fluid grids.{{/i}}

     <div class="row-fluid">
       <div class="span4">...</div>
    @@ -208,21 +211,21 @@
     </div>
     
    -

    {{_i}}Fluid offsetting{{/i}}

    -

    {{_i}}Operates the same way as the fixed grid system offsetting: add .offset* to any column to offset by that many columns.{{/i}}

    -
    -
    -
    4
    -
    4 offset 4
    -
    -
    -
    3 offset 3
    -
    3 offset 3
    -
    -
    -
    6 offset 6
    -
    -
    +

    {{_i}}Fluid offsetting{{/i}}

    +

    {{_i}}Operates the same way as the fixed grid system offsetting: add .offset* to any column to offset by that many columns.{{/i}}

    +
    +
    +
    4
    +
    4 offset 4
    +
    +
    +
    3 offset 3
    +
    3 offset 3
    +
    +
    +
    6 offset 6
    +
    +
     <div class="row-fluid">
       <div class="span4">...</div>
    @@ -230,21 +233,21 @@
     </div>
     
    -

    {{_i}}Fluid nesting{{/i}}

    -

    {{_i}}Nesting with fluid grids is a bit different: the number of nested columns should not match the parent's number of columns. Instead, each level of nested columns are reset because each row takes up 100% of the parent column.{{/i}}

    -
    -
    - {{_i}}Fluid 12{{/i}} -
    -
    - {{_i}}Fluid 6{{/i}} -
    -
    - {{_i}}Fluid 6{{/i}} +

    {{_i}}Fluid nesting{{/i}}

    +

    {{_i}}Nesting with fluid grids is a bit different: the number of nested columns should not match the parent's number of columns. Instead, each level of nested columns are reset because each row takes up 100% of the parent column.{{/i}}

    +
    +
    + {{_i}}Fluid 12{{/i}} +
    +
    + {{_i}}Fluid 6{{/i}} +
    +
    + {{_i}}Fluid 6{{/i}} +
    -
     <div class="row-fluid">
       <div class="span12">
    @@ -257,78 +260,23 @@
     </div>
     
    -
    +
    - -
    - -

    {{_i}}Variables in LESS{{/i}}

    -

    {{_i}}The default grid is built on a few variables for easy customization via LESS. All variables can be found in variables.less.{{/i}}

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    {{_i}}Variable{{/i}}{{_i}}Default value{{/i}}{{_i}}Description{{/i}}
    @gridColumns12{{_i}}Number of columns{{/i}}
    @gridColumnWidth60px{{_i}}Width of each column{{/i}}
    @gridGutterWidth20px{{_i}}Negative space between columns{{/i}}
    @fluidGridColumnWidth6.382978723%{{_i}}Width of each fluid column{{/i}}
    @fluidGridGutterWidth2.127659574%{{_i}}Negative space between fluid columns{{/i}}
    + +
    + -

    {{_i}}How to customize{{/i}}

    -

    {{_i}}Modifying the grid means changing the three @grid* variables and recompiling Bootstrap. Change the grid variables in variables.less and use one of the four ways documented to recompile. If you're adding more columns, be sure to add the CSS for those in grid.less.{{/i}}

    - -

    {{_i}}Staying responsive{{/i}}

    -

    {{_i}}Customization of the grid only works at the default level, the 940px grid. To maintain the responsive aspects of Bootstrap, you'll also have to manually customize the grids in responsive.less until a future update improves this.{{/i}}

    - -
    - - - - -
    - - -

    {{_i}}Fixed layout{{/i}}

    -

    {{_i}}Provides a common fixed-width (and optionally responsive) layout with only <div class="container"> required.{{/i}}

    -
    -
    -
    +

    {{_i}}Fixed layout{{/i}}

    +

    {{_i}}Provides a common fixed-width (and optionally responsive) layout with only <div class="container"> required.{{/i}}

    +
    +
    +
     <body>
       <div class="container">
    @@ -337,12 +285,12 @@
     </body>
     
    -

    {{_i}}Fluid layout{{/i}}

    -

    {{_i}}Create a fluid, two-column page with <div class="container-fluid">—great for applications and docs.{{/i}}

    -
    -
    -
    -
    +

    {{_i}}Fluid layout{{/i}}

    +

    {{_i}}Create a fluid, two-column page with <div class="container-fluid">—great for applications and docs.{{/i}}

    +
    +
    +
    +
     <div class="container-fluid">
       <div class="row-fluid">
    @@ -355,81 +303,81 @@
       </div>
     </div>
     
    -
    +
    - -
    - + +
    + - {{! Enabling }} -

    {{_i}}Enabling responsive features{{/i}}

    -

    {{_i}}Turn on responsive CSS in your project by including the proper meta tag and additional stylesheet within the <head> of your document. If you've compiled Bootstrap from the Customize page, you need only include the meta tag.{{/i}}

    + {{! Enabling }} +

    {{_i}}Enabling responsive features{{/i}}

    +

    {{_i}}Turn on responsive CSS in your project by including the proper meta tag and additional stylesheet within the <head> of your document. If you've compiled Bootstrap from the Customize page, you need only include the meta tag.{{/i}}

     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <link href="assets/css/bootstrap-responsive.css" rel="stylesheet">
     
    -

    {{_i}}Heads up!{{/i}} {{_i}} Bootstrap doesn't include responsive features by default at this time as not everything needs to be responsive. Instead of encouraging developers to remove this feature, we figure it best to enable it as needed.{{/i}}

    +

    {{_i}}Heads up!{{/i}} {{_i}} Bootstrap doesn't include responsive features by default at this time as not everything needs to be responsive. Instead of encouraging developers to remove this feature, we figure it best to enable it as needed.{{/i}}

    - {{! About }} -

    {{_i}}About responsive Bootstrap{{/i}}

    - Responsive devices -

    {{_i}}Media queries allow for custom CSS based on a number of conditions—ratios, widths, display type, etc—but usually focuses around min-width and max-width.{{/i}}

    -
      -
    • {{_i}}Modify the width of column in our grid{{/i}}
    • -
    • {{_i}}Stack elements instead of float wherever necessary{{/i}}
    • -
    • {{_i}}Resize headings and text to be more appropriate for devices{{/i}}
    • -
    -

    {{_i}}Use media queries responsibly and only as a start to your mobile audiences. For larger projects, do consider dedicated code bases and not layers of media queries.{{/i}}

    + {{! About }} +

    {{_i}}About responsive Bootstrap{{/i}}

    + Responsive devices +

    {{_i}}Media queries allow for custom CSS based on a number of conditions—ratios, widths, display type, etc—but usually focuses around min-width and max-width.{{/i}}

    +
      +
    • {{_i}}Modify the width of column in our grid{{/i}}
    • +
    • {{_i}}Stack elements instead of float wherever necessary{{/i}}
    • +
    • {{_i}}Resize headings and text to be more appropriate for devices{{/i}}
    • +
    +

    {{_i}}Use media queries responsibly and only as a start to your mobile audiences. For larger projects, do consider dedicated code bases and not layers of media queries.{{/i}}

    - {{! Supported }} -

    {{_i}}Supported devices{{/i}}

    -

    {{_i}}Bootstrap supports a handful of media queries in a single file to help make your projects more appropriate on different devices and screen resolutions. Here's what's included:{{/i}}

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    {{_i}}Label{{/i}}{{_i}}Layout width{{/i}}{{_i}}Column width{{/i}}{{_i}}Gutter width{{/i}}
    {{_i}}Phones{{/i}}480px and below{{_i}}Fluid columns, no fixed widths{{/i}}
    {{_i}}Phones to tablets{{/i}}767px and below{{_i}}Fluid columns, no fixed widths{{/i}}
    {{_i}}Portrait tablets{{/i}}768px and above42px20px
    {{_i}}Default{{/i}}980px and up60px20px
    {{_i}}Large display{{/i}}1200px and up70px30px
    + {{! Supported }} +

    {{_i}}Supported devices{{/i}}

    +

    {{_i}}Bootstrap supports a handful of media queries in a single file to help make your projects more appropriate on different devices and screen resolutions. Here's what's included:{{/i}}

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    {{_i}}Label{{/i}}{{_i}}Layout width{{/i}}{{_i}}Column width{{/i}}{{_i}}Gutter width{{/i}}
    {{_i}}Phones{{/i}}480px and below{{_i}}Fluid columns, no fixed widths{{/i}}
    {{_i}}Phones to tablets{{/i}}767px and below{{_i}}Fluid columns, no fixed widths{{/i}}
    {{_i}}Portrait tablets{{/i}}768px and above42px20px
    {{_i}}Default{{/i}}980px and up60px20px
    {{_i}}Large display{{/i}}1200px and up70px30px
     /* {{_i}}Landscape phones and down{{/i}} */
     @media (max-width: 480px) { ... }
    @@ -445,81 +393,83 @@
     
    - {{! Responsive utility classes }} -

    {{_i}}Responsive utility classes{{/i}}

    -

    {{_i}}For faster mobile-friendly development, use these utility classes for showing and hiding content by device. Below is a table of the available classes and their effect on a given media query layout (labeled by device). They can be found in responsive.less.{{/i}}

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    {{_i}}Class{{/i}}{{_i}}Phones 767px and below{{/i}}{{_i}}Tablets 979px to 768px{{/i}}{{_i}}Desktops Default{{/i}}
    .visible-phone{{_i}}Visible{{/i}}
    .visible-tablet{{_i}}Visible{{/i}}
    .visible-desktop{{_i}}Visible{{/i}}
    .hidden-phone{{_i}}Visible{{/i}}{{_i}}Visible{{/i}}
    .hidden-tablet{{_i}}Visible{{/i}}{{_i}}Visible{{/i}}
    .hidden-desktop{{_i}}Visible{{/i}}{{_i}}Visible{{/i}}
    + {{! Responsive utility classes }} +

    {{_i}}Responsive utility classes{{/i}}

    +

    {{_i}}For faster mobile-friendly development, use these utility classes for showing and hiding content by device. Below is a table of the available classes and their effect on a given media query layout (labeled by device). They can be found in responsive.less.{{/i}}

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    {{_i}}Class{{/i}}{{_i}}Phones 767px and below{{/i}}{{_i}}Tablets 979px to 768px{{/i}}{{_i}}Desktops Default{{/i}}
    .visible-phone{{_i}}Visible{{/i}}
    .visible-tablet{{_i}}Visible{{/i}}
    .visible-desktop{{_i}}Visible{{/i}}
    .hidden-phone{{_i}}Visible{{/i}}{{_i}}Visible{{/i}}
    .hidden-tablet{{_i}}Visible{{/i}}{{_i}}Visible{{/i}}
    .hidden-desktop{{_i}}Visible{{/i}}{{_i}}Visible{{/i}}
    -

    {{_i}}When to use{{/i}}

    -

    {{_i}}Use on a limited basis and avoid creating entirely different versions of the same site. Instead, use them to complement each device's presentation.{{/i}}

    +

    {{_i}}When to use{{/i}}

    +

    {{_i}}Use on a limited basis and avoid creating entirely different versions of the same site. Instead, use them to complement each device's presentation.{{/i}}

    -

    {{_i}}Responsive utilities test case{{/i}}

    -

    {{_i}}Resize your browser or load on different devices to test the above classes.{{/i}}

    -

    {{_i}}Visible on...{{/i}}

    -

    {{_i}}Green checkmarks indicate that class is visible in your current viewport.{{/i}}

    -
      -
    • {{_i}}Phone{{/i}}✔ {{_i}}Phone{{/i}}
    • -
    • {{_i}}Tablet{{/i}}✔ {{_i}}Tablet{{/i}}
    • -
    • {{_i}}Desktop{{/i}}✔ {{_i}}Desktop{{/i}}
    • -
    -

    {{_i}}Hidden on...{{/i}}

    -

    {{_i}}Here, green checkmarks indicate that class is hidden in your current viewport.{{/i}}

    -
      -
    • {{_i}}Phone{{/i}}✔ {{_i}}Phone{{/i}}
    • -
    • {{_i}}Tablet{{/i}}✔ {{_i}}Tablet{{/i}}
    • -
    • {{_i}}Desktop{{/i}}✔ {{_i}}Desktop{{/i}}
    • -
    +

    {{_i}}Responsive utilities test case{{/i}}

    +

    {{_i}}Resize your browser or load on different devices to test the above classes.{{/i}}

    +

    {{_i}}Visible on...{{/i}}

    +

    {{_i}}Green checkmarks indicate that class is visible in your current viewport.{{/i}}

    +
      +
    • {{_i}}Phone{{/i}}✔ {{_i}}Phone{{/i}}
    • +
    • {{_i}}Tablet{{/i}}✔ {{_i}}Tablet{{/i}}
    • +
    • {{_i}}Desktop{{/i}}✔ {{_i}}Desktop{{/i}}
    • +
    +

    {{_i}}Hidden on...{{/i}}

    +

    {{_i}}Here, green checkmarks indicate that class is hidden in your current viewport.{{/i}}

    +
      +
    • {{_i}}Phone{{/i}}✔ {{_i}}Phone{{/i}}
    • +
    • {{_i}}Tablet{{/i}}✔ {{_i}}Tablet{{/i}}
    • +
    • {{_i}}Desktop{{/i}}✔ {{_i}}Desktop{{/i}}
    • +
    -
    +
    -
    {{! /span9 }} -
    {{! row}} +
    {{! /span9 }} +
    {{! row}} + +
    {{! /container }} diff --git a/docs/upgrading.html b/docs/upgrading.html index 5d6985725b..d2b4b21c11 100644 --- a/docs/upgrading.html +++ b/docs/upgrading.html @@ -66,8 +66,6 @@ -
    -
    @@ -263,8 +261,6 @@ -
    -