diff --git a/docs/_includes/docs-nav.html b/docs/_includes/docs-nav.html index 78a26ffb23..f43b568121 100644 --- a/docs/_includes/docs-nav.html +++ b/docs/_includes/docs-nav.html @@ -79,20 +79,63 @@
  • Navs
  • Navbar
  • Breadcrumbs
    • -
  • Pagination
    • +
  • + Pagination + +
  • Labels
  • Badges
    • -
  • Typography
    • +
  • + Typography + +
  • Thumbnails
    • -
  • Alerts
    • -
  • Progress bars
    • +
  • + Alerts + +
    • +
  • + Progress bars + +
  • Media object
  • Wells
  • JavaScript
    • -
  • Overview
    • +
  • + Overview + +
  • Transitions
    • -
  • Modal
    • +
  • + Modal + +
  • Dropdown
  • Scrollspy
  • Tab
    • diff --git a/docs/docs.html b/docs/docs.html index 7f0106c93b..ec7bd29167 100644 --- a/docs/docs.html +++ b/docs/docs.html @@ -2236,220 +2236,220 @@ For example, <section> should be wrapped as inline. -
    -

    Components

    -

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

    -
    +
    +

    Components

    +

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

    +
    - -
    -
    -

    Icons font by Glyphicons

    -
    + +
    +
    +

    Icons font by Glyphicons

    +
    -

    Included glyphs

    -

    Bootstrap comes with all 160 of Glyphicons Halflings set, all available in font formats for easy coloring, sizing, and placement.

    +

    Included glyphs

    +

    Bootstrap comes with all 160 of Glyphicons Halflings set, all available in font formats for easy coloring, sizing, and placement.

    - -

    Glyphicons attribution

    -

    Glyphicons Halflings are normally not available for free, but an arrangement between Bootstrap and the Glyphicons creator have made this possible at no 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 creator have made this possible at no 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

    -

    Add the appropriate class to any inline element. All icon classes are prefixed with glyphicon- for easy styling. To use, place the following code just about anywhere:

    +

    How to use

    +

    Add the appropriate class to any inline element. All icon classes are prefixed with glyphicon- for easy styling. To use, place the following code just about anywhere:

    {% highlight html linenos %} {% endhighlight %} -

    Want to change the icon color? Just change the color of the parent element.

    -

    When using beside strings of text, as in buttons or nav links, be sure to leave a space after the icon for proper spacing.

    +

    Want to change the icon color? Just change the color of the parent element.

    +

    When using beside strings of text, as in buttons or nav links, be sure to leave a space after the icon 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

    +

    Buttons

    -
    Button group in a button toolbar
    -
    -
    -
    - - - - -
    -
    -
    +
    Button group in a button toolbar
    +
    +
    +
    + + + + +
    +
    +
    {% highlight html linenos %}
    @@ -2461,20 +2461,20 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -
    Dropdown in a button group
    -
    -
    - User - - -
    -
    +
    Dropdown in a button group
    +
    +
    + User + + +
    +
    {% highlight html linenos %}
    User @@ -2489,32 +2489,32 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -
    Large button
    -
    - Star -
    +
    Large button
    +
    + Star +
    {% highlight html linenos %} Star {% endhighlight %} -
    Small button
    -
    - -
    +
    Small button
    +
    + +
    {% highlight html linenos %} {% endhighlight %} -

    Navigation

    -
    - -
    +

    Navigation

    +
    + +
    {% highlight html linenos %}
    • Home
      • @@ -2524,18 +2524,18 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -

    Form fields

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

    Form fields

    +
    +
    + +
    +
    + + +
    +
    +
    +
    {% highlight html linenos %}
    @@ -2548,32 +2548,31 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -
    + + + + +
    +
    +

    Button groups

    +
    +

    Group a series of buttons together on a single line with the button group. Add on optional JavaScript radio and checkbox style behavior with our buttons plugin.

    - -
    -
    -

    Button groups

    -
    -

    Group a series of buttons together on a single line with the button group. Add on optional JavaScript radio and checkbox style behavior with our buttons plugin.

    - -

    Single button group

    -

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

    -
    -
    - - - -
    -
    +

    Single button group

    +

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

    +
    +
    + + + +
    +
    {% highlight html linenos %}
    @@ -2732,26 +2730,26 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -

    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.

    +
    +
    +
    + + + + +
    +
    + + + +
    +
    + +
    +
    +
    {% highlight html linenos %}
    ...
    @@ -2760,163 +2758,163 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -

    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.

    +
    +
    + + + + +
    +
    {% highlight html linenos %}
    ...
    {% endhighlight %} -

    Justified button groups

    -

    Make a group of buttons stretch at the same size to span the entire width of its parent. This only works with <a> elements as the <button> doesn't pick up these styles.

    -
    -
    - Left - Right - Middle -
    -
    +

    Justified button groups

    +

    Make a group of buttons stretch at the same size to span the entire width of its parent. This only works with <a> elements as the <button> doesn't pick up these styles.

    +
    +
    + Left + Right + Middle +
    +
    {% highlight html linenos %}
    ...
    {% endhighlight %} -
    +
    - -
    -
    -

    Button dropdown menus

    -
    -

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

    + +
    +
    +

    Button dropdown menus

    +
    +

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

    -

    Single or split button

    -

    Turn a button into dropdown toggle, or add a second button to toggle the dropdown while retaining the primary button action.

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

    Single or split button

    +

    Turn a button into dropdown toggle, or add a second button to toggle the dropdown while retaining the primary button action.

    +
    +
    +
    + + +
    +
    + + +
    +
    + + +
    +
    + + +
    +
    + + +
    +
    -
    -
    - - - -
    -
    - - - -
    -
    - - - -
    -
    - - - -
    -
    - - - -
    -
    -
    +
    +
    + + + +
    +
    + + + +
    +
    + + + +
    +
    + + + +
    +
    + + + +
    +
    +
    {% highlight html linenos %}
    @@ -2948,48 +2946,48 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -

    Works with all button sizes

    -

    Button dropdowns work at any size: .btn-large, .btn-small, or .btn-mini.

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

    Works with all button sizes

    +

    Button dropdowns work at any size: .btn-large, .btn-small, or .btn-mini.

    +
    +
    +
    + + +
    +
    + + +
    +
    + + +
    +
    +
    {% highlight html linenos %}
    @@ -3022,34 +3020,34 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -

    Dropup buttons

    -

    Trigger dropdown menus above elements by adding .dropup to the parent.

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

    Dropup buttons

    +

    Trigger dropdown menus above elements by adding .dropup to the parent.

    +
    +
    +
    + + + +
    +
    + + + +
    +
    +
    {% highlight html linenos %}
    @@ -3062,28 +3060,28 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -
    + - - + - - + - - + - -
    -
    -

    Pagination

    -
    -

    Provide pagination links for your site or app with the multi-page pagination component, or the simpler pager alternative.

    + +
    + - -
    -
    -

    Labels

    -
    -

    + +
    +
    +

    Labels

    +
    +

    -

    Example

    -
    -

    Example heading New

    -

    Example heading New

    -

    Example heading New

    -

    Example heading New

    -
    Example heading New
    -
    Example heading New
    -
    +

    Example

    +
    +

    Example heading New

    +

    Example heading New

    +

    Example heading New

    +

    Example heading New

    +
    Example heading New
    +
    Example heading New
    +
    {% highlight html linenos %}

    Example heading New

    {% endhighlight %} -

    Available variations

    -

    Add any of the below mentioned modifier classes to change the appearance of a label.

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    LabelsMarkup
    - Default - - <span class="label">Default</span> -
    - Success - - <span class="label label-success">Success</span> -
    - Warning - - <span class="label label-warning">Warning</span> -
    - Danger - - <span class="label label-danger">Danger</span> -
    - Info - - <span class="label label-info">Info</span> -
    +

    Available variations

    +

    Add any of the below mentioned modifier classes to change the appearance of a label.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    LabelsMarkup
    + Default + + <span class="label">Default</span> +
    + Success + + <span class="label label-success">Success</span> +
    + Warning + + <span class="label label-warning">Warning</span> +
    + Danger + + <span class="label label-danger">Danger</span> +
    + Info + + <span class="label label-info">Info</span> +
    -
    + - -
    -
    -

    Badges

    -
    -

    Easily highlight new or unread items by adding a <span class="badge"> to links, Bootstrap navs, and more.

    + +
    +
    +

    Badges

    +
    +

    Easily highlight new or unread items by adding a <span class="badge"> to links, Bootstrap navs, and more.

    -
    - Inbox 42 -
    +
    + Inbox 42 +
    {% highlight html linenos %} Inbox 42 {% endhighlight %} -

    Self collapsing

    -

    When there are no new or unread items, badges will simply collapse (via CSS's :empty selector) provided no content exists within.

    +

    Self collapsing

    +

    When there are no new or unread items, badges will simply collapse (via CSS's :empty selector) provided no content exists within.

    -

    Adapts to active nav states

    -

    Built-in styles are included for placing badges in active states in pill and list navigations.

    -
    - -
    - -
    +

    Adapts to active nav states

    +

    Built-in styles are included for placing badges in active states in pill and list navigations.

    +
    + +
    + +
    {% highlight html linenos %} {% endhighlight %} - -
    + - -
    -
    -

    Typographic components

    -
    + +
    +
    +

    Typographic components

    +
    -

    Jumbotron

    -

    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

    -
    -
    +

    Jumbotron

    +

    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

    +
    +
    {% highlight html linenos %}

    Hello, world!

    @@ -3945,57 +3938,56 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -

    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).

    -
    -
    -

    Example page header Subtext for header

    -
    -
    +

    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).

    +
    +
    +

    Example page header Subtext for header

    +
    +
    {% highlight html linenos %}

    Example page header Subtext for header

    {% endhighlight %} - -
    + - -
    -
    -

    Thumbnails

    -
    -

    Extend Bootstrap's grid system with the thumbnail component to easily display grids of images, videos, text, and more.

    + +
    +
    +

    Thumbnails

    +
    +

    Extend Bootstrap's grid system with the thumbnail component to easily display grids of images, videos, text, and more.

    -

    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.

    +
    +
    +
    + + + +
    +
    + + + +
    +
    + + + +
    +
    + + + +
    +
    +
    {% highlight html linenos %}
    @@ -4007,42 +3999,42 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -

    Custom content thumbnails

    -

    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

    -
    -
    -
    +

    Custom content thumbnails

    +

    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

    +
    +
    +
    +
    +
    {% highlight html linenos %}
    @@ -4057,29 +4049,27 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} - - -
    + - -
    -
    -

    Alerts

    -
    -

    Provide contextual feedback messages for typical user actions with the handful of available and flexible alert messages. For inline dismissal, use the alerts jQuery plugin.

    + +
    +
    +

    Alerts

    +
    +

    Provide contextual feedback messages for typical user actions with the handful of available and flexible alert messages. For inline dismissal, use the alerts jQuery plugin.

    -

    Default alert

    -

    Wrap any text and an optional dismiss button in .alert for a basic warning alert message. To ensure proper behavior across all devices, be sure to use <button> element with the data-dismiss="alert" data attribute.

    -
    -
    - - 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. To ensure proper behavior across all devices, be sure to use <button> element with the data-dismiss="alert" data attribute.

    +
    +
    + + Warning! Best check yo self, you're not looking too good. +
    +
    {% highlight html linenos %}
    @@ -4087,15 +4077,15 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -

    Block alerts

    -

    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.

    -
    -
    +

    Block alerts

    +

    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.

    +
    +
    {% highlight html linenos %}
    @@ -4104,71 +4094,71 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -

    Contextual alternatives

    -

    Add optional classes to change an alert's connotation.

    -
    -
    - - Oh snap! Change a few things up and try submitting again. -
    -
    - - Well done! You successfully read this important alert message. -
    -
    - - Heads up! This alert needs your attention, but it's not super important. -
    -
    +

    Contextual alternatives

    +

    Add optional classes to change an alert's connotation.

    +
    +
    + + Oh snap! Change a few things up and try submitting again. +
    +
    + + Well done! You successfully read this important alert message. +
    +
    + + Heads up! This alert needs your attention, but it's not super important. +
    +
    {% highlight html linenos %}
    ...
    ...
    ...
    {% endhighlight %} -
    + - -
    -
    -

    Progress bars

    -
    -

    Provide up-to-date feedback on the progress of a workflow or action with simple yet flexible progress bars.

    + +
    +
    +

    Progress bars

    +
    +

    Provide up-to-date feedback on the progress of a workflow or action with simple yet flexible progress bars.

    -

    Progress bars use CSS3 transitions and animations to achieve some of their effects. These features are not supported in IE8-9 or older versions of Firefox. Internet Explorer 10 and below, as well as Opera 12, do not support animations.

    +

    Progress bars use CSS3 transitions and animations to achieve some of their effects. These features are not supported in IE8-9 or older versions of Firefox. Internet Explorer 10 and below, as well as Opera 12, do not support animations.

    -

    Basic

    -

    Default progress bar with a vertical gradient.

    -
    -
    -
    -
    -
    +

    Basic

    +

    Default progress bar with a vertical gradient.

    +
    +
    +
    +
    +
    {% highlight html linenos %}
    {% endhighlight %} -

    Additional colors

    -

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

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

    Contextual alternatives

    +

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

    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    {% highlight html linenos %}
    @@ -4184,22 +4174,22 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -

    Striped

    -

    Uses a gradient to create a striped effect. Not available in IE8.

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

    Striped

    +

    Uses a gradient to create a striped effect. Not available in IE8.

    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    +
    {% highlight html linenos %}
    @@ -4215,28 +4205,28 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -

    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.

    +
    +
    +
    +
    +
    {% highlight html linenos %}
    {% endhighlight %} -

    Stacked

    -

    Place multiple bars into the same .progress to stack them.

    -
    -
    -
    -
    -
    -
    -
    +

    Stacked

    +

    Place multiple bars into the same .progress to stack them.

    +
    +
    +
    +
    +
    +
    +
    {% highlight html linenos %}
    @@ -4244,51 +4234,50 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} - -
    + - -
    -
    -

    Media object

    + +
    +
    +

    Media object

    +
    +

    Abstract object styles for building various types of components (like blog comments, Tweets, etc) that feature a left- or right-aligned image alongside textual content.

    + +

    Default example

    +

    The default media allow to float a media object (images, video, audio) to the left or right of a content block.

    +
    +
    + + + +
    +

    Media heading

    + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. +
    +
    +
    + + + +
    +

    Media heading

    + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. +
    + + + +
    +

    Media heading

    + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. +
    -

    Abstract object styles for building various types of components (like blog comments, Tweets, etc) that feature a left- or right-aligned image alongside textual content.

    - -

    Default example

    -

    The default media allow to float a media object (images, video, audio) to the left or right of a content block.

    -
    -
    - - - -
    -

    Media heading

    - Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. -
    -
    -
    - - - -
    -

    Media heading

    - Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. -
    - - - -
    -

    Media heading

    - Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. Fusce condimentum nunc ac nisi vulputate fringilla. Donec lacinia congue felis in faucibus. -
    -
    -
    -
    -
    +
    +
    +
    {% highlight html linenos %}
    @@ -4301,60 +4290,60 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} -

    Media list

    -

    With a bit of extra markup, you can use media inside list (useful for comment threads or articles lists).

    -
    -
      -
    • - - - -
      -

      Media heading

      -

      Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.

      - -
      - - - -
      -

      Nested media heading

      - Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. - -
      - - - -
      -

      Nested media heading

      - Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. -
      -
      -
      -
      - -
      - - - -
      -

      Nested media heading

      - Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. -
      +

      Media list

      +

      With a bit of extra markup, you can use media inside list (useful for comment threads or articles lists).

      +
      +
        +
      • + + + +
        +

        Media heading

        +

        Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.

        + +
        + + + +
        +

        Nested media heading

        + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. + +
        + + + +
        +

        Nested media heading

        + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis.
        -
        • -
      • - - - -
        -

        Media heading

        - Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. -
        -
        • -
      +
      +
      + +
      + + + +
      +

      Nested media heading

      + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. +
      +
      +
      • +
    • + + + +
      +

      Media heading

      + Cras sit amet nibh libero, in gravida nulla. Nulla vel metus scelerisque ante sollicitudin commodo. Cras purus odio, vestibulum in vulputate at, tempus viverra turpis. +
      +
      • +
    +
    {% highlight html linenos %}
    • @@ -4368,175 +4357,170 @@ For example, <section> should be wrapped as inline.
    {% endhighlight %} - -
    + - -
    -
    -

    Wells

    -
    + +
    +
    +

    Wells

    +
    -

    Default well

    -

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

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

    Default well

    +

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

    +
    +
    + Look, I'm in a well! +
    +
    {% highlight html linenos %}
    ...
    {% endhighlight %} -

    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! +
    +
    {% highlight html linenos %}
    ...
    {% endhighlight %} -
    -
    - Look, I'm in a well! -
    -
    +
    +
    + Look, I'm in a well! +
    +
    {% highlight html linenos %}
    ...
    {% endhighlight %} - -
    +
    -
    -

    JavaScript plugins

    -

    Bring Bootstrap's components to life with over a dozen custom jQuery plugins. Easily include them all, or one by one.

    +
    +

    JavaScript plugins

    +

    Bring Bootstrap's components to life with over a dozen custom jQuery plugins. Easily include them all, or one by one.

    +
    + + + +
    +
    +

    Overview

    +

    Individual or compiled

    +

    Plugins can be included individually (though some have required dependencies), or all at once. Do attempt to include both. Both bootstrap.js and bootstrap.min.js contain all plugins in a single file.

    - -
    -
    -

    Overview

    -
    +

    Data attributes

    +

    You can use all Bootstrap plugins purely through the markup API without writing a single line of JavaScript. This is Bootstrap's first class API and should be your first consideration when using a plugin.

    -

    Individual or compiled

    -

    Plugins can be included individually (though some have required dependencies), or all at once. Do attempt to include both. Both bootstrap.js and bootstrap.min.js contain all plugins in a single file.

    - -

    Data attributes

    -

    You can use all Bootstrap plugins purely through the markup API without writing a single line of JavaScript. This is Bootstrap's first class API and should be your first consideration when using a plugin.

    - -

    That said, in some situations it may be desirable to turn this functionality off. Therefore, we also provide the ability to disable the data attribute API by unbinding all events on the body namespaced with `'data-api'`. This looks like this: +

    That said, in some situations it may be desirable to turn this functionality off. Therefore, we also provide the ability to disable the data attribute API by unbinding all events on the body namespaced with `'data-api'`. This looks like this: {% highlight js linenos %} $('body').off('.data-api') {% endhighlight %} -

    Alternatively, to target a specific plugin, just include the plugin's name as a namespace along with the data-api namespace like this:

    +

    Alternatively, to target a specific plugin, just include the plugin's name as a namespace along with the data-api namespace like this:

    {% highlight js linenos %} $('body').off('.alert.data-api') {% endhighlight %} -

    Programmatic API

    -

    We also believe you should be able to use all Bootstrap plugins purely through the JavaScript API. All public APIs are single, chainable methods, and return the collection acted upon.

    +

    Programmatic API

    +

    We also believe you should be able to use all Bootstrap plugins purely through the JavaScript API. All public APIs are single, chainable methods, and return the collection acted upon.

    {% highlight js linenos %} $(".btn.danger").button("toggle").addClass("fat") {% endhighlight %} -

    All methods should accept an optional options object, a string which targets a particular method, or nothing (which initiates a plugin with default behavior):

    +

    All methods should accept an optional options object, a string which targets a particular method, or nothing (which initiates a plugin with default behavior):

    {% highlight js linenos %} $("#myModal").modal() // initialized with defaults $("#myModal").modal({ keyboard: false }) // initialized with no keyboard $("#myModal").modal('show') // initializes and invokes show immediately

    {% endhighlight %} -

    Each plugin also exposes its raw constructor on a `Constructor` property: $.fn.popover.Constructor. If you'd like to get a particular plugin instance, retrieve it directly from an element: $('[rel=popover]').data('popover').

    +

    Each plugin also exposes its raw constructor on a `Constructor` property: $.fn.popover.Constructor. If you'd like to get a particular plugin instance, retrieve it directly from an element: $('[rel=popover]').data('popover').

    -

    No conflict

    -

    Sometimes it is necessary to use Bootstrap plugins with other UI frameworks. In these circumstances, namespace collisions can occasionally occur. If this happens, you may call .noConflict on the plugin you wish to revert the value of.

    +

    No conflict

    +

    Sometimes it is necessary to use Bootstrap plugins with other UI frameworks. In these circumstances, namespace collisions can occasionally occur. If this happens, you may call .noConflict on the plugin you wish to revert the value of.

    {% highlight js linenos %} var bootstrapButton = $.fn.button.noConflict() // return $.fn.button to previously assigned value $.fn.bootstrapBtn = bootstrapButton // give $().bootstrapBtn the bootstrap functionality {% endhighlight %} - -

    Events

    -

    Bootstrap provides custom events for most plugin's unique actions. Generally, these come in an infinitive and past participle form - where the infinitive (ex. show) is triggered at the start of an event, and its past participle form (ex. shown) is trigger on the completion of an action.

    -

    All infinitive events provide preventDefault functionality. This provides the ability to stop the execution of an action before it starts.

    +

    Events

    +

    Bootstrap provides custom events for most plugin's unique actions. Generally, these come in an infinitive and past participle form - where the infinitive (ex. show) is triggered at the start of an event, and its past participle form (ex. shown) is trigger on the completion of an action.

    +

    All infinitive events provide preventDefault functionality. This provides the ability to stop the execution of an action before it starts.

    {% highlight js linenos %} $('#myModal').on('show', function (e) { - if (!data) return e.preventDefault() // stops modal from being shown + if (!data) return e.preventDefault() // stops modal from being shown }) {% endhighlight %} - -
    +
    - -
    -
    -

    Transitions bootstrap-transition.js

    -
    -

    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:

    - + +
    +
    +

    Transitions bootstrap-transition.js

    +
    +

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

    Modals bootstrap-modal.js

    -
    + +
    +
    +

    Modals bootstrap-modal.js

    +
    +

    Examples

    +

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

    -

    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.

    -
    -
    -
    -
    -
    - -

    Modal title

    -
    -
    -

    One fine body…

    -
    -
    - Close - Save changes -
    -
    -
    -
    -
    +

    Static example

    +

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

    +
    +
    +
    +
    +
    + +

    Modal title

    +
    +
    +

    One fine body…

    +
    +
    + Close + Save changes +
    +
    +
    +
    +
    {% highlight html linenos %}
    @@ -4557,49 +4541,49 @@ $('#myModal').on('show', function (e) {
    {% endhighlight %} -

    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.

    - - -
    - Launch demo modal -
    +
    + Launch demo modal +
    {% highlight html linenos %}
    @@ -4626,116 +4610,116 @@ $('#myModal').on('show', function (e) { -

    Usage

    +

    Usage

    -

    Via data attributes

    -

    Activate a modal without writing JavaScript. Set data-toggle="modal" on a controller element, like a button, along with a data-target="#foo" or href="#foo" to target a specific modal to toggle.

    +

    Via data attributes

    +

    Activate a modal without writing JavaScript. Set data-toggle="modal" on a controller element, like a button, along with a data-target="#foo" or href="#foo" to target a specific modal to toggle.

    {% highlight html linenos %} {% endhighlight %} -

    Via JavaScript

    -

    Call a modal with id myModal with a single line of JavaScript:

    - {% highlight js linenos %}$('#myModal').modal(options){% endhighlight %} +

    Via JavaScript

    +

    Call a modal with id myModal with a single line of JavaScript:

    + {% highlight js linenos %}$('#myModal').modal(options){% endhighlight %} -

    Options

    -

    Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-, as in data-backdrop="".

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + +
    Nametypedefaultdescription
    backdropbooleantrueIncludes a modal-backdrop element. Alternatively, specify static for a backdrop which doesn't close the modal on click.
    keyboardbooleantrueCloses the modal when escape key is pressed
    showbooleantrueShows the modal when initialized.
    remotepathfalse

    If a remote url is provided, content will be loaded via jQuery's load method and injected into the .modal-body. If you're using the data api, you may alternatively use the href tag to specify the remote source. An example of this is shown below:

    +

    Options

    +

    Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-, as in data-backdrop="".

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - -
    Nametypedefaultdescription
    backdropbooleantrueIncludes a modal-backdrop element. Alternatively, specify static for a backdrop which doesn't close the modal on click.
    keyboardbooleantrueCloses the modal when escape key is pressed
    showbooleantrueShows the modal when initialized.
    remotepathfalse

    If a remote url is provided, content will be loaded via jQuery's load method and injected into the .modal-body. If you're using the data api, you may alternatively use the href tag to specify the remote source. An example of this is shown below:

    {% highlight html linenos %} Click me {% endhighlight %} -
    +
    -

    Methods

    +

    Methods

    -

    .modal(options)

    -

    Activates your content as a modal. Accepts an optional options object.

    +

    .modal(options)

    +

    Activates your content as a modal. Accepts an optional options object.

    {% highlight js linenos %} $('#myModal').modal({ keyboard: false }) {% endhighlight %} -

    .modal('toggle')

    -

    Manually toggles a modal.

    - {% highlight js linenos %}$('#myModal').modal('toggle'){% endhighlight %} +

    .modal('toggle')

    +

    Manually toggles a modal.

    + {% highlight js linenos %}$('#myModal').modal('toggle'){% endhighlight %} -

    .modal('show')

    -

    Manually opens a modal.

    - {% highlight js linenos %}$('#myModal').modal('show'){% endhighlight %} +

    .modal('show')

    +

    Manually opens a modal.

    + {% highlight js linenos %}$('#myModal').modal('show'){% endhighlight %} -

    .modal('hide')

    -

    Manually hides a modal.

    - {% highlight js linenos %}$('#myModal').modal('hide'){% endhighlight %} +

    .modal('hide')

    +

    Manually hides a modal.

    + {% highlight js linenos %}$('#myModal').modal('hide'){% endhighlight %} -

    Events

    -

    Bootstrap's modal class exposes a few events for hooking into modal functionality.

    - - - - - - - - - - - - - - - - - - - - - - - - - -
    EventDescription
    showThis event fires immediately when the show instance method is called.
    shownThis event is fired when the modal has been made visible to the user (will wait for css transitions to complete).
    hideThis event is fired immediately when the hide instance method has been called.
    hiddenThis event is fired when the modal has finished being hidden from the user (will wait for css transitions to complete).
    +

    Events

    +

    Bootstrap's modal class exposes a few events for hooking into modal functionality.

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    EventDescription
    showThis event fires immediately when the show instance method is called.
    shownThis event is fired when the modal has been made visible to the user (will wait for css transitions to complete).
    hideThis event is fired immediately when the hide instance method has been called.
    hiddenThis event is fired when the modal has finished being hidden from the user (will wait for css transitions to complete).
    {% highlight js linenos %} $('#myModal').on('hidden', function () { // do something… }) {% endhighlight %} -
    +