Checkbox with error
<span class=nt></label></span>
<span class=nt></div></span>
-<span class=nt></div></span></code></pre></figure> <h3>With optional icons</h3> <p>You can also add optional feedback icons with the addition of <code>.has-feedback</code> and the right icon.</p> <p><strong class=text-danger>Feedback icons only work with textual <code><input class="form-control"></code> elements.</strong></p> <div class="bs-callout bs-callout-warning" id=callout-has-feedback-icon-positioning> <h4>Icons, labels, and input groups</h4> <p>Manual positioning of feedback icons is required for inputs without a label and for <a href=../components#input-groups>input groups</a> with an add-on on the right. You are strongly encouraged to provide labels for all inputs for accessibility reasons. If you wish to prevent labels from being displayed, hide them with the <code>.sr-only</code> class. If you must do without labels, adjust the <code>top</code> value of the feedback icon. For input groups, adjust the <code>right</code> value to an appropriate pixel value depending on the width of your addon.</p> </div> <div class="bs-callout bs-callout-warning" id=callout-has-feedback-icon-accessibility> <h4>Conveying the icon's meaning to assistive technologies</h4> <p>To ensure that assistive technologies – such as screen readers – correctly convey the meaning of an icon, additional hidden text should be included with the <code>.sr-only</code> class and explicitly associated with the form control it relates to using <code>aria-describedby</code>. Alternatively, ensure that the meaning (for instance, the fact that there is a warning for a particular text entry field) is conveyed in some other form, such as changing the text of the actual <code><label></code> associated with the form control.</p> <p>Although the following examples already mention the validation state of their respective form controls in the <code><label></code> text itself, the above technique (using <code>.sr-only</code> text and <code>aria-describedby</code>) has been included for illustrative purposes.</p> </div> <div class=bs-example data-example-id=form-validation-states-with-icons> <form> <div class="form-group has-success has-feedback"> <label class=control-label for=inputSuccess2>Input with success</label> <input class=form-control id=inputSuccess2 aria-describedby=inputSuccess2Status> <span class="glyphicon glyphicon-ok form-control-feedback" aria-hidden=true></span> <span class=sr-only id=inputSuccess2Status>(success)</span> </div> <div class="form-group has-warning has-feedback"> <label class=control-label for=inputWarning2>Input with warning</label> <input class=form-control id=inputWarning2 aria-describedby=inputWarning2Status> <span class="glyphicon glyphicon-warning-sign form-control-feedback" aria-hidden=true></span> <span class=sr-only id=inputWarning2Status>(warning)</span> </div> <div class="form-group has-error has-feedback"> <label class=control-label for=inputError2>Input with error</label> <input class=form-control id=inputError2 aria-describedby=inputError2Status> <span class="glyphicon glyphicon-remove form-control-feedback" aria-hidden=true></span> <span class=sr-only id=inputError2Status>(error)</span> </div> <div class="form-group has-success has-feedback"> <label class=control-label for=inputGroupSuccess1>Input group with success</label> <div class=input-group> <span class=input-group-addon>@</span> <input class=form-control id=inputGroupSuccess1 aria-describedby=inputGroupSuccess1Status> </div> <span class="glyphicon glyphicon-ok form-control-feedback" aria-hidden=true></span> <span class=sr-only id=inputGroupSuccess1Status>(success)</span> </div> </form> </div> <figure class=highlight><pre><code class=language-html data-lang=html><span class=nt><div</span> <span class=na>class=</span><span class=s>"form-group has-success has-feedback"</span><span class=nt>></span>
+<span class=nt></div></span></code></pre></figure> <h3>With optional icons</h3> <p>You can also add optional feedback icons with the addition of <code>.has-feedback</code> and the right icon.</p> <p><strong class=text-danger>Feedback icons only work with textual <code><input class="form-control"></code> elements.</strong></p> <div class="bs-callout bs-callout-warning" id=callout-has-feedback-icon-positioning> <h4>Icons, labels, and input groups</h4> <p>Manual positioning of feedback icons is required for inputs without a label and for <a href=../components
/#input-groups>input groups</a> with an add-on on the right. You are strongly encouraged to provide labels for all inputs for accessibility reasons. If you wish to prevent labels from being displayed, hide them with the <code>.sr-only</code> class. If you must do without labels, adjust the <code>top</code> value of the feedback icon. For input groups, adjust the <code>right</code> value to an appropriate pixel value depending on the width of your addon.</p> </div> <div class="bs-callout bs-callout-warning" id=callout-has-feedback-icon-accessibility> <h4>Conveying the icon's meaning to assistive technologies</h4> <p>To ensure that assistive technologies – such as screen readers – correctly convey the meaning of an icon, additional hidden text should be included with the <code>.sr-only</code> class and explicitly associated with the form control it relates to using <code>aria-describedby</code>. Alternatively, ensure that the meaning (for instance, the fact that there is a warning for a particular text entry field) is conveyed in some other form, such as changing the text of the actual <code><label></code> associated with the form control.</p> <p>Although the following examples already mention the validation state of their respective form controls in the <code><label></code> text itself, the above technique (using <code>.sr-only</code> text and <code>aria-describedby</code>) has been included for illustrative purposes.</p> </div> <div class=bs-example data-example-id=form-validation-states-with-icons> <form> <div class="form-group has-success has-feedback"> <label class=control-label for=inputSuccess2>Input with success</label> <input class=form-control id=inputSuccess2 aria-describedby=inputSuccess2Status> <span class="glyphicon glyphicon-ok form-control-feedback" aria-hidden=true></span> <span class=sr-only id=inputSuccess2Status>(success)</span> </div> <div class="form-group has-warning has-feedback"> <label class=control-label for=inputWarning2>Input with warning</label> <input class=form-control id=inputWarning2 aria-describedby=inputWarning2Status> <span class="glyphicon glyphicon-warning-sign form-control-feedback" aria-hidden=true></span> <span class=sr-only id=inputWarning2Status>(warning)</span> </div> <div class="form-group has-error has-feedback"> <label class=control-label for=inputError2>Input with error</label> <input class=form-control id=inputError2 aria-describedby=inputError2Status> <span class="glyphicon glyphicon-remove form-control-feedback" aria-hidden=true></span> <span class=sr-only id=inputError2Status>(error)</span> </div> <div class="form-group has-success has-feedback"> <label class=control-label for=inputGroupSuccess1>Input group with success</label> <div class=input-group> <span class=input-group-addon>@</span> <input class=form-control id=inputGroupSuccess1 aria-describedby=inputGroupSuccess1Status> </div> <span class="glyphicon glyphicon-ok form-control-feedback" aria-hidden=true></span> <span class=sr-only id=inputGroupSuccess1Status>(success)</span> </div> </form> </div> <figure class=highlight><pre><code class=language-html data-lang=html><span class=nt><div</span> <span class=na>class=</span><span class=s>"form-group has-success has-feedback"</span><span class=nt>></span>
<span class=nt><label</span> <span class=na>class=</span><span class=s>"control-label"</span> <span class=na>for=</span><span class=s>"inputSuccess2"</span><span class=nt>></span>Input with success<span class=nt></label></span>
<span class=nt><input</span> <span class=na>type=</span><span class=s>"text"</span> <span class=na>class=</span><span class=s>"form-control"</span> <span class=na>id=</span><span class=s>"inputSuccess2"</span> <span class=na>aria-describedby=</span><span class=s>"inputSuccess2Status"</span><span class=nt>></span>
<span class=nt><span</span> <span class=na>class=</span><span class=s>"glyphicon glyphicon-ok form-control-feedback"</span> <span class=na>aria-hidden=</span><span class=s>"true"</span><span class=nt>></span></span>
<span class=c><!-- Include all compiled plugins (below), or include individual files as needed --></span>
<span class=nt><script </span><span class=na>src=</span><span class=s>"js/bootstrap.min.js"</span><span class=nt>></script></span>
<span class=nt></body></span>
-<span class=nt></html></span></code></pre></figure> </div> <div class=bs-docs-section> <h1 class=page-header id=examples>Examples</h1> <p class=lead>Build on the basic template above with Bootstrap's many components. We encourage you to customize and adapt Bootstrap to suit your individual project's needs.</p> <p>Get the source code for every example below by <a href=https://github.com/twbs/bootstrap/archive/v3.3.7.zip>downloading the Bootstrap repository</a>. Examples can be found in the <code>docs/examples/</code> directory.</p> <h2 id=examples-framework>Using the framework</h2> <div class="row bs-examples"> <div class="col-xs-6 col-md-4"> <a href=../examples/starter-template/ class=thumbnail> <img alt="Starter template example" src=../examples/screenshots/starter-template.jpg> </a> <h3>Starter template</h3> <p>Nothing but the basics: compiled CSS and JavaScript along with a container.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/theme/ class=thumbnail> <img alt="Bootstrap theme example" src=../examples/screenshots/theme.jpg> </a> <h3>Bootstrap theme</h3> <p>Load the optional Bootstrap theme for a visually enhanced experience.</p> </div> <div class="clearfix visible-xs"></div> <div class="col-xs-6 col-md-4"> <a href=../examples/grid/ class=thumbnail> <img alt="Multiple grids example" src=../examples/screenshots/grid.jpg> </a> <h3>Grids</h3> <p>Multiple examples of grid layouts with all four tiers, nesting, and more.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/jumbotron/ class=thumbnail> <img alt="Jumbotron example" src=../examples/screenshots/jumbotron.jpg> </a> <h3>Jumbotron</h3> <p>Build around the jumbotron with a navbar and some basic grid columns.</p> </div> <div class="clearfix visible-xs"></div> <div class="col-xs-6 col-md-4"> <a href=../examples/jumbotron-narrow/ class=thumbnail> <img alt="Narrow jumbotron example" src=../examples/screenshots/jumbotron-narrow.jpg> </a> <h3>Narrow jumbotron</h3> <p>Build a more custom page by narrowing the default container and jumbotron.</p> </div> </div> <h2 id=examples-navbars>Navbars in action</h2> <div class="row bs-examples"> <div class="col-xs-6 col-md-4"> <a href=../examples/navbar/ class=thumbnail> <img alt="Navbar example" src=../examples/screenshots/navbar.jpg> </a> <h3>Navbar</h3> <p>Super basic template that includes the navbar along with some additional content.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/navbar-static-top/ class=thumbnail> <img alt="Static top navbar example" src=../examples/screenshots/navbar-static.jpg> </a> <h3>Static top navbar</h3> <p>Super basic template with a static top navbar along with some additional content.</p> </div> <div class="clearfix visible-xs"></div> <div class="col-xs-6 col-md-4"> <a href=../examples/navbar-fixed-top/ class=thumbnail> <img alt="Fixed navbar example" src=../examples/screenshots/navbar-fixed.jpg> </a> <h3>Fixed navbar</h3> <p>Super basic template with a fixed top navbar along with some additional content.</p> </div> </div> <h2 id=examples-custom>Custom components</h2> <div class="row bs-examples"> <div class="col-xs-6 col-md-4"> <a href=../examples/cover/ class=thumbnail> <img alt="A one-page template example" src=../examples/screenshots/cover.jpg> </a> <h3>Cover</h3> <p>A one-page template for building simple and beautiful home pages.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/carousel/ class=thumbnail> <img alt="Carousel example" src=../examples/screenshots/carousel.jpg> </a> <h3>Carousel</h3> <p>Customize the navbar and carousel, then add some new components.</p> </div> <div class="clearfix visible-xs"></div> <div class="col-xs-6 col-md-4"> <a href=../examples/blog/ class=thumbnail> <img alt="Blog layout example" src=../examples/screenshots/blog.jpg> </a> <h3>Blog</h3> <p>Simple two-column blog layout with custom navigation, header, and type.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/dashboard/ class=thumbnail> <img alt="Dashboard example" src=../examples/screenshots/dashboard.jpg> </a> <h3>Dashboard</h3> <p>Basic structure for an admin dashboard with fixed sidebar and navbar.</p> </div> <div class="clearfix visible-xs"></div> <div class="col-xs-6 col-md-4"> <a href=../examples/signin/ class=thumbnail> <img alt="Sign-in page example" src=../examples/screenshots/sign-in.jpg> </a> <h3>Sign-in page</h3> <p>Custom form layout and design for a simple sign in form.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/justified-nav/ class=thumbnail> <img alt="Justified nav example" src=../examples/screenshots/justified-nav.jpg> </a> <h3>Justified nav</h3> <p>Create a custom navbar with justified links. Heads up! <a href=../components/#nav-justified>Not too Safari friendly.</a></p> </div> <div class="clearfix visible-xs"></div> <div class="col-xs-6 col-md-4"> <a href=../examples/sticky-footer/ class=thumbnail> <img alt="Sticky footer example" src=../examples/screenshots/sticky-footer.jpg> </a> <h3>Sticky footer</h3> <p>Attach a footer to the bottom of the viewport when the content is shorter than it.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/sticky-footer-navbar/ class=thumbnail> <img alt="Sticky footer with navbar example" src=../examples/screenshots/sticky-footer-navbar.jpg> </a> <h3>Sticky footer with navbar</h3> <p>Attach a footer to the bottom of the viewport with a fixed navbar at the top.</p> </div> </div> <h2 id=examples-experiments>Experiments</h2> <div class="row bs-examples"> <div class="col-xs-6 col-md-4"> <a href=../examples/non-responsive/ class=thumbnail> <img alt="Non-responsive example" src=../examples/screenshots/non-responsive.jpg> </a> <h3>Non-responsive Bootstrap</h3> <p>Easily disable the responsiveness of Bootstrap <a href=#disable-responsive>per our docs</a>.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/offcanvas/ class=thumbnail> <img alt="Off-canvas navigation example" src=../examples/screenshots/offcanvas.jpg> </a> <h3>Off-canvas</h3> <p>Build a toggleable off-canvas navigation menu for use with Bootstrap.</p> </div> </div> </div> <div class=bs-docs-section> <h1 class=page-header id=tools>Tools</h1> <h2 id=tools-bootlint>Bootlint</h2> <p><strong><a href=https://github.com/twbs/bootlint>Bootlint</a></strong> is the official Bootstrap HTML <a href=https://en.wikipedia.org/wiki/Lint_(software)>linter</a> tool. It automatically checks for several common HTML mistakes in webpages that are using Bootstrap in a fairly "vanilla" way. Vanilla Bootstrap's components/widgets require their parts of the DOM to conform to certain structures. Bootlint checks that instances of Bootstrap components have correctly-structured HTML. Consider adding Bootlint to your Bootstrap web development toolchain so that none of the common mistakes slow down your project's development.</p> </div> <div class=bs-docs-section> <h1 class=page-header id=community>Community</h1> <p class=lead>Stay up to date on the development of Bootstrap and reach out to the community with these helpful resources.</p> <ul> <li>Read and subscribe to <a href=https://blog.getbootstrap.com/ >The Official Bootstrap Blog</a>.</li> <li>Chat with fellow Bootstrappers using IRC in the <code>irc.freenode.net</code> server, in the <a href=irc://irc.freenode.net/%23bootstrap>##bootstrap channel</a>.</li> <li>For help using Bootstrap, ask on <a href=https://stackoverflow.com/questions/tagged/twitter-bootstrap-3>StackOverflow using the tag <code>twitter-bootstrap-3</code></a>.</li> <li>Developers should use the keyword <code>bootstrap</code> on packages which modify or add to the functionality of Bootstrap when distributing through <a href=
https://www.npmjs.com/search?q=keywords:bootstrap>npm</a> or similar delivery mechanisms for maximum discoverability.</li> <li>Find inspiring examples of people building with Bootstrap at the <a href=https://expo.getbootstrap.com/>Bootstrap Expo</a>.</li> </ul> <p>You can also follow <a href=https://twitter.com/getbootstrap>@getbootstrap on Twitter</a> for the latest gossip and awesome music videos.</p> </div> <div class=bs-docs-section> <h1 class=page-header id=disable-responsive>Disabling responsiveness</h1> <p class=lead>Bootstrap automatically adapts your pages for various screen sizes. Here's how to disable this feature so your page works like <a href=../examples/non-responsive/ >this non-responsive example</a>.</p> <h2>Steps to disable page responsiveness</h2> <ol> <li>Omit the viewport <code><meta></code> mentioned in <a href=../css/#overview-mobile>the CSS docs</a></li> <li>Override the <code>width</code> on the <code>.container</code> for each grid tier with a single width, for example <code>width: 970px !important;</code> Be sure that this comes after the default Bootstrap CSS. You can optionally avoid the <code>!important</code> with media queries or some selector-fu.</li> <li>If using navbars, remove all navbar collapsing and expanding behavior.</li> <li>For grid layouts, use <code>.col-xs-*</code> classes in addition to, or in place of, the medium/large ones. Don't worry, the extra-small device grid scales to all resolutions.</li> </ol> <p>You'll still need Respond.js for IE8 (since our media queries are still there and need to be processed). This disables the "mobile site" aspects of Bootstrap.</p> <h2>Bootstrap template with responsiveness disabled</h2> <p>We've applied these steps to an example. Read its source code to see the specific changes implemented.</p> <p> <a href=../examples/non-responsive/ class="btn btn-primary">View non-responsive example</a> </p> </div> <div class="bs-callout bs-callout-info" id=migration> <h4>Migrating from v2.x to v3.x</h4> <p>Looking to migrate from an older version of Bootstrap to v3.x? Check out <a href=../migration/ >our migration guide</a>.</p> </div> <div class=bs-docs-section> <h1 class=page-header id=support>Browser and device support</h1> <p class=lead>Bootstrap is built to work best in the latest desktop and mobile browsers, meaning older browsers might display differently styled, though fully functional, renderings of certain components.</p> <h2 id=support-browsers>Supported browsers</h2> <p>Specifically, we support the <strong>latest versions</strong> of the following browsers and platforms.</p> <p>Alternative browsers which use the latest version of WebKit, Blink, or Gecko, whether directly or via the platform's web view API, are not explicitly supported. However, Bootstrap should (in most cases) display and function correctly in these browsers as well. More specific support information is provided below.</p> <h3 id=mobile-devices>Mobile devices</h3> <p>Generally speaking, Bootstrap supports the latest versions of each major platform's default browsers. Note that proxy browsers (such as Opera Mini, Opera Mobile's Turbo mode, UC Browser Mini, Amazon Silk) are not supported.</p> <div class=table-responsive> <table class="table table-bordered table-striped"> <thead> <tr> <td></td> <th>Chrome</th> <th>Firefox</th> <th>Safari</th> </tr> </thead> <tbody> <tr> <th scope=row>Android</th> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-muted>N/A</td> </tr> <tr> <th scope=row>iOS</th> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> </tr> </tbody> </table> </div> <h3 id=desktop-browsers>Desktop browsers</h3> <p>Similarly, the latest versions of most desktop browsers are supported.</p> <div class=table-responsive> <table class="table table-bordered table-striped"> <thead> <tr> <td></td> <th>Chrome</th> <th>Firefox</th> <th>Internet Explorer</th> <th>Opera</th> <th>Safari</th> </tr> </thead> <tbody> <tr> <th scope=row>Mac</th> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-muted>N/A</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> </tr> <tr> <th scope=row>Windows</th> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-danger><span class="glyphicon glyphicon-remove" aria-hidden=true></span> Not supported</td> </tr> </tbody> </table> </div> <p>On Windows, <strong>we support Internet Explorer 8-11</strong>.</p> <p>For Firefox, in addition to the latest normal stable release, we also support the latest <a href=https://www.mozilla.org/en-US/firefox/organizations/faq/ >Extended Support Release (ESR)</a> version of Firefox.</p> <p>Unofficially, Bootstrap should look and behave well enough in Chromium and Chrome for Linux, Firefox for Linux, and Internet Explorer 7, as well as Microsoft Edge, though they are not officially supported.</p> <p>For a list of some of the browser bugs that Bootstrap has to grapple with, see our <a href=../browser-bugs/ >Wall of browser bugs</a>.</p> <h2 id=support-ie8-ie9>Internet Explorer 8 and 9</h2> <p>Internet Explorer 8 and 9 are also supported, however, please be aware that some CSS3 properties and HTML5 elements are not fully supported by these browsers. In addition, <strong>Internet Explorer 8 requires the use of <a href=https://github.com/scottjehl/Respond>Respond.js</a> to enable media query support.</strong></p> <div class=table-responsive> <table class="table table-bordered table-striped"> <thead> <tr> <th class=col-xs-4>Feature</th> <th class=col-xs-4>Internet Explorer 8</th> <th class=col-xs-4>Internet Explorer 9</th> </tr> </thead> <tbody> <tr> <th scope=row><code>border-radius</code></th> <td class=text-danger><span class="glyphicon glyphicon-remove" aria-hidden=true></span> Not supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> </tr> <tr> <th scope=row><code>box-shadow</code></th> <td class=text-danger><span class="glyphicon glyphicon-remove" aria-hidden=true></span> Not supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> </tr> <tr> <th scope=row><code>transform</code></th> <td class=text-danger><span class="glyphicon glyphicon-remove" aria-hidden=true></span> Not supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported, with <code>-ms</code> prefix</td> </tr> <tr> <th scope=row><code>transition</code></th> <td colspan=2 class=text-danger><span class="glyphicon glyphicon-remove" aria-hidden=true></span> Not supported</td> </tr> <tr> <th scope=row><code>placeholder</code></th> <td colspan=2 class=text-danger><span class="glyphicon glyphicon-remove" aria-hidden=true></span> Not supported</td> </tr> </tbody> </table> </div> <p>Visit <a href=https://caniuse.com/ >Can I use...</a> for details on browser support of CSS3 and HTML5 features.</p> <h2 id=support-ie8-respondjs>Internet Explorer 8 and Respond.js</h2> <p>Beware of the following caveats when using Respond.js in your development and production environments for Internet Explorer 8.</p> <h3 id=respond-js-x-domain>Respond.js and cross-domain CSS</h3> <p>Using Respond.js with CSS hosted on a different (sub)domain (for example, on a CDN) requires some additional setup. <a href=https://github.com/scottjehl/Respond/blob/master/README.md#cdnx-domain-setup>See the Respond.js docs</a> for details.</p> <h3 id=respond-file-proto>Respond.js and <code>file://</code></h3> <p>Due to browser security rules, Respond.js doesn't work with pages viewed via the <code>file://</code> protocol (like when opening a local HTML file). To test responsive features in IE8, view your pages over HTTP(S). <a href=https://github.com/scottjehl/Respond/blob/master/README.md#support--caveats>See the Respond.js docs</a> for details.</p> <h3 id=respond-import>Respond.js and <code>@import</code></h3> <p>Respond.js doesn't work with CSS that's referenced via <code>@import</code>. In particular, some Drupal configurations are known to use <code>@import</code>. <a href=https://github.com/scottjehl/Respond/blob/master/README.md#support--caveats>See the Respond.js docs</a> for details.</p> <h2 id=support-ie8-box-sizing>Internet Explorer 8 and box-sizing</h2> <p>IE8 does not fully support <code>box-sizing: border-box;</code> when combined with <code>min-width</code>, <code>max-width</code>, <code>min-height</code>, or <code>max-height</code>. For that reason, as of v3.0.1, we no longer use <code>max-width</code> on <code>.container</code>s.</p> <h2 id=support-ie8-font-face>Internet Explorer 8 and @font-face</h2> <p>IE8 has some issues with <code>@font-face</code> when combined with <code>:before</code>. Bootstrap uses that combination with its Glyphicons. If a page is cached, and loaded without the mouse over the window (i.e. hit the refresh button or load something in an iframe) then the page gets rendered before the font loads. Hovering over the page (body) will show some of the icons and hovering over the remaining icons will show those as well. <a href=https://github.com/twbs/bootstrap/issues/13863>See issue #13863</a> for details.</p> <h2 id=support-ie-compatibility-modes>IE Compatibility modes</h2> <p>Bootstrap is not supported in the old Internet Explorer compatibility modes. To be sure you're using the latest rendering mode for IE, consider including the appropriate <code><meta></code> tag in your pages:</p> <figure class=highlight><pre><code class=language-html data-lang=html><span class=nt><meta</span> <span class=na>http-equiv=</span><span class=s>"X-UA-Compatible"</span> <span class=na>content=</span><span class=s>"IE=edge"</span><span class=nt>></span></code></pre></figure> <p>Confirm the document mode by opening the debugging tools: press <kbd>F12</kbd> and check the "Document Mode".</p> <p>This tag is included in all of Bootstrap's documentation and examples to ensure the best rendering possible in each supported version of Internet Explorer.</p> <p>See <a href=https://stackoverflow.com/questions/6771258/whats-the-difference-if-meta-http-equiv-x-ua-compatible-content-ie-edge>this StackOverflow question</a> for more information.</p> <h2 id=support-ie10-width>Internet Explorer 10 in Windows 8 and Windows Phone 8</h2> <p>Internet Explorer 10 doesn't differentiate <strong>device width</strong> from <strong>viewport width</strong>, and thus doesn't properly apply the media queries in Bootstrap's CSS. Normally you'd just add a quick snippet of CSS to fix this:</p> <figure class=highlight><pre><code class=language-scss data-lang=scss><span class=k>@-ms-viewport</span> <span class=p>{</span> <span class=nl>width</span><span class=p>:</span> <span class=n>device-width</span><span class=p>;</span> <span class=p>}</span></code></pre></figure> <p>However, this doesn't work for devices running Windows Phone 8 versions older than <a href=https://blogs.windows.com/buildingapps/2013/10/14/introducing-windows-phone-preview-for-developers/>Update 3 (a.k.a. GDR3)</a>, as it causes such devices to show a mostly desktop view instead of narrow "phone" view. To address this, you'll need to <strong>include the following CSS and JavaScript to work around the bug</strong>.</p> <figure class=highlight><pre><code class=language-scss data-lang=scss><span class=k>@-ms-viewport</span> <span class=p>{</span> <span class=nl>width</span><span class=p>:</span> <span class=n>device-width</span><span class=p>;</span> <span class=p>}</span>
+<span class=nt></html></span></code></pre></figure> </div> <div class=bs-docs-section> <h1 class=page-header id=examples>Examples</h1> <p class=lead>Build on the basic template above with Bootstrap's many components. We encourage you to customize and adapt Bootstrap to suit your individual project's needs.</p> <p>Get the source code for every example below by <a href=https://github.com/twbs/bootstrap/archive/v3.3.7.zip>downloading the Bootstrap repository</a>. Examples can be found in the <code>docs/examples/</code> directory.</p> <h2 id=examples-framework>Using the framework</h2> <div class="row bs-examples"> <div class="col-xs-6 col-md-4"> <a href=../examples/starter-template/ class=thumbnail> <img alt="Starter template example" src=../examples/screenshots/starter-template.jpg> </a> <h3>Starter template</h3> <p>Nothing but the basics: compiled CSS and JavaScript along with a container.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/theme/ class=thumbnail> <img alt="Bootstrap theme example" src=../examples/screenshots/theme.jpg> </a> <h3>Bootstrap theme</h3> <p>Load the optional Bootstrap theme for a visually enhanced experience.</p> </div> <div class="clearfix visible-xs"></div> <div class="col-xs-6 col-md-4"> <a href=../examples/grid/ class=thumbnail> <img alt="Multiple grids example" src=../examples/screenshots/grid.jpg> </a> <h3>Grids</h3> <p>Multiple examples of grid layouts with all four tiers, nesting, and more.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/jumbotron/ class=thumbnail> <img alt="Jumbotron example" src=../examples/screenshots/jumbotron.jpg> </a> <h3>Jumbotron</h3> <p>Build around the jumbotron with a navbar and some basic grid columns.</p> </div> <div class="clearfix visible-xs"></div> <div class="col-xs-6 col-md-4"> <a href=../examples/jumbotron-narrow/ class=thumbnail> <img alt="Narrow jumbotron example" src=../examples/screenshots/jumbotron-narrow.jpg> </a> <h3>Narrow jumbotron</h3> <p>Build a more custom page by narrowing the default container and jumbotron.</p> </div> </div> <h2 id=examples-navbars>Navbars in action</h2> <div class="row bs-examples"> <div class="col-xs-6 col-md-4"> <a href=../examples/navbar/ class=thumbnail> <img alt="Navbar example" src=../examples/screenshots/navbar.jpg> </a> <h3>Navbar</h3> <p>Super basic template that includes the navbar along with some additional content.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/navbar-static-top/ class=thumbnail> <img alt="Static top navbar example" src=../examples/screenshots/navbar-static.jpg> </a> <h3>Static top navbar</h3> <p>Super basic template with a static top navbar along with some additional content.</p> </div> <div class="clearfix visible-xs"></div> <div class="col-xs-6 col-md-4"> <a href=../examples/navbar-fixed-top/ class=thumbnail> <img alt="Fixed navbar example" src=../examples/screenshots/navbar-fixed.jpg> </a> <h3>Fixed navbar</h3> <p>Super basic template with a fixed top navbar along with some additional content.</p> </div> </div> <h2 id=examples-custom>Custom components</h2> <div class="row bs-examples"> <div class="col-xs-6 col-md-4"> <a href=../examples/cover/ class=thumbnail> <img alt="A one-page template example" src=../examples/screenshots/cover.jpg> </a> <h3>Cover</h3> <p>A one-page template for building simple and beautiful home pages.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/carousel/ class=thumbnail> <img alt="Carousel example" src=../examples/screenshots/carousel.jpg> </a> <h3>Carousel</h3> <p>Customize the navbar and carousel, then add some new components.</p> </div> <div class="clearfix visible-xs"></div> <div class="col-xs-6 col-md-4"> <a href=../examples/blog/ class=thumbnail> <img alt="Blog layout example" src=../examples/screenshots/blog.jpg> </a> <h3>Blog</h3> <p>Simple two-column blog layout with custom navigation, header, and type.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/dashboard/ class=thumbnail> <img alt="Dashboard example" src=../examples/screenshots/dashboard.jpg> </a> <h3>Dashboard</h3> <p>Basic structure for an admin dashboard with fixed sidebar and navbar.</p> </div> <div class="clearfix visible-xs"></div> <div class="col-xs-6 col-md-4"> <a href=../examples/signin/ class=thumbnail> <img alt="Sign-in page example" src=../examples/screenshots/sign-in.jpg> </a> <h3>Sign-in page</h3> <p>Custom form layout and design for a simple sign in form.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/justified-nav/ class=thumbnail> <img alt="Justified nav example" src=../examples/screenshots/justified-nav.jpg> </a> <h3>Justified nav</h3> <p>Create a custom navbar with justified links. Heads up! <a href=../components/#nav-justified>Not too Safari friendly.</a></p> </div> <div class="clearfix visible-xs"></div> <div class="col-xs-6 col-md-4"> <a href=../examples/sticky-footer/ class=thumbnail> <img alt="Sticky footer example" src=../examples/screenshots/sticky-footer.jpg> </a> <h3>Sticky footer</h3> <p>Attach a footer to the bottom of the viewport when the content is shorter than it.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/sticky-footer-navbar/ class=thumbnail> <img alt="Sticky footer with navbar example" src=../examples/screenshots/sticky-footer-navbar.jpg> </a> <h3>Sticky footer with navbar</h3> <p>Attach a footer to the bottom of the viewport with a fixed navbar at the top.</p> </div> </div> <h2 id=examples-experiments>Experiments</h2> <div class="row bs-examples"> <div class="col-xs-6 col-md-4"> <a href=../examples/non-responsive/ class=thumbnail> <img alt="Non-responsive example" src=../examples/screenshots/non-responsive.jpg> </a> <h3>Non-responsive Bootstrap</h3> <p>Easily disable the responsiveness of Bootstrap <a href=#disable-responsive>per our docs</a>.</p> </div> <div class="col-xs-6 col-md-4"> <a href=../examples/offcanvas/ class=thumbnail> <img alt="Off-canvas navigation example" src=../examples/screenshots/offcanvas.jpg> </a> <h3>Off-canvas</h3> <p>Build a toggleable off-canvas navigation menu for use with Bootstrap.</p> </div> </div> </div> <div class=bs-docs-section> <h1 class=page-header id=tools>Tools</h1> <h2 id=tools-bootlint>Bootlint</h2> <p><strong><a href=https://github.com/twbs/bootlint>Bootlint</a></strong> is the official Bootstrap HTML <a href=https://en.wikipedia.org/wiki/Lint_(software)>linter</a> tool. It automatically checks for several common HTML mistakes in webpages that are using Bootstrap in a fairly "vanilla" way. Vanilla Bootstrap's components/widgets require their parts of the DOM to conform to certain structures. Bootlint checks that instances of Bootstrap components have correctly-structured HTML. Consider adding Bootlint to your Bootstrap web development toolchain so that none of the common mistakes slow down your project's development.</p> </div> <div class=bs-docs-section> <h1 class=page-header id=community>Community</h1> <p class=lead>Stay up to date on the development of Bootstrap and reach out to the community with these helpful resources.</p> <ul> <li>Read and subscribe to <a href=https://blog.getbootstrap.com/ >The Official Bootstrap Blog</a>.</li> <li>Chat with fellow Bootstrappers using IRC in the <code>irc.freenode.net</code> server, in the <a href=irc://irc.freenode.net/%23bootstrap>##bootstrap channel</a>.</li> <li>For help using Bootstrap, ask on <a href=https://stackoverflow.com/questions/tagged/twitter-bootstrap-3>StackOverflow using the tag <code>twitter-bootstrap-3</code></a>.</li> <li>Developers should use the keyword <code>bootstrap</code> on packages which modify or add to the functionality of Bootstrap when distributing through <a href=
"https://www.npmjs.com/search?q=keywords:bootstrap">npm</a> or similar delivery mechanisms for maximum discoverability.</li> <li>Find inspiring examples of people building with Bootstrap at the <a href=https://expo.getbootstrap.com/>Bootstrap Expo</a>.</li> </ul> <p>You can also follow <a href=https://twitter.com/getbootstrap>@getbootstrap on Twitter</a> for the latest gossip and awesome music videos.</p> </div> <div class=bs-docs-section> <h1 class=page-header id=disable-responsive>Disabling responsiveness</h1> <p class=lead>Bootstrap automatically adapts your pages for various screen sizes. Here's how to disable this feature so your page works like <a href=../examples/non-responsive/ >this non-responsive example</a>.</p> <h2>Steps to disable page responsiveness</h2> <ol> <li>Omit the viewport <code><meta></code> mentioned in <a href=../css/#overview-mobile>the CSS docs</a></li> <li>Override the <code>width</code> on the <code>.container</code> for each grid tier with a single width, for example <code>width: 970px !important;</code> Be sure that this comes after the default Bootstrap CSS. You can optionally avoid the <code>!important</code> with media queries or some selector-fu.</li> <li>If using navbars, remove all navbar collapsing and expanding behavior.</li> <li>For grid layouts, use <code>.col-xs-*</code> classes in addition to, or in place of, the medium/large ones. Don't worry, the extra-small device grid scales to all resolutions.</li> </ol> <p>You'll still need Respond.js for IE8 (since our media queries are still there and need to be processed). This disables the "mobile site" aspects of Bootstrap.</p> <h2>Bootstrap template with responsiveness disabled</h2> <p>We've applied these steps to an example. Read its source code to see the specific changes implemented.</p> <p> <a href=../examples/non-responsive/ class="btn btn-primary">View non-responsive example</a> </p> </div> <div class="bs-callout bs-callout-info" id=migration> <h4>Migrating from v2.x to v3.x</h4> <p>Looking to migrate from an older version of Bootstrap to v3.x? Check out <a href=../migration/ >our migration guide</a>.</p> </div> <div class=bs-docs-section> <h1 class=page-header id=support>Browser and device support</h1> <p class=lead>Bootstrap is built to work best in the latest desktop and mobile browsers, meaning older browsers might display differently styled, though fully functional, renderings of certain components.</p> <h2 id=support-browsers>Supported browsers</h2> <p>Specifically, we support the <strong>latest versions</strong> of the following browsers and platforms.</p> <p>Alternative browsers which use the latest version of WebKit, Blink, or Gecko, whether directly or via the platform's web view API, are not explicitly supported. However, Bootstrap should (in most cases) display and function correctly in these browsers as well. More specific support information is provided below.</p> <h3 id=mobile-devices>Mobile devices</h3> <p>Generally speaking, Bootstrap supports the latest versions of each major platform's default browsers. Note that proxy browsers (such as Opera Mini, Opera Mobile's Turbo mode, UC Browser Mini, Amazon Silk) are not supported.</p> <div class=table-responsive> <table class="table table-bordered table-striped"> <thead> <tr> <td></td> <th>Chrome</th> <th>Firefox</th> <th>Safari</th> </tr> </thead> <tbody> <tr> <th scope=row>Android</th> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-muted>N/A</td> </tr> <tr> <th scope=row>iOS</th> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> </tr> </tbody> </table> </div> <h3 id=desktop-browsers>Desktop browsers</h3> <p>Similarly, the latest versions of most desktop browsers are supported.</p> <div class=table-responsive> <table class="table table-bordered table-striped"> <thead> <tr> <td></td> <th>Chrome</th> <th>Firefox</th> <th>Internet Explorer</th> <th>Opera</th> <th>Safari</th> </tr> </thead> <tbody> <tr> <th scope=row>Mac</th> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-muted>N/A</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> </tr> <tr> <th scope=row>Windows</th> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> <td class=text-danger><span class="glyphicon glyphicon-remove" aria-hidden=true></span> Not supported</td> </tr> </tbody> </table> </div> <p>On Windows, <strong>we support Internet Explorer 8-11</strong>.</p> <p>For Firefox, in addition to the latest normal stable release, we also support the latest <a href=https://www.mozilla.org/en-US/firefox/organizations/faq/ >Extended Support Release (ESR)</a> version of Firefox.</p> <p>Unofficially, Bootstrap should look and behave well enough in Chromium and Chrome for Linux, Firefox for Linux, and Internet Explorer 7, as well as Microsoft Edge, though they are not officially supported.</p> <p>For a list of some of the browser bugs that Bootstrap has to grapple with, see our <a href=../browser-bugs/ >Wall of browser bugs</a>.</p> <h2 id=support-ie8-ie9>Internet Explorer 8 and 9</h2> <p>Internet Explorer 8 and 9 are also supported, however, please be aware that some CSS3 properties and HTML5 elements are not fully supported by these browsers. In addition, <strong>Internet Explorer 8 requires the use of <a href=https://github.com/scottjehl/Respond>Respond.js</a> to enable media query support.</strong></p> <div class=table-responsive> <table class="table table-bordered table-striped"> <thead> <tr> <th class=col-xs-4>Feature</th> <th class=col-xs-4>Internet Explorer 8</th> <th class=col-xs-4>Internet Explorer 9</th> </tr> </thead> <tbody> <tr> <th scope=row><code>border-radius</code></th> <td class=text-danger><span class="glyphicon glyphicon-remove" aria-hidden=true></span> Not supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> </tr> <tr> <th scope=row><code>box-shadow</code></th> <td class=text-danger><span class="glyphicon glyphicon-remove" aria-hidden=true></span> Not supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported</td> </tr> <tr> <th scope=row><code>transform</code></th> <td class=text-danger><span class="glyphicon glyphicon-remove" aria-hidden=true></span> Not supported</td> <td class=text-success><span class="glyphicon glyphicon-ok" aria-hidden=true></span> Supported, with <code>-ms</code> prefix</td> </tr> <tr> <th scope=row><code>transition</code></th> <td colspan=2 class=text-danger><span class="glyphicon glyphicon-remove" aria-hidden=true></span> Not supported</td> </tr> <tr> <th scope=row><code>placeholder</code></th> <td colspan=2 class=text-danger><span class="glyphicon glyphicon-remove" aria-hidden=true></span> Not supported</td> </tr> </tbody> </table> </div> <p>Visit <a href=https://caniuse.com/ >Can I use...</a> for details on browser support of CSS3 and HTML5 features.</p> <h2 id=support-ie8-respondjs>Internet Explorer 8 and Respond.js</h2> <p>Beware of the following caveats when using Respond.js in your development and production environments for Internet Explorer 8.</p> <h3 id=respond-js-x-domain>Respond.js and cross-domain CSS</h3> <p>Using Respond.js with CSS hosted on a different (sub)domain (for example, on a CDN) requires some additional setup. <a href=https://github.com/scottjehl/Respond/blob/master/README.md#cdnx-domain-setup>See the Respond.js docs</a> for details.</p> <h3 id=respond-file-proto>Respond.js and <code>file://</code></h3> <p>Due to browser security rules, Respond.js doesn't work with pages viewed via the <code>file://</code> protocol (like when opening a local HTML file). To test responsive features in IE8, view your pages over HTTP(S). <a href=https://github.com/scottjehl/Respond/blob/master/README.md#support--caveats>See the Respond.js docs</a> for details.</p> <h3 id=respond-import>Respond.js and <code>@import</code></h3> <p>Respond.js doesn't work with CSS that's referenced via <code>@import</code>. In particular, some Drupal configurations are known to use <code>@import</code>. <a href=https://github.com/scottjehl/Respond/blob/master/README.md#support--caveats>See the Respond.js docs</a> for details.</p> <h2 id=support-ie8-box-sizing>Internet Explorer 8 and box-sizing</h2> <p>IE8 does not fully support <code>box-sizing: border-box;</code> when combined with <code>min-width</code>, <code>max-width</code>, <code>min-height</code>, or <code>max-height</code>. For that reason, as of v3.0.1, we no longer use <code>max-width</code> on <code>.container</code>s.</p> <h2 id=support-ie8-font-face>Internet Explorer 8 and @font-face</h2> <p>IE8 has some issues with <code>@font-face</code> when combined with <code>:before</code>. Bootstrap uses that combination with its Glyphicons. If a page is cached, and loaded without the mouse over the window (i.e. hit the refresh button or load something in an iframe) then the page gets rendered before the font loads. Hovering over the page (body) will show some of the icons and hovering over the remaining icons will show those as well. <a href=https://github.com/twbs/bootstrap/issues/13863>See issue #13863</a> for details.</p> <h2 id=support-ie-compatibility-modes>IE Compatibility modes</h2> <p>Bootstrap is not supported in the old Internet Explorer compatibility modes. To be sure you're using the latest rendering mode for IE, consider including the appropriate <code><meta></code> tag in your pages:</p> <figure class=highlight><pre><code class=language-html data-lang=html><span class=nt><meta</span> <span class=na>http-equiv=</span><span class=s>"X-UA-Compatible"</span> <span class=na>content=</span><span class=s>"IE=edge"</span><span class=nt>></span></code></pre></figure> <p>Confirm the document mode by opening the debugging tools: press <kbd>F12</kbd> and check the "Document Mode".</p> <p>This tag is included in all of Bootstrap's documentation and examples to ensure the best rendering possible in each supported version of Internet Explorer.</p> <p>See <a href=https://stackoverflow.com/questions/6771258/whats-the-difference-if-meta-http-equiv-x-ua-compatible-content-ie-edge>this StackOverflow question</a> for more information.</p> <h2 id=support-ie10-width>Internet Explorer 10 in Windows 8 and Windows Phone 8</h2> <p>Internet Explorer 10 doesn't differentiate <strong>device width</strong> from <strong>viewport width</strong>, and thus doesn't properly apply the media queries in Bootstrap's CSS. Normally you'd just add a quick snippet of CSS to fix this:</p> <figure class=highlight><pre><code class=language-scss data-lang=scss><span class=k>@-ms-viewport</span> <span class=p>{</span> <span class=nl>width</span><span class=p>:</span> <span class=n>device-width</span><span class=p>;</span> <span class=p>}</span></code></pre></figure> <p>However, this doesn't work for devices running Windows Phone 8 versions older than <a href=https://blogs.windows.com/buildingapps/2013/10/14/introducing-windows-phone-preview-for-developers/>Update 3 (a.k.a. GDR3)</a>, as it causes such devices to show a mostly desktop view instead of narrow "phone" view. To address this, you'll need to <strong>include the following CSS and JavaScript to work around the bug</strong>.</p> <figure class=highlight><pre><code class=language-scss data-lang=scss><span class=k>@-ms-viewport</span> <span class=p>{</span> <span class=nl>width</span><span class=p>:</span> <span class=n>device-width</span><span class=p>;</span> <span class=p>}</span>
<span class=k>@-o-viewport</span> <span class=p>{</span> <span class=nl>width</span><span class=p>:</span> <span class=n>device-width</span><span class=p>;</span> <span class=p>}</span>
<span class=k>@viewport</span> <span class=p>{</span> <span class=nl>width</span><span class=p>:</span> <span class=n>device-width</span><span class=p>;</span> <span class=p>}</span></code></pre></figure> <figure class=highlight><pre><code class=language-js data-lang=js><span class=c1>// Copyright 2014-2015 Twitter, Inc.</span>
<span class=c1>// Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE)</span>
projects / thirdparty / bootstrap.git / commitdiff
