From 424dd8bc118b36c9173dbdc05661086c8566fd17 Mon Sep 17 00:00:00 2001 From: Thomas Park Date: Mon, 19 Aug 2013 20:05:19 -0400 Subject: update bootstrap to 3.0.0 final --- bower_components/bootstrap/getting-started.html | 415 +++++++++++++++++++++--- 1 file changed, 363 insertions(+), 52 deletions(-) (limited to 'bower_components/bootstrap/getting-started.html') diff --git a/bower_components/bootstrap/getting-started.html b/bower_components/bootstrap/getting-started.html index d1905505..cd3575ad 100755 --- a/bower_components/bootstrap/getting-started.html +++ b/bower_components/bootstrap/getting-started.html @@ -15,14 +15,9 @@ base_url: "../"

There are a few easy ways to quickly get started with Bootstrap, each one appealing to a different skill level and use case. Read through to see what suits your particular needs.

-

Download latest full source

-

Until Bootstrap 3.0.0 is finalized, download the latest full source code (includes compiled and minified versions of our CSS and JavaScript under the dist/ directory).

-

Download latest Bootstrap 3

-

Additional downloads

@@ -43,10 +38,13 @@ base_url: "../"

Bootstrap CDN

The folks over at NetDNA have graciously provided CDN support for Bootstrap's CSS and JavaScript. To use, swap your local instances for the Bootstrap CDN links listed below.

-{% highlight html linenos %} +{% highlight html %} + + + {% endhighlight %} @@ -73,12 +71,19 @@ bootstrap/ ├── css/ │ ├── bootstrap.css │ ├── bootstrap.min.css +│ ├── bootstrap-theme.css +│ ├── bootstrap-theme.min.css ├── js/ │ ├── bootstrap.js │ ├── bootstrap.min.js +└── fonts/ + ├── glyphicons-halflings-regular.eot + ├── glyphicons-halflings-regular.svg + ├── glyphicons-halflings-regular.ttf + └── glyphicons-halflings-regular.woff {% endhighlight %} -

This is the most basic form of Bootstrap: compiled files for quick drop-in usage in nearly any web project. We provide compiled CSS and JS (bootstrap.*), as well as compiled and minified CSS and JS (bootstrap.min.*).

+

This is the most basic form of Bootstrap: compiled files for quick drop-in usage in nearly any web project. We provide compiled CSS and JS (bootstrap.*), as well as compiled and minified CSS and JS (bootstrap.min.*). Fonts from Glyphicons are included, as is the optional Bootstrap theme.

jQuery required

Please note that all JavaScript plugins require jQuery to be included, as shown in the starter template.

@@ -104,6 +109,12 @@ bootstrap/ + + +

Hello, world!

@@ -112,9 +123,6 @@ bootstrap/ - - - {% endhighlight %} @@ -234,7 +242,22 @@ bootstrap/

Carousel

Customize the navbar and carousel, then add some new components.

+
+ + + +

Non-responsive Bootstrap

+

Easily disable the responsiveness of Bootstrap per our docs.

+
+
+
+ + + +

Bootstrap theme

+

Load the optional Bootstrap theme for a visually enhanced experience.

+
@@ -247,57 +270,342 @@ bootstrap/ -

Don't want your site or application to be scale on different device? With a little bit of work, you can disable the responsive features of Bootstrap so that mobile users see your full desktop-version site.

+

Don't want your site or application to be scaled on different devices? With a little bit of work, you can disable the responsive features of Bootstrap so that mobile users see your full desktop-version site. Read below or check out the non-responsive example.

Steps to disable responsive views

To disable responsive features, follow these steps. See it in action in the modified template below.

  1. Remove (or just don't add) the viewport <meta> mentioned in the CSS docs
  2. -
  3. Force a single max-width on the .container (e.g., .container { max-width: 940px; }). Be sure that this comes after the default Bootstrap CSS; otherwise, you'll need !important.
  4. +
  5. Remove the max-width on the .container for all grid tiers with max-width: none !important; and set a regular width like width: 970px;. Be sure that this comes after the default Bootstrap CSS. You can optionally avoid the !important with media queries or some selector-fu.
  6. +
  7. If using navbars, undo all the navbar collapsing and expanding behavior (this is too much to show here, so peep the example).
  8. For grid layouts, make use of .col-xs-* classes in addition to or in place of the medium/large ones. Don't worry, the extra-small device grid scales up to all resolutions, so you're set there.
-

You'll still need respond.js for IE8 (since our media queries are still there and need to be picked up). This just disables the "mobile site" of Bootstrap.

+

You'll still need Respond.js for IE8 (since our media queries are still there and need to be picked up). This just disables the "mobile site" of Bootstrap.

Bootstrap template with disabled responsive

-

We've taken the above steps and applied them to a basic template here. Note the steps above are called out in comments here, e.g. <-- 1. -->.

-{% highlight html %} - - - - Disabling responsiveness in Bootstrap - - - - - +

We've taken the above steps and applied them to an example. Read it's source code to see the specific changes called out.

+

+ View non-responsive example +

+ - - - - -

Hello, world!

- -
-
One third
-
One third
-
One third
+ +
+ - - - - - - - - - - - -{% endhighlight %} +

Folks looking to upgrade to v3 should use this section as a general upgrade guide. We've outlined some of the major changes and provided tables that highlight key changes. For an overview, read the announcement blog post.

+ + +

Major class changes

+

Reference table for classes that have changed between v2.x and v3.0.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Bootstrap 2.xBootstrap 3.0
.container-fluid.container
.row-fluid.row
.span*.col-md-*
.offset*.col-md-offset-*
.brand.navbar-brand
.nav-collapse.navbar-collapse
.nav-toggle.navbar-toggle
.btn-navbar.navbar-btn
.hero-unit.jumbotron
.icon-*.glyphicon .glyphicon-*
.btn.btn .btn-default
.btn-mini.btn-xs
.btn-small.btn-sm
.btn-large.btn-lg
.visible-phone.visible-sm
.visible-tablet.visible-md
.visible-desktop.visible-lg
.hidden-phone.hidden-sm
.hidden-tablet.hidden-md
.hidden-desktop.hidden-lg
.input-small.input-sm
.input-large.input-lg
.checkbox.inline .radio.inline.checkbox-inline .radio-inline
.input-prepend .input-append.input-group
.add-on.input-group-addon
.thumbnail.img-thumbnail
ul.unstyled.list-unstyled
ul.inline.list-inline
+
+ + +

What's new

+

We've added a few new elements and changed some existing ones. Here's their new or updated classes.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ElementDescription
Panels.panel .panel-default .panel-body .panel-title .panel-heading .panel-footer .panel-collapse
List groups.list-group .list-group-item .list-group-item-text .list-group-item-heading
Glyphicons.glyphicon
Jumbotron.jumbotron
Tiny grid (<768 px).col-xs-*
Small grid (>768 px).col-sm-*
Medium grid (>992 px).col-md-*
Large grid (>1200 px).col-lg-*
Offsets.col-sm-offset-* .col-md-offset-* .col-lg-offset-*
Push.col-sm-push-* .col-md-push-* .col-lg-push-*
Pull.col-sm-pull-* .col-md-pull-* .col-lg-pull-*
Input groups.input-group .input-group-addon .input-group-btn
Form controls.form-control .form-group
Button group sizes.btn-group-xs .btn-group-sm .btn-group-lg
Navbar text.navbar-text
Navbar header.navbar-header
Justified tabs / pills.nav-justified
Responsive images.img-responsive
Contextual table rows.success .danger .warning .active
Contextual panels.panel-success .panel-danger .panel-warning .panel-info
Modal.modal-dialog .modal-content
Thumbnail image.img-thumbnail
Well sizes.well-sm .well-lg
Alert links.alert-link
+
+ + +

What's removed

+

The following elements have been dropped or changed in v3.

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ElementRemoved from 2.x3.0 Equivalent
Form actions.form-actionsN/A
Search form.form-searchN/A
Fluid container.container-fluid.container (no more fixed grid)
Fluid row.row-fluid.row (no more fixed grid)
Navbar inner.navbar-innerN/A
Dropdown submenu.dropdown-submenuN/A
Tab alignments.tabs-left .tabs-right .tabs-belowN/A
+
+ + +

Additional notes

+

We've made many underlying changes in v3 that are not immediately apparent. Base classes, key styles, and behaviors have been adjusted for flexibility and our mobile first approach.

+
    +
  • Text-based form controls are now 100% wide. Wrap inputs inside <div class="col-*"></div> to control input widths.
  • +
  • .badge no longer has contextual (-success,-primary,etc..) classes.
  • +
  • .btn must also use .btn-default to get the "default" button.
  • +
  • .container and .row are now fluid (percentage-based).
  • +
  • Images are no longer responsive by default. Use .img-responsive for fluid <img> size.
  • +
  • The icons, now .glyphicon, are now font based. They also require a base and icon class (e.g. .glyphicon .glyphicon-asterisk).
  • +
  • Typeahead has been dropped, in favor of using Twitter Typeahead.
  • +
  • Modal markup has changed significantly. The .modal-header, .modal-body, and .modal-footer sections now get wrapped in .modal-content and .modal-dialog for improved mobile styling and behavior.
  • +
  • JavaScript events are namespaced. For example, to handle the modal "show" event, use 'show.bs.modal'. For tabs "shown" use 'shown.bs.tab', etc..
  • +
+

For more information on upgrades and code snippets from the community check out Bootply.

@@ -326,7 +634,7 @@ bootstrap/

In addition, Internet Explorer 8 requires the use of respond.js to enable media query support.

IE Compatibility modes

-

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 meta tag in your pages:

+

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 <meta> tag in your pages:

{% highlight html %} {% endhighlight %} @@ -364,7 +672,10 @@ if (navigator.userAgent.match(/IEMobile\/10\.0/)) {

We'll keep an eye on this though and update our code if we have an easy solution.

Modals and mobile devices

+

Overflow and scrolling

Support for overflow: hidden on the <body> element is quite limited in iOS and Android. To that end, when you scroll past the top or bottom of a modal in either of those devices' browsers, the <body> content will begin to scroll.

+

Virtual keyboards

+

Also, note that if you're using inputs in your modal – iOS has a rendering bug which doesn't update the position of fixed elements when the virtual keyboard is triggered. There are a few work arounds for this, including transforming your elements to position: absolute or invoking a timer on focus to try to correct the positioning manually. This is not handled by Bootstrap, so it is up to you to decide which solution is best for your application.

Browser zooming

Page zooming inevitably presents rendering artifacts in some components, both in Bootstrap and the rest of the web. Depending on the issue, we may be able to fix it (search first and then open an issue if need be). However, we tend to ignore these as they often have no direct solution other than hacky workarounds.

@@ -545,7 +856,7 @@ img { max-width: none; }

Alternate customization methods

-

While not recommended for folks new to Bootstrap, you may use one of two alternate methods for customization. The first is modifying the source .less files (making upgrades super difficult), and the second is mapping source LESS code to your own classes via mixins. For the time being, neither options are documented here.

+

While not recommended for folks new to Bootstrap, you may use one of two alternate methods for customization. The first is modifying the source .less files (making upgrades super difficult), and the second is mapping source LESS code to your own classes via mixins. For the time being, neither of those options are documented here.

Removing potential bloat

-- cgit v1.2.3