From c59e5251e12a57b5f305b4996d6f164b71c7f22c Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Tue, 25 Sep 2012 22:48:02 -0700 Subject: initial pass at removing navbar-inner from .navbar component --- docs/javascript.html | 64 +++++++++++++++++++++++++--------------------------- 1 file changed, 31 insertions(+), 33 deletions(-) (limited to 'docs/javascript.html') diff --git a/docs/javascript.html b/docs/javascript.html index 6c028e01e..0dcd2053d 100644 --- a/docs/javascript.html +++ b/docs/javascript.html @@ -32,39 +32,37 @@
-
-
- - Bootstrap -
- -
+
+ + Bootstrap +
+
-- cgit v1.2.3 From cd5ae9e0304dfba17d445b0c2dac7b17a1faa201 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Wed, 26 Sep 2012 11:20:27 -0700 Subject: change up carousel --- docs/javascript.html | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) (limited to 'docs/javascript.html') diff --git a/docs/javascript.html b/docs/javascript.html index 0dcd2053d..0a757c2de 100644 --- a/docs/javascript.html +++ b/docs/javascript.html @@ -1416,27 +1416,31 @@ $('#myCollapsible').on('hidden', function () {
-

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

+

First slide label

+

Nulla vitae elit libero, a pharetra augue. Maecenas faucibus mollis interdum. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.

-

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

+

Second slide label

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean lacinia bibendum nulla sed consectetur. Nullam quis risus eget urna mollis ornare vel eu leo.

-

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

+

Third slide label

+

Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Integer posuere erat a ante venenatis dapibus posuere velit aliquet. Nullam id dolor id nibh ultricies vehicula ut id elit.

- ‹ - › + + ‹ + + + › + 
-- 
cgit v1.2.3


From 26386ad615a48be02d896a41b7c72a7470c8a9c3 Mon Sep 17 00:00:00 2001
From: Mark Otto 
Date: Mon, 1 Oct 2012 00:05:18 -0700
Subject: remove tabbable tabs on left, right, and bottom; instead, from here
 out use stacked pills or tabs

---
 docs/javascript.html | 1 +
 1 file changed, 1 insertion(+)

(limited to 'docs/javascript.html')

diff --git a/docs/javascript.html b/docs/javascript.html
index 03d670132..241ea9cd0 100644
--- a/docs/javascript.html
+++ b/docs/javascript.html
@@ -691,6 +691,7 @@ $('#myTab li:eq(2) a').tab('show'); // Select third tab (0-indexed)
   <li><a href="#messages" data-toggle="tab">Messages</a></li>
   <li><a href="#settings" data-toggle="tab">Settings</a></li>
 </ul>
+

To make tabs fade in, add .fade to each .tab-pane.

Methods

$().tab

-- cgit v1.2.3 From 3de6f3ff88eeac5276af46e0262101b715dea1ad Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sat, 3 Nov 2012 16:18:02 -0700 Subject: Swap old icons for new in docs --- docs/javascript.html | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) (limited to 'docs/javascript.html') diff --git a/docs/javascript.html b/docs/javascript.html index 1b14e4430..b138809b7 100644 --- a/docs/javascript.html +++ b/docs/javascript.html @@ -83,20 +83,20 @@
-- cgit v1.2.3 From 05a2d375594779d534a200ed112787649b67f3a2 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sun, 4 Nov 2012 00:37:49 -0700 Subject: run make after removing responsive css file --- docs/javascript.html | 1 - 1 file changed, 1 deletion(-) (limited to 'docs/javascript.html') diff --git a/docs/javascript.html b/docs/javascript.html index b138809b7..445bda40d 100644 --- a/docs/javascript.html +++ b/docs/javascript.html @@ -9,7 +9,6 @@ - -- cgit v1.2.3 From ebd2215e494e77a0da3283c1006a5ac164b8e862 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Fri, 30 Nov 2012 16:31:24 -0800 Subject: remove deleted css files, run make --- docs/javascript.html | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) (limited to 'docs/javascript.html') diff --git a/docs/javascript.html b/docs/javascript.html index 407f7e234..944cf0d6f 100644 --- a/docs/javascript.html +++ b/docs/javascript.html @@ -47,10 +47,7 @@ Get started
  • - Scaffolding -
    • -
  • - Base CSS + Core CSS
  • Components -- cgit v1.2.3 From dd11d0a3fa4ba061f6dcb8db81f144d81101e052 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sat, 1 Dec 2012 13:47:07 -0800 Subject: move around social buttons --- docs/javascript.html | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) (limited to 'docs/javascript.html') diff --git a/docs/javascript.html b/docs/javascript.html index 944cf0d6f..5ab64e411 100644 --- a/docs/javascript.html +++ b/docs/javascript.html @@ -1705,6 +1705,25 @@ $('[data-spy="affix"]').each(function () { ================================================== -->
    + +
    + +
    + +

    Designed and built with all the love in the world by @mdo and @fat.

    Code licensed under Apache License v2.0, documentation under CC BY 3.0.

    Glyphicons Free licensed under CC BY 3.0.

    -- cgit v1.2.3 From b3019d7aab877cccf03fda3e6894c0fdaa7330f3 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Tue, 4 Dec 2012 20:30:21 -0800 Subject: add gallery page, fill with a few screenshots to start --- docs/javascript.html | 3 +++ 1 file changed, 3 insertions(+) (limited to 'docs/javascript.html') diff --git a/docs/javascript.html b/docs/javascript.html index 5ab64e411..a6314b4b2 100644 --- a/docs/javascript.html +++ b/docs/javascript.html @@ -58,6 +58,9 @@
  • Customize
    • +
  • + Gallery +
    • -- cgit v1.2.3 From 65edc9cd6e453a7bf30ccbd6a57b3ea340e21907 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Wed, 19 Dec 2012 21:42:36 -0800 Subject: Change .jumbotron usage in docs layout to .bs-docs-jumbotron --- docs/javascript.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/javascript.html') diff --git a/docs/javascript.html b/docs/javascript.html index 47435bfbf..d3e780980 100644 --- a/docs/javascript.html +++ b/docs/javascript.html @@ -68,7 +68,7 @@ -
    +

    JavaScript

    Bring Bootstrap's components to life—now with 13 custom jQuery plugins. -- cgit v1.2.3 From acde2dc1ee01384ca9a79573ad21c37863697946 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Thu, 20 Dec 2012 00:20:00 -0800 Subject: Nuke third lines form carousel examples --- docs/javascript.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'docs/javascript.html') diff --git a/docs/javascript.html b/docs/javascript.html index 26d6021cc..bc4d18ca7 100644 --- a/docs/javascript.html +++ b/docs/javascript.html @@ -1430,21 +1430,21 @@ $('#myCollapsible').on('hidden', function () {

    First slide label

    -

    Nulla vitae elit libero, a pharetra augue. Maecenas faucibus mollis interdum. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.

    +

    Nulla vitae elit libero, a pharetra augue. Maecenas faucibus mollis interdum. Cum sociis natoque penatibus et magnis dis parturient montes.

    Second slide label

    -

    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean lacinia bibendum nulla sed consectetur. Nullam quis risus eget urna mollis ornare vel eu leo.

    +

    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean lacinia bibendum nulla sed consectetur. Nullam quis risus eget urna mollis ornare.

    Third slide label

    -

    Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Integer posuere erat a ante venenatis dapibus posuere velit aliquet. Nullam id dolor id nibh ultricies vehicula ut id elit.

    +

    Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Integer posuere erat a ante venenatis dapibus posuere velit aliquet.

    -- cgit v1.2.3 From 6bd5dc7d9fefd6d936def8a224bf38c6beeac234 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Thu, 20 Dec 2012 13:53:38 -0800 Subject: Add important flag to .show/.hide utility classes; remove .hide requirement from modals --- docs/javascript.html | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'docs/javascript.html') diff --git a/docs/javascript.html b/docs/javascript.html index bc4d18ca7..2d01af561 100644 --- a/docs/javascript.html +++ b/docs/javascript.html @@ -186,7 +186,7 @@ $('#myModal').on('show', function (e) {

    Static example

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

    -
    +

    Modal header

    @@ -201,7 +201,7 @@ $('#myModal').on('show', function (e) { 
    -<div class="modal hide fade">
+<div class="modal fade">
   <div class="modal-header">
     <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
     <h3>Modal header</h3>
@@ -219,7 +219,7 @@ $('#myModal').on('show', function (e) {
           
    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.
    
           
-          
 
 
+          
    Tooltips in input groups
    
+          
    When using tooltips and popovers with the Bootstrap input groups, you'll have to set the container (documented below) option to avoid unwanted side effects.
    
+
           
    
 
 
-- 
cgit v1.2.3


From cdb2147b132792dd29628055d0fd753ad6bf59a0 Mon Sep 17 00:00:00 2001
From: Mark Otto 
Date: Thu, 7 Feb 2013 19:00:48 -0800
Subject: add new modal to docs example

---
 docs/javascript.html | 34 ++++++++++++++++++++--------------
 1 file changed, 20 insertions(+), 14 deletions(-)

(limited to 'docs/javascript.html')

diff --git a/docs/javascript.html b/docs/javascript.html
index 6b60cfcd5..8f941f278 100644
--- a/docs/javascript.html
+++ b/docs/javascript.html
@@ -185,20 +185,26 @@ $('#myModal').on('show', function (e) {
 
           
    Static example
    
           
    A rendered modal with header, body, and set of actions in the footer.
    
-          
    
-            
    
-              
    
-                
-                
    Modal header
    
-              
    
-              
    
-                
    One fine body…
    
-              
    
-              
    
-                Close
-                Save changes
-              
    
-            
    
+          
    
+
+            
    
+              
    
+                
    
+                  
    
+                    
+                    
    Modal header
    
+                  
    
+                  
    
+                    
    One fine body…
    
+                  
    
+                  
    
+                    Close
+                    Save changes
+                  
    
+                
    
+              
    
+            
    
+
           
    
 
     <div class="modal fade">
-- 
cgit v1.2.3


From a623b8c10f4293bd40a1e7c144b61fe374179826 Mon Sep 17 00:00:00 2001
From: Mark Otto 
Date: Thu, 7 Feb 2013 19:21:56 -0800
Subject: update docs modals

---
 docs/javascript.html | 96 ++++++++++++++++++++++++++++++----------------------
 1 file changed, 55 insertions(+), 41 deletions(-)

(limited to 'docs/javascript.html')

diff --git a/docs/javascript.html b/docs/javascript.html
index 8f941f278..cc8e6961b 100644
--- a/docs/javascript.html
+++ b/docs/javascript.html
@@ -192,7 +192,7 @@ $('#myModal').on('show', function (e) {
                 
    
                   
    
                     
-                    
    Modal header
    
+                    
    Modal title
    
                   
    
                   
    
                     
    One fine body…
    
@@ -208,16 +208,22 @@ $('#myModal').on('show', function (e) {
           
    
 
     <div class="modal fade">
-  <div class="modal-header">
-    <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
-    <h3>Modal header</h3>
-  </div>
-  <div class="modal-body">
-    <p>One fine body…</p>
-  </div>
-  <div class="modal-footer">
-    <a href="#" class="btn">Close</a>
-    <a href="#" class="btn btn-primary">Save changes</a>
+  <div class="modal-dialog">
+    <div class="modal-content">
+
+      <div class="modal-header">
+        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
+        <h4 class="modal-title">Modal title</h4>
+      </div>
+      <div class="modal-body">
+        <p>One fine body…</p>
+      </div>
+      <div class="modal-footer">
+        <a href="#" class="btn">Close</a>
+        <a href="#" class="btn btn-primary">Save changes</a>
+      </div>
+
+    </div>
   </div>
 </div>
 
    
@@ -226,36 +232,44 @@ $('#myModal').on('show', function (e) {
           
    Toggle a modal via JavaScript by clicking the button below. It will slide down and fade in from the top of the page.
    
           
           
+
+            
    
+              
    
+
+                
    
+                  
+                  
+                
    
+                
    
+                  
    Text in a modal
    
+                  
    Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem.
    
+
+                  
    Popover in a modal
    
+                  
    This button should trigger a popover on click.
    
+
+                  
    Tooltips in a modal
    
+                  
    This link and that link should have tooltips on hover.
    
+
+                  
    
+
+                  
    Overflowing text to show optional scrollbar
    
+                  
    We set a fixed max-height on the .modal-body. Watch it overflow with all this extra lorem ipsum text we've included.
    
+                  
    Cras mattis consectetur purus sit amet fermentum. Cras justo odio, dapibus ac facilisis in, egestas eget quam. Morbi leo risus, porta ac consectetur ac, vestibulum at eros.
    
+                  
    Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor.
    
+                  
    Aenean lacinia bibendum nulla sed consectetur. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Donec sed odio dui. Donec ullamcorper nulla non metus auctor fringilla.
    
+                  
    Cras mattis consectetur purus sit amet fermentum. Cras justo odio, dapibus ac facilisis in, egestas eget quam. Morbi leo risus, porta ac consectetur ac, vestibulum at eros.
    
+                  
    Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor.
    
+                  
    Aenean lacinia bibendum nulla sed consectetur. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Donec sed odio dui. Donec ullamcorper nulla non metus auctor fringilla.
    
+                
    
+                
    
+                  
+                  
+                
    
+
+              
    
+            
    
+          
    
+
           
    
             Launch demo modal
           
    
-- 
cgit v1.2.3


From b04acb37e830e1b1a299fab5d543b6ac0c70a1b0 Mon Sep 17 00:00:00 2001
From: Mark Otto 
Date: Thu, 7 Feb 2013 19:31:12 -0800
Subject: finish modal tweaks

---
 docs/javascript.html | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

(limited to 'docs/javascript.html')

diff --git a/docs/javascript.html b/docs/javascript.html
index cc8e6961b..ef2ba0890 100644
--- a/docs/javascript.html
+++ b/docs/javascript.html
@@ -242,7 +242,7 @@ $('#myModal').on('show', function (e) {
                 
    
                 
    
                   
    Text in a modal
    
-                  
    Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem.
    
+                  
    Duis mollis, est non commodo luctus, nisi erat porttitor ligula.
    
 
                   
    Popover in a modal
    
                   
    This button should trigger a popover on click.
    
@@ -253,7 +253,6 @@ $('#myModal').on('show', function (e) {
                   
    
 
                   
    Overflowing text to show optional scrollbar
    
-                  
    We set a fixed max-height on the .modal-body. Watch it overflow with all this extra lorem ipsum text we've included.
    
                   
    Cras mattis consectetur purus sit amet fermentum. Cras justo odio, dapibus ac facilisis in, egestas eget quam. Morbi leo risus, porta ac consectetur ac, vestibulum at eros.
    
                   
    Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor.
    
                   
    Aenean lacinia bibendum nulla sed consectetur. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Donec sed odio dui. Donec ullamcorper nulla non metus auctor fringilla.
    
-- 
cgit v1.2.3


From cfa1e395103a8110e11b77917aa3896c99a0fd0e Mon Sep 17 00:00:00 2001
From: Mark Otto 
Date: Thu, 7 Feb 2013 19:32:30 -0800
Subject: nuke that whitespace

---
 docs/javascript.html | 1 -
 1 file changed, 1 deletion(-)

(limited to 'docs/javascript.html')

diff --git a/docs/javascript.html b/docs/javascript.html
index ef2ba0890..9af6a3cd4 100644
--- a/docs/javascript.html
+++ b/docs/javascript.html
@@ -232,7 +232,6 @@ $('#myModal').on('show', function (e) {
           
    Toggle a modal via JavaScript by clicking the button below. It will slide down and fade in from the top of the page.
    -
    - -

    Usage

    Via data attributes

    -- cgit v1.2.3 From 8b9733b288a3daca0da04fe60e0b5a0ae8681362 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Tue, 12 Feb 2013 12:25:05 -0800 Subject: nuke what we don't need for jekyll --- docs/javascript.html | 1829 -------------------------------------------------- 1 file changed, 1829 deletions(-) delete mode 100644 docs/javascript.html (limited to 'docs/javascript.html') diff --git a/docs/javascript.html b/docs/javascript.html deleted file mode 100644 index d1fd020fd..000000000 --- a/docs/javascript.html +++ /dev/null @@ -1,1829 +0,0 @@ - - - - - Javascript · Bootstrap - - - - - - - - - - - - - - - - - - - - - - - - - - -
    -
    - - Bootstrap -
    - -
    -
    -
    - - -
    -
    -

    JavaScript

    -

    Bring Bootstrap's components to life—now with 13 custom jQuery plugins. -

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

    JavaScript in Bootstrap

    -
    - -

    Individual or compiled

    -

    Plugins can be included individually (though some have required dependencies), or all at once. 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: - 

    $('body').off('.data-api')
    - -

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

    - 
    $('body').off('.alert.data-api')
    - -

    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.

    - 
    $(".btn.danger").button("toggle").addClass("fat")
    -

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

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

    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.

    - -
    -var bootstrapButton = $.fn.button.noConflict() // return $.fn.button to previously assigned value
-$.fn.bootstrapBtn = bootstrapButton            // give $().bootstrapBtn the bootstrap functionality
-
    - -

    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.

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

    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

    -
    - - -

    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 -
    -
    -
    -
    - -
    -
    -<div class="modal fade">
-  <div class="modal-dialog">
-    <div class="modal-content">
-
-      <div class="modal-header">
-        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
-        <h4 class="modal-title">Modal title</h4>
-      </div>
-      <div class="modal-body">
-        <p>One fine body…</p>
-      </div>
-      <div class="modal-footer">
-        <a href="#" class="btn">Close</a>
-        <a href="#" class="btn btn-primary">Save changes</a>
-      </div>
-
-    </div>
-  </div>
-</div>
-
    - -

    Live demo

    -

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

    - - - -
    - Launch demo modal -
    -
    -<!-- Button to trigger modal -->
-<a href="#myModal" role="button" class="btn" data-toggle="modal">Launch demo modal</a>
-
-<!-- Modal -->
-<div id="myModal" class="modal fade" tabindex="-1" role="dialog" aria-labelledby="myModalLabel" aria-hidden="true">
-  <div class="modal-dialog">
-    <div class="modal-content">
-
-      <div class="modal-header">
-        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
-        <h4 class="modal-title">Modal title</h4>
-      </div>
-      <div class="modal-body">
-        ...
-      </div>
-      <div class="modal-footer">
-        <a href="#" class="btn">Close</a>
-        <a href="#" class="btn btn-primary">Save changes</a>
-      </div>
-
-    </div>
-  </div>
-</div>
-
    - - -

    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.

    - 
    <button type="button" data-toggle="modal" data-target="#myModal">Launch modal</button>
    - -

    Via JavaScript

    -

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

    - 
    $('#myModal').modal(options)
    - -

    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:

    - 
    <a data-toggle="modal" href="remote.html" data-target="#modal">click me</a>
    - -

    Methods

    -

    .modal(options)

    -

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

    -
    -$('#myModal').modal({
-  keyboard: false
-})
-
    -

    .modal('toggle')

    -

    Manually toggles a modal.

    - 
    $('#myModal').modal('toggle')
    -

    .modal('show')

    -

    Manually opens a modal.

    - 
    $('#myModal').modal('show')
    -

    .modal('hide')

    -

    Manually hides a modal.

    - 
    $('#myModal').modal('hide')
    -

    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).
    -
    -$('#myModal').on('hidden', function () {
-  // do something…
-})
-
    -
    - - - - - - - - - -
    -
    -

    ScrollSpy bootstrap-scrollspy.js

    -
    - - -

    Example in navbar

    -

    The ScrollSpy plugin is for automatically updating nav targets based on scroll position. Scroll the area below the navbar and watch the active class change. The dropdown sub items will be highlighted as well.

    -
    - -
    -

    @fat

    -

    Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.

    -

    @mdo

    -

    Veniam marfa mustache skateboard, adipisicing fugiat velit pitchfork beard. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. Tattooed cosby sweater food truck, mcsweeney's quis non freegan vinyl. Lo-fi wes anderson +1 sartorial. Carles non aesthetic exercitation quis gentrify. Brooklyn adipisicing craft beer vice keytar deserunt.

    -

    one

    -

    Occaecat commodo aliqua delectus. Fap craft beer deserunt skateboard ea. Lomo bicycle rights adipisicing banh mi, velit ea sunt next level locavore single-origin coffee in magna veniam. High life id vinyl, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi DIY minim messenger bag. Cred ex in, sustainable delectus consectetur fanny pack iphone.

    -

    two

    -

    In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.

    -

    three

    -

    Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.

    -

    Keytar twee blog, culpa messenger bag marfa whatever delectus food truck. Sapiente synth id assumenda. Locavore sed helvetica cliche irony, thundercats you probably haven't heard of them consequat hoodie gluten-free lo-fi fap aliquip. Labore elit placeat before they sold out, terry richardson proident brunch nesciunt quis cosby sweater pariatur keffiyeh ut helvetica artisan. Cardigan craft beer seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats. -

    -
    -
    - - -
    - - -

    Usage

    - -

    Via data attributes

    -

    To easily add scrollspy behavior to your topbar navigation, just add data-spy="scroll" to the element you want to spy on (most typically this would be the body) and data-target=".navbar" to select which nav to use. You'll want to use scrollspy with a .nav component.

    - 
    <body data-spy="scroll" data-target=".navbar">...</body>
    - -

    Via JavaScript

    -

    Call the scrollspy via JavaScript:

    - 
    $('#navbar').scrollspy()
    - -
    - Heads up! - Navbar links must have resolvable id targets. For example, a <a href="#home">home</a> must correspond to something in the dom like <div id="home"></div>. -
    - -

    Methods

    -

    .scrollspy('refresh')

    -

    When using scrollspy in conjunction with adding or removing of elements from the DOM, you'll need to call the refresh method like so:

    -
    -$('[data-spy="scroll"]').each(function () {
-  var $spy = $(this).scrollspy('refresh')
-});
-
    - -

    Options

    -

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

    - - - - - - - - - - - - - - - - - -
    Nametypedefaultdescription
    offsetnumber10Pixels to offset from top when calculating position of scroll.
    - -

    Events

    - - - - - - - - - - - - - -
    EventDescription
    activateThis event fires whenever a new item becomes activated by the scrollspy.
    -
    - - - - -
    -
    -

    Togglable tabs bootstrap-tab.js

    -
    - - -

    Example tabs

    -

    Add quick, dynamic tab functionality to transition through panes of local content, even via dropdown menus.

    -
    - -
    -
    -

    Raw denim you probably haven't heard of them jean shorts Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Mustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Cosby sweater eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan american apparel, butcher voluptate nisi qui.

    -
    -
    -

    Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.

    -
    - - -
    -
    - - -
    - - -

    Usage

    -

    Enable tabbable tabs via JavaScript (each tab needs to be activated individually):

    -
    -$('#myTab a').click(function (e) {
-  e.preventDefault();
-  $(this).tab('show');
-})
    -

    You can activate individual tabs in several ways:

    -
    -$('#myTab a[href="#profile"]').tab('show'); // Select tab by name
-$('#myTab a:first').tab('show'); // Select first tab
-$('#myTab a:last').tab('show'); // Select last tab
-$('#myTab li:eq(2) a').tab('show'); // Select third tab (0-indexed)
-
    - -

    Markup

    -

    You can activate a tab or pill navigation without writing any JavaScript by simply specifying data-toggle="tab" or data-toggle="pill" on an element. Adding the nav and nav-tabs classes to the tab ul will apply the Bootstrap tab styling.

    -
    -<ul class="nav nav-tabs">
-  <li><a href="#home" data-toggle="tab">Home</a></li>
-  <li><a href="#profile" data-toggle="tab">Profile</a></li>
-  <li><a href="#messages" data-toggle="tab">Messages</a></li>
-  <li><a href="#settings" data-toggle="tab">Settings</a></li>
-</ul>
    -

    To make tabs fade in, add .fade to each .tab-pane.

    - -

    Methods

    -

    $().tab

    -

    - Activates a tab element and content container. Tab should have either a data-target or an href targeting a container node in the DOM. -

    -
    -<ul class="nav nav-tabs" id="myTab">
-  <li class="active"><a href="#home">Home</a></li>
-  <li><a href="#profile">Profile</a></li>
-  <li><a href="#messages">Messages</a></li>
-  <li><a href="#settings">Settings</a></li>
-</ul>
-
-<div class="tab-content">
-  <div class="tab-pane active" id="home">...</div>
-  <div class="tab-pane" id="profile">...</div>
-  <div class="tab-pane" id="messages">...</div>
-  <div class="tab-pane" id="settings">...</div>
-</div>
-
-<script>
-  $(function () {
-    $('#myTab a:last').tab('show');
-  })
-</script>
-
    - -

    Events

    - - - - - - - - - - - - - - - - - -
    EventDescription
    showThis event fires on tab show, but before the new tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively.
    shownThis event fires on tab show after a tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively.
    -
    -$('a[data-toggle="tab"]').on('shown', function (e) {
-  e.target // activated tab
-  e.relatedTarget // previous tab
-})
-
    -
    - - - -
    -
    -

    Tooltips bootstrap-tooltip.js

    -
    - - -

    Examples

    -

    Inspired by the excellent jQuery.tipsy plugin written by Jason Frame; Tooltips are an updated version, which don't rely on images, use CSS3 for animations, and data-attributes for local title storage.

    -

    Hover over the links below to see tooltips:

    -
    -

    Tight pants next level keffiyeh you probably haven't heard of them. Photo booth beard raw denim letterpress vegan messenger bag stumptown. Farm-to-table seitan, mcsweeney's fixie sustainable quinoa 8-bit american apparel have a terry richardson vinyl chambray. Beard stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, four loko mcsweeney's cleanse vegan chambray. A really ironic artisan whatever keytar, scenester farm-to-table banksy Austin twitter handle freegan cred raw denim single-origin coffee viral. -

    -
    - -

    Four directions

    -
    - -
    - - -

    Tooltips in input groups

    -

    When using tooltips and popovers with the Bootstrap input groups, you'll have to set the container (documented below) option to avoid unwanted side effects.

    - -
    - - -

    Usage

    -

    Trigger the tooltip via JavaScript:

    - 
    $('#example').tooltip(options)
    - -

    Options

    -

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

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Nametypedefaultdescription
    animationbooleantrueapply a css fade transition to the tooltip
    htmlbooleanfalseInsert html into the tooltip. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks.
    placementstring | function'top'how to position the tooltip - top | bottom | left | right
    selectorstringfalseIf a selector is provided, tooltip objects will be delegated to the specified targets.
    titlestring | function''default title value if `title` tag isn't present
    triggerstring'hover focus'how tooltip is triggered - click | hover | focus | manual. Note you case pass trigger mutliple, space seperated, trigger types.
    delaynumber | object0 -

    delay showing and hiding the tooltip (ms) - does not apply to manual trigger type

    -

    If a number is supplied, delay is applied to both hide/show

    -

    Object structure is: delay: { show: 500, hide: 100 }

    -
    containerstring | falsefalse -

    Appends the tooltip to a specific element container: 'body'

    -
    -
    - Heads up! - Options for individual tooltips can alternatively be specified through the use of data attributes. -
    - -

    Markup

    - 
    <a href="#" data-toggle="tooltip" title="first tooltip">hover over me</a>
    - -

    Methods

    -

    $().tooltip(options)

    -

    Attaches a tooltip handler to an element collection.

    -

    .tooltip('show')

    -

    Reveals an element's tooltip.

    - 
    $('#element').tooltip('show')
    -

    .tooltip('hide')

    -

    Hides an element's tooltip.

    - 
    $('#element').tooltip('hide')
    -

    .tooltip('toggle')

    -

    Toggles an element's tooltip.

    - 
    $('#element').tooltip('toggle')
    -

    .tooltip('destroy')

    -

    Hides and destroys an element's tooltip.

    - 
    $('#element').tooltip('destroy')
    -
    - - - - -
    -
    -

    Popovers bootstrap-popover.js

    -
    - -

    Examples

    -

    Add small overlays of content, like those on the iPad, to any element for housing secondary information. Hover over the button to trigger the popover. Requires Tooltip to be included.

    - -

    Static popover

    -

    Four options are available: top, right, bottom, and left aligned.

    -
    -
    -
    -

    Popover top

    -
    -

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    -
    -
    - -
    -
    -

    Popover right

    -
    -

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    -
    -
    - -
    -
    -

    Popover bottom

    -
    -

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    -
    -
    - -
    -
    -

    Popover left

    -
    -

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    -
    -
    - -
    -
    -

    No markup shown as popovers are generated from JavaScript and content within a data attribute.

    - -

    Live demo

    -
    - Click to toggle popover -
    - -

    Four directions

    -
    - -
    - - -
    - - -

    Usage

    -

    Enable popovers via JavaScript:

    - 
    $('#example').popover(options)
    - -

    Options

    -

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

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Nametypedefaultdescription
    animationbooleantrueapply a css fade transition to the tooltip
    htmlbooleanfalseInsert html into the popover. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks.
    placementstring | function'right'how to position the popover - top | bottom | left | right
    selectorstringfalseif a selector is provided, tooltip objects will be delegated to the specified targets
    triggerstring'click'how popover is triggered - click | hover | focus | manual
    titlestring | function''default title value if `title` attribute isn't present
    contentstring | function''default content value if `data-content` attribute isn't present
    delaynumber | object0 -

    delay showing and hiding the popover (ms) - does not apply to manual trigger type

    -

    If a number is supplied, delay is applied to both hide/show

    -

    Object structure is: delay: { show: 500, hide: 100 }

    -
    containerstring | falsefalse -

    Appends the popover to a specific element container: 'body'

    -
    -
    - Heads up! - Options for individual popovers can alternatively be specified through the use of data attributes. -
    - -

    Markup

    -

    For performance reasons, the Tooltip and Popover data-apis are opt in. If you would like to use them just specify a selector option.

    - -

    Methods

    -

    $().popover(options)

    -

    Initializes popovers for an element collection.

    -

    .popover('show')

    -

    Reveals an elements popover.

    - 
    $('#element').popover('show')
    -

    .popover('hide')

    -

    Hides an elements popover.

    - 
    $('#element').popover('hide')
    -

    .popover('toggle')

    -

    Toggles an elements popover.

    - 
    $('#element').popover('toggle')
    -

    .popover('destroy')

    -

    Hides and destroys an element's popover.

    - 
    $('#element').popover('destroy')
    -
    - - - - -
    -
    -

    Alert messages bootstrap-alert.js

    -
    - - -

    Example alerts

    -

    Add dismiss functionality to all alert messages with this plugin.

    -
    -
    - - Holy guacamole! Best check yo self, you're not looking too good. -
    -
    - -
    -
    - -

    Oh snap! You got an error!

    -

    Change this and that and try again. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.

    -

    - Take this action Or do this -

    -
    -
    - - -
    - - -

    Usage

    -

    Enable dismissal of an alert via JavaScript:

    - 
    $(".alert").alert()
    - -

    Markup

    -

    Just add data-dismiss="alert" to your close button to automatically give an alert close functionality.

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

    Methods

    -

    $().alert()

    -

    Wraps all alerts with close functionality. To have your alerts animate out when closed, make sure they have the .fade and .in class already applied to them.

    -

    .alert('close')

    -

    Closes an alert.

    - 
    $(".alert").alert('close')
    - - -

    Events

    -

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

    - - - - - - - - - - - - - - - - - -
    EventDescription
    closeThis event fires immediately when the close instance method is called.
    closedThis event is fired when the alert has been closed (will wait for css transitions to complete).
    -
    -$('#my-alert').bind('closed', function () {
-  // do something…
-})
-
    -
    - - - - -
    -
    -

    Buttons bootstrap-button.js

    -
    - -

    Example uses

    -

    Do more with buttons. Control button states or create groups of buttons for more components like toolbars.

    - -

    Stateful

    -

    Add data-loading-text="Loading..." to use a loading state on a button.

    -
    - -
    - 
    <button type="button" class="btn btn-primary" data-loading-text="Loading...">Loading state</button>
    - -

    Single toggle

    -

    Add data-toggle="button" to activate toggling on a single button.

    -
    - -
    - 
    <button type="button" class="btn btn-primary" data-toggle="button">Single Toggle</button>
    - -

    Checkbox

    -

    Add data-toggle="buttons-checkbox" for checkbox style toggling on btn-group.

    -
    -
    - - - -
    -
    -
    -<div class="btn-group" data-toggle="buttons-checkbox">
-  <button type="button" class="btn btn-primary">Left</button>
-  <button type="button" class="btn btn-primary">Middle</button>
-  <button type="button" class="btn btn-primary">Right</button>
-</div>
-
    - -

    Radio

    -

    Add data-toggle="buttons-radio" for radio style toggling on btn-group.

    -
    -
    - - - -
    -
    -
    -<div class="btn-group" data-toggle="buttons-radio">
-  <button type="button" class="btn btn-primary">Left</button>
-  <button type="button" class="btn btn-primary">Middle</button>
-  <button type="button" class="btn btn-primary">Right</button>
-</div>
-
    - - -
    - - -

    Usage

    -

    Enable buttons via JavaScript:

    - 
    $('.nav-tabs').button()
    - -

    Markup

    -

    Data attributes are integral to the button plugin. Check out the example code below for the various markup types.

    - -

    Options

    -

    None

    - -

    Methods

    -

    $().button('toggle')

    -

    Toggles push state. Gives the button the appearance that it has been activated.

    -
    - Heads up! - You can enable auto toggling of a button by using the data-toggle attribute. -
    - 
    <button type="button" class="btn" data-toggle="button" >…</button>
    -

    $().button('loading')

    -

    Sets button state to loading - disables button and swaps text to loading text. Loading text should be defined on the button element using the data attribute data-loading-text. -

    - 
    <button type="button" class="btn" data-loading-text="loading stuff..." >...</button>
    -
    - Heads up! - Firefox persists the disabled state across page loads. A workaround for this is to use autocomplete="off". -
    -

    $().button('reset')

    -

    Resets button state - swaps text to original text.

    -

    $().button(string)

    -

    Resets button state - swaps text to any data defined text state.

    -
    <button type="button" class="btn" data-complete-text="finished!" >...</button>
-<script>
-  $('.btn').button('complete')
-</script>
-
    -
    - - - - -
    -
    -

    Collapse bootstrap-collapse.js

    -
    - -

    About

    -

    Get base styles and flexible support for collapsible components like accordions and navigation.

    -

    * Requires the Transitions plugin to be included.

    - -

    Example accordion

    -

    Using the collapse plugin, we built a simple accordion style widget:

    - -
    -
    -
    -
    - - Collapsible Group Item #1 - -
    -
    -
    - Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS. -
    -
    -
    -
    -
    - - Collapsible Group Item #2 - -
    -
    -
    - Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS. -
    -
    -
    -
    -
    - - Collapsible Group Item #3 - -
    -
    -
    - Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS. -
    -
    -
    -
    -
    -
    -<div class="accordion" id="accordion2">
-  <div class="accordion-group">
-    <div class="accordion-heading">
-      <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion2" href="#collapseOne">
-        Collapsible Group Item #1
-      </a>
-    </div>
-    <div id="collapseOne" class="accordion-body collapse in">
-      <div class="accordion-inner">
-        Anim pariatur cliche...
-      </div>
-    </div>
-  </div>
-  <div class="accordion-group">
-    <div class="accordion-heading">
-      <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion2" href="#collapseTwo">
-        Collapsible Group Item #2
-      </a>
-    </div>
-    <div id="collapseTwo" class="accordion-body collapse">
-      <div class="accordion-inner">
-        Anim pariatur cliche...
-      </div>
-    </div>
-  </div>
-</div>
-...
-
    -

    You can also use the plugin without the accordion markup. Make a button toggle the expanding and collapsing of another element.

    -
    -<button type="button" class="btn btn-danger" data-toggle="collapse" data-target="#demo">
-  simple collapsible
-</button>
-
-<div id="demo" class="collapse in"> … </div>
-
    - - -
    - - -

    Usage

    - -

    Via data attributes

    -

    Just add data-toggle="collapse" and a data-target to element to automatically assign control of a collapsible element. The data-target attribute accepts a css selector to apply the collapse to. Be sure to add the class collapse to the collapsible element. If you'd like it to default open, add the additional class in.

    -

    To add accordion-like group management to a collapsible control, add the data attribute data-parent="#selector". Refer to the demo to see this in action.

    - -

    Via JavaScript

    -

    Enable manually with:

    - 
    $(".collapse").collapse()
    - -

    Options

    -

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

    - - - - - - - - - - - - - - - - - - - - - - - -
    Nametypedefaultdescription
    parentselectorfalseIf selector then all collapsible elements under the specified parent will be closed when this collapsible item is shown. (similar to traditional accordion behavior)
    togglebooleantrueToggles the collapsible element on invocation
    - - -

    Methods

    -

    .collapse(options)

    -

    Activates your content as a collapsible element. Accepts an optional options object. -

    -$('#myCollapsible').collapse({
-  toggle: false
-})
-
    -

    .collapse('toggle')

    -

    Toggles a collapsible element to shown or hidden.

    -

    .collapse('show')

    -

    Shows a collapsible element.

    -

    .collapse('hide')

    -

    Hides a collapsible element.

    - -

    Events

    -

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

    - - - - - - - - - - - - - - - - - - - - - - - - - -
    EventDescription
    showThis event fires immediately when the show instance method is called.
    shownThis event is fired when a collapse element has been made visible to the user (will wait for css transitions to complete).
    hide - This event is fired immediately when the hide method has been called. -
    hiddenThis event is fired when a collapse element has been hidden from the user (will wait for css transitions to complete).
    -
    -$('#myCollapsible').on('hidden', function () {
-  // do something…
-})
    -
    - - - - - - - - - -
    -
    -

    Typeahead bootstrap-typeahead.js

    -
    - - -

    Example

    -

    A basic, easily extended plugin for quickly creating elegant typeaheads with any form text input.

    -
    - -
    - 
    <input type="text" data-provide="typeahead">
    -

    You'll want to set autocomplete="off" to prevent default browser menus from appearing over the Bootstrap typeahead dropdown.

    - -
    - - -

    Usage

    - -

    Via data attributes

    -

    Add data attributes to register an element with typeahead functionality as shown in the example above.

    - -

    Via JavaScript

    -

    Call the typeahead manually with:

    - 
    $('.typeahead').typeahead()
    - -

    Options

    -

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

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Nametypedefaultdescription
    sourcearray, function[ ]The data source to query against. May be an array of strings or a function. The function is passed two arguments, the query value in the input field and the process callback. The function may be used synchronously by returning the data source directly or asynchronously via the process callback's single argument.
    itemsnumber8The max number of items to display in the dropdown.
    minLengthnumber1The minimum character length needed before triggering autocomplete suggestions
    matcherfunctioncase insensitiveThe method used to determine if a query matches an item. Accepts a single argument, the item against which to test the query. Access the current query with this.query. Return a boolean true if query is a match.
    sorterfunctionexact match,
    case sensitive,
    case insensitive    		Method used to sort autocomplete results. Accepts a single argument items and has the scope of the typeahead instance. Reference the current query with this.query.
    updaterfunctionreturns selected itemThe method used to return selected item. Accepts a single argument, the item and has the scope of the typeahead instance.
    highlighterfunctionhighlights all default matchesMethod used to highlight autocomplete results. Accepts a single argument item and has the scope of the typeahead instance. Should return html.
    - -

    Methods

    -

    .typeahead(options)

    -

    Initializes an input with a typeahead.

    -
    - - - - -
    -
    -

    Affix bootstrap-affix.js

    -
    - -

    Example

    -

    The subnavigation on the left is a live demo of the affix plugin.

    - -
    - -

    Usage

    - -

    Via data attributes

    -

    To easily add affix behavior to any element, just add data-spy="affix" to the element you want to spy on. Then use offsets to define when to toggle the pinning of an element on and off.

    - - 
    <div data-spy="affix" data-offset-top="200">...</div>
    - -
    - Heads up! - You must manage the position of a pinned element and the behavior of its immediate parent. Position is controlled by affix, affix-top, and affix-bottom. Remember to check for a potentially collapsed parent when the affix kicks in as it's removing content from the normal flow of the page. -
    - -

    Via JavaScript

    -

    Call the affix plugin via JavaScript:

    - 
    $('#navbar').affix()
    - -

    Methods

    -

    .affix('refresh')

    -

    When using affix in conjunction with adding or removing of elements from the DOM, you'll want to call the refresh method:

    -
    -$('[data-spy="affix"]').each(function () {
-  $(this).affix('refresh')
-});
-
    -

    Options

    -

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

    - - - - - - - - - - - - - - - - - - -
    Nametypedefaultdescription
    offsetnumber | function | object10Pixels to offset from screen when calculating position of scroll. If a single number is provided, the offset will be applied in both top and left directions. To listen for a single direction, or multiple unique offsets, just provide an object offset: { x: 10 }. Use a function when you need to dynamically provide an offset (useful for some responsive designs).
    -
    - - - -
    -
    - -
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -- cgit v1.2.3 From e45f12ad427fddc9d9859fe86423bd49795d4f43 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Tue, 12 Feb 2013 12:44:41 -0800 Subject: rearrange jekyll and docs --- docs/javascript.html | 1699 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 1699 insertions(+) create mode 100644 docs/javascript.html (limited to 'docs/javascript.html') diff --git a/docs/javascript.html b/docs/javascript.html new file mode 100644 index 000000000..4dfd18c6b --- /dev/null +++ b/docs/javascript.html @@ -0,0 +1,1699 @@ +--- +layout: default +title: JavaScript plugins +--- + + +
    +
    +

    JavaScript

    +

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

    +
    + +
    + + +
    +
    + +
    +
    + + + +
    +
    +

    JavaScript in Bootstrap

    +
    + +

    Individual or compiled

    +

    Plugins can be included individually (though some have required dependencies), or all at once. 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: + 

    $('body').off('.data-api')
    + +

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

    + 
    $('body').off('.alert.data-api')
    + +

    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.

    + 
    $(".btn.danger").button("toggle").addClass("fat")
    +

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

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

    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.

    + +
    +var bootstrapButton = $.fn.button.noConflict() // return $.fn.button to previously assigned value
+$.fn.bootstrapBtn = bootstrapButton            // give $().bootstrapBtn the bootstrap functionality
+
    + +

    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.

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

    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

    +
    + + +

    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 +
    +
    +
    +
    + +
    +
    +<div class="modal fade">
+  <div class="modal-dialog">
+    <div class="modal-content">
+
+      <div class="modal-header">
+        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
+        <h4 class="modal-title">Modal title</h4>
+      </div>
+      <div class="modal-body">
+        <p>One fine body…</p>
+      </div>
+      <div class="modal-footer">
+        <a href="#" class="btn">Close</a>
+        <a href="#" class="btn btn-primary">Save changes</a>
+      </div>
+
+    </div>
+  </div>
+</div>
+
    + +

    Live demo

    +

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

    + + + +
    + Launch demo modal +
    +
    +<!-- Button to trigger modal -->
+<a href="#myModal" role="button" class="btn" data-toggle="modal">Launch demo modal</a>
+
+<!-- Modal -->
+<div id="myModal" class="modal fade" tabindex="-1" role="dialog" aria-labelledby="myModalLabel" aria-hidden="true">
+  <div class="modal-dialog">
+    <div class="modal-content">
+
+      <div class="modal-header">
+        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
+        <h4 class="modal-title">Modal title</h4>
+      </div>
+      <div class="modal-body">
+        ...
+      </div>
+      <div class="modal-footer">
+        <a href="#" class="btn">Close</a>
+        <a href="#" class="btn btn-primary">Save changes</a>
+      </div>
+
+    </div>
+  </div>
+</div>
+
    + + +

    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.

    + 
    <button type="button" data-toggle="modal" data-target="#myModal">Launch modal</button>
    + +

    Via JavaScript

    +

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

    + 
    $('#myModal').modal(options)
    + +

    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:

    + 
    <a data-toggle="modal" href="remote.html" data-target="#modal">click me</a>
    + +

    Methods

    +

    .modal(options)

    +

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

    +
    +$('#myModal').modal({
+  keyboard: false
+})
+
    +

    .modal('toggle')

    +

    Manually toggles a modal.

    + 
    $('#myModal').modal('toggle')
    +

    .modal('show')

    +

    Manually opens a modal.

    + 
    $('#myModal').modal('show')
    +

    .modal('hide')

    +

    Manually hides a modal.

    + 
    $('#myModal').modal('hide')
    +

    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).
    +
    +$('#myModal').on('hidden', function () {
+  // do something…
+})
+
    +
    + + + + + + + + + +
    +
    +

    ScrollSpy bootstrap-scrollspy.js

    +
    + + +

    Example in navbar

    +

    The ScrollSpy plugin is for automatically updating nav targets based on scroll position. Scroll the area below the navbar and watch the active class change. The dropdown sub items will be highlighted as well.

    +
    + +
    +

    @fat

    +

    Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.

    +

    @mdo

    +

    Veniam marfa mustache skateboard, adipisicing fugiat velit pitchfork beard. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. Tattooed cosby sweater food truck, mcsweeney's quis non freegan vinyl. Lo-fi wes anderson +1 sartorial. Carles non aesthetic exercitation quis gentrify. Brooklyn adipisicing craft beer vice keytar deserunt.

    +

    one

    +

    Occaecat commodo aliqua delectus. Fap craft beer deserunt skateboard ea. Lomo bicycle rights adipisicing banh mi, velit ea sunt next level locavore single-origin coffee in magna veniam. High life id vinyl, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi DIY minim messenger bag. Cred ex in, sustainable delectus consectetur fanny pack iphone.

    +

    two

    +

    In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.

    +

    three

    +

    Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.

    +

    Keytar twee blog, culpa messenger bag marfa whatever delectus food truck. Sapiente synth id assumenda. Locavore sed helvetica cliche irony, thundercats you probably haven't heard of them consequat hoodie gluten-free lo-fi fap aliquip. Labore elit placeat before they sold out, terry richardson proident brunch nesciunt quis cosby sweater pariatur keffiyeh ut helvetica artisan. Cardigan craft beer seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats. +

    +
    +
    + + +
    + + +

    Usage

    + +

    Via data attributes

    +

    To easily add scrollspy behavior to your topbar navigation, just add data-spy="scroll" to the element you want to spy on (most typically this would be the body) and data-target=".navbar" to select which nav to use. You'll want to use scrollspy with a .nav component.

    + 
    <body data-spy="scroll" data-target=".navbar">...</body>
    + +

    Via JavaScript

    +

    Call the scrollspy via JavaScript:

    + 
    $('#navbar').scrollspy()
    + +
    + Heads up! + Navbar links must have resolvable id targets. For example, a <a href="#home">home</a> must correspond to something in the dom like <div id="home"></div>. +
    + +

    Methods

    +

    .scrollspy('refresh')

    +

    When using scrollspy in conjunction with adding or removing of elements from the DOM, you'll need to call the refresh method like so:

    +
    +$('[data-spy="scroll"]').each(function () {
+  var $spy = $(this).scrollspy('refresh')
+});
+
    + +

    Options

    +

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

    + + + + + + + + + + + + + + + + + +
    Nametypedefaultdescription
    offsetnumber10Pixels to offset from top when calculating position of scroll.
    + +

    Events

    + + + + + + + + + + + + + +
    EventDescription
    activateThis event fires whenever a new item becomes activated by the scrollspy.
    +
    + + + + +
    +
    +

    Togglable tabs bootstrap-tab.js

    +
    + + +

    Example tabs

    +

    Add quick, dynamic tab functionality to transition through panes of local content, even via dropdown menus.

    +
    + +
    +
    +

    Raw denim you probably haven't heard of them jean shorts Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Mustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Cosby sweater eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan american apparel, butcher voluptate nisi qui.

    +
    +
    +

    Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.

    +
    + + +
    +
    + + +
    + + +

    Usage

    +

    Enable tabbable tabs via JavaScript (each tab needs to be activated individually):

    +
    +$('#myTab a').click(function (e) {
+  e.preventDefault();
+  $(this).tab('show');
+})
    +

    You can activate individual tabs in several ways:

    +
    +$('#myTab a[href="#profile"]').tab('show'); // Select tab by name
+$('#myTab a:first').tab('show'); // Select first tab
+$('#myTab a:last').tab('show'); // Select last tab
+$('#myTab li:eq(2) a').tab('show'); // Select third tab (0-indexed)
+
    + +

    Markup

    +

    You can activate a tab or pill navigation without writing any JavaScript by simply specifying data-toggle="tab" or data-toggle="pill" on an element. Adding the nav and nav-tabs classes to the tab ul will apply the Bootstrap tab styling.

    +
    +<ul class="nav nav-tabs">
+  <li><a href="#home" data-toggle="tab">Home</a></li>
+  <li><a href="#profile" data-toggle="tab">Profile</a></li>
+  <li><a href="#messages" data-toggle="tab">Messages</a></li>
+  <li><a href="#settings" data-toggle="tab">Settings</a></li>
+</ul>
    +

    To make tabs fade in, add .fade to each .tab-pane.

    + +

    Methods

    +

    $().tab

    +

    + Activates a tab element and content container. Tab should have either a data-target or an href targeting a container node in the DOM. +

    +
    +<ul class="nav nav-tabs" id="myTab">
+  <li class="active"><a href="#home">Home</a></li>
+  <li><a href="#profile">Profile</a></li>
+  <li><a href="#messages">Messages</a></li>
+  <li><a href="#settings">Settings</a></li>
+</ul>
+
+<div class="tab-content">
+  <div class="tab-pane active" id="home">...</div>
+  <div class="tab-pane" id="profile">...</div>
+  <div class="tab-pane" id="messages">...</div>
+  <div class="tab-pane" id="settings">...</div>
+</div>
+
+<script>
+  $(function () {
+    $('#myTab a:last').tab('show');
+  })
+</script>
+
    + +

    Events

    + + + + + + + + + + + + + + + + + +
    EventDescription
    showThis event fires on tab show, but before the new tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively.
    shownThis event fires on tab show after a tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively.
    +
    +$('a[data-toggle="tab"]').on('shown', function (e) {
+  e.target // activated tab
+  e.relatedTarget // previous tab
+})
+
    +
    + + + +
    +
    +

    Tooltips bootstrap-tooltip.js

    +
    + + +

    Examples

    +

    Inspired by the excellent jQuery.tipsy plugin written by Jason Frame; Tooltips are an updated version, which don't rely on images, use CSS3 for animations, and data-attributes for local title storage.

    +

    Hover over the links below to see tooltips:

    +
    +

    Tight pants next level keffiyeh you probably haven't heard of them. Photo booth beard raw denim letterpress vegan messenger bag stumptown. Farm-to-table seitan, mcsweeney's fixie sustainable quinoa 8-bit american apparel have a terry richardson vinyl chambray. Beard stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, four loko mcsweeney's cleanse vegan chambray. A really ironic artisan whatever keytar, scenester farm-to-table banksy Austin twitter handle freegan cred raw denim single-origin coffee viral. +

    +
    + +

    Four directions

    +
    + +
    + + +

    Tooltips in input groups

    +

    When using tooltips and popovers with the Bootstrap input groups, you'll have to set the container (documented below) option to avoid unwanted side effects.

    + +
    + + +

    Usage

    +

    Trigger the tooltip via JavaScript:

    + 
    $('#example').tooltip(options)
    + +

    Options

    +

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

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Nametypedefaultdescription
    animationbooleantrueapply a css fade transition to the tooltip
    htmlbooleanfalseInsert html into the tooltip. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks.
    placementstring | function'top'how to position the tooltip - top | bottom | left | right
    selectorstringfalseIf a selector is provided, tooltip objects will be delegated to the specified targets.
    titlestring | function''default title value if `title` tag isn't present
    triggerstring'hover focus'how tooltip is triggered - click | hover | focus | manual. Note you case pass trigger mutliple, space seperated, trigger types.
    delaynumber | object0 +

    delay showing and hiding the tooltip (ms) - does not apply to manual trigger type

    +

    If a number is supplied, delay is applied to both hide/show

    +

    Object structure is: delay: { show: 500, hide: 100 }

    +
    containerstring | falsefalse +

    Appends the tooltip to a specific element container: 'body'

    +
    +
    + Heads up! + Options for individual tooltips can alternatively be specified through the use of data attributes. +
    + +

    Markup

    + 
    <a href="#" data-toggle="tooltip" title="first tooltip">hover over me</a>
    + +

    Methods

    +

    $().tooltip(options)

    +

    Attaches a tooltip handler to an element collection.

    +

    .tooltip('show')

    +

    Reveals an element's tooltip.

    + 
    $('#element').tooltip('show')
    +

    .tooltip('hide')

    +

    Hides an element's tooltip.

    + 
    $('#element').tooltip('hide')
    +

    .tooltip('toggle')

    +

    Toggles an element's tooltip.

    + 
    $('#element').tooltip('toggle')
    +

    .tooltip('destroy')

    +

    Hides and destroys an element's tooltip.

    + 
    $('#element').tooltip('destroy')
    +
    + + + + +
    +
    +

    Popovers bootstrap-popover.js

    +
    + +

    Examples

    +

    Add small overlays of content, like those on the iPad, to any element for housing secondary information. Hover over the button to trigger the popover. Requires Tooltip to be included.

    + +

    Static popover

    +

    Four options are available: top, right, bottom, and left aligned.

    +
    +
    +
    +

    Popover top

    +
    +

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    +
    +
    + +
    +
    +

    Popover right

    +
    +

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    +
    +
    + +
    +
    +

    Popover bottom

    +
    +

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    +
    +
    + +
    +
    +

    Popover left

    +
    +

    Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

    +
    +
    + +
    +
    +

    No markup shown as popovers are generated from JavaScript and content within a data attribute.

    + +

    Live demo

    +
    + Click to toggle popover +
    + +

    Four directions

    +
    + +
    + + +
    + + +

    Usage

    +

    Enable popovers via JavaScript:

    + 
    $('#example').popover(options)
    + +

    Options

    +

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

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Nametypedefaultdescription
    animationbooleantrueapply a css fade transition to the tooltip
    htmlbooleanfalseInsert html into the popover. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks.
    placementstring | function'right'how to position the popover - top | bottom | left | right
    selectorstringfalseif a selector is provided, tooltip objects will be delegated to the specified targets
    triggerstring'click'how popover is triggered - click | hover | focus | manual
    titlestring | function''default title value if `title` attribute isn't present
    contentstring | function''default content value if `data-content` attribute isn't present
    delaynumber | object0 +

    delay showing and hiding the popover (ms) - does not apply to manual trigger type

    +

    If a number is supplied, delay is applied to both hide/show

    +

    Object structure is: delay: { show: 500, hide: 100 }

    +
    containerstring | falsefalse +

    Appends the popover to a specific element container: 'body'

    +
    +
    + Heads up! + Options for individual popovers can alternatively be specified through the use of data attributes. +
    + +

    Markup

    +

    For performance reasons, the Tooltip and Popover data-apis are opt in. If you would like to use them just specify a selector option.

    + +

    Methods

    +

    $().popover(options)

    +

    Initializes popovers for an element collection.

    +

    .popover('show')

    +

    Reveals an elements popover.

    + 
    $('#element').popover('show')
    +

    .popover('hide')

    +

    Hides an elements popover.

    + 
    $('#element').popover('hide')
    +

    .popover('toggle')

    +

    Toggles an elements popover.

    + 
    $('#element').popover('toggle')
    +

    .popover('destroy')

    +

    Hides and destroys an element's popover.

    + 
    $('#element').popover('destroy')
    +
    + + + + +
    +
    +

    Alert messages bootstrap-alert.js

    +
    + + +

    Example alerts

    +

    Add dismiss functionality to all alert messages with this plugin.

    +
    +
    + + Holy guacamole! Best check yo self, you're not looking too good. +
    +
    + +
    +
    + +

    Oh snap! You got an error!

    +

    Change this and that and try again. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.

    +

    + Take this action Or do this +

    +
    +
    + + +
    + + +

    Usage

    +

    Enable dismissal of an alert via JavaScript:

    + 
    $(".alert").alert()
    + +

    Markup

    +

    Just add data-dismiss="alert" to your close button to automatically give an alert close functionality.

    + 
    <a class="close" data-dismiss="alert" href="#">&times;</a>
    + +

    Methods

    +

    $().alert()

    +

    Wraps all alerts with close functionality. To have your alerts animate out when closed, make sure they have the .fade and .in class already applied to them.

    +

    .alert('close')

    +

    Closes an alert.

    + 
    $(".alert").alert('close')
    + + +

    Events

    +

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

    + + + + + + + + + + + + + + + + + +
    EventDescription
    closeThis event fires immediately when the close instance method is called.
    closedThis event is fired when the alert has been closed (will wait for css transitions to complete).
    +
    +$('#my-alert').bind('closed', function () {
+  // do something…
+})
+
    +
    + + + + +
    +
    +

    Buttons bootstrap-button.js

    +
    + +

    Example uses

    +

    Do more with buttons. Control button states or create groups of buttons for more components like toolbars.

    + +

    Stateful

    +

    Add data-loading-text="Loading..." to use a loading state on a button.

    +
    + +
    + 
    <button type="button" class="btn btn-primary" data-loading-text="Loading...">Loading state</button>
    + +

    Single toggle

    +

    Add data-toggle="button" to activate toggling on a single button.

    +
    + +
    + 
    <button type="button" class="btn btn-primary" data-toggle="button">Single Toggle</button>
    + +

    Checkbox

    +

    Add data-toggle="buttons-checkbox" for checkbox style toggling on btn-group.

    +
    +
    + + + +
    +
    +
    +<div class="btn-group" data-toggle="buttons-checkbox">
+  <button type="button" class="btn btn-primary">Left</button>
+  <button type="button" class="btn btn-primary">Middle</button>
+  <button type="button" class="btn btn-primary">Right</button>
+</div>
+
    + +

    Radio

    +

    Add data-toggle="buttons-radio" for radio style toggling on btn-group.

    +
    +
    + + + +
    +
    +
    +<div class="btn-group" data-toggle="buttons-radio">
+  <button type="button" class="btn btn-primary">Left</button>
+  <button type="button" class="btn btn-primary">Middle</button>
+  <button type="button" class="btn btn-primary">Right</button>
+</div>
+
    + + +
    + + +

    Usage

    +

    Enable buttons via JavaScript:

    + 
    $('.nav-tabs').button()
    + +

    Markup

    +

    Data attributes are integral to the button plugin. Check out the example code below for the various markup types.

    + +

    Options

    +

    None

    + +

    Methods

    +

    $().button('toggle')

    +

    Toggles push state. Gives the button the appearance that it has been activated.

    +
    + Heads up! + You can enable auto toggling of a button by using the data-toggle attribute. +
    + 
    <button type="button" class="btn" data-toggle="button" >…</button>
    +

    $().button('loading')

    +

    Sets button state to loading - disables button and swaps text to loading text. Loading text should be defined on the button element using the data attribute data-loading-text. +

    + 
    <button type="button" class="btn" data-loading-text="loading stuff..." >...</button>
    +
    + Heads up! + Firefox persists the disabled state across page loads. A workaround for this is to use autocomplete="off". +
    +

    $().button('reset')

    +

    Resets button state - swaps text to original text.

    +

    $().button(string)

    +

    Resets button state - swaps text to any data defined text state.

    +
    <button type="button" class="btn" data-complete-text="finished!" >...</button>
+<script>
+  $('.btn').button('complete')
+</script>
+
    +
    + + + + +
    +
    +

    Collapse bootstrap-collapse.js

    +
    + +

    About

    +

    Get base styles and flexible support for collapsible components like accordions and navigation.

    +

    * Requires the Transitions plugin to be included.

    + +

    Example accordion

    +

    Using the collapse plugin, we built a simple accordion style widget:

    + +
    +
    +
    +
    + + Collapsible Group Item #1 + +
    +
    +
    + Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS. +
    +
    +
    +
    +
    + + Collapsible Group Item #2 + +
    +
    +
    + Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS. +
    +
    +
    +
    +
    + + Collapsible Group Item #3 + +
    +
    +
    + Anim pariatur cliche reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, non cupidatat skateboard dolor brunch. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua put a bird on it squid single-origin coffee nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, craft beer labore wes anderson cred nesciunt sapiente ea proident. Ad vegan excepteur butcher vice lomo. Leggings occaecat craft beer farm-to-table, raw denim aesthetic synth nesciunt you probably haven't heard of them accusamus labore sustainable VHS. +
    +
    +
    +
    +
    +
    +<div class="accordion" id="accordion2">
+  <div class="accordion-group">
+    <div class="accordion-heading">
+      <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion2" href="#collapseOne">
+        Collapsible Group Item #1
+      </a>
+    </div>
+    <div id="collapseOne" class="accordion-body collapse in">
+      <div class="accordion-inner">
+        Anim pariatur cliche...
+      </div>
+    </div>
+  </div>
+  <div class="accordion-group">
+    <div class="accordion-heading">
+      <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion2" href="#collapseTwo">
+        Collapsible Group Item #2
+      </a>
+    </div>
+    <div id="collapseTwo" class="accordion-body collapse">
+      <div class="accordion-inner">
+        Anim pariatur cliche...
+      </div>
+    </div>
+  </div>
+</div>
+...
+
    +

    You can also use the plugin without the accordion markup. Make a button toggle the expanding and collapsing of another element.

    +
    +<button type="button" class="btn btn-danger" data-toggle="collapse" data-target="#demo">
+  simple collapsible
+</button>
+
+<div id="demo" class="collapse in"> … </div>
+
    + + +
    + + +

    Usage

    + +

    Via data attributes

    +

    Just add data-toggle="collapse" and a data-target to element to automatically assign control of a collapsible element. The data-target attribute accepts a css selector to apply the collapse to. Be sure to add the class collapse to the collapsible element. If you'd like it to default open, add the additional class in.

    +

    To add accordion-like group management to a collapsible control, add the data attribute data-parent="#selector". Refer to the demo to see this in action.

    + +

    Via JavaScript

    +

    Enable manually with:

    + 
    $(".collapse").collapse()
    + +

    Options

    +

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

    + + + + + + + + + + + + + + + + + + + + + + + +
    Nametypedefaultdescription
    parentselectorfalseIf selector then all collapsible elements under the specified parent will be closed when this collapsible item is shown. (similar to traditional accordion behavior)
    togglebooleantrueToggles the collapsible element on invocation
    + + +

    Methods

    +

    .collapse(options)

    +

    Activates your content as a collapsible element. Accepts an optional options object. +

    +$('#myCollapsible').collapse({
+  toggle: false
+})
+
    +

    .collapse('toggle')

    +

    Toggles a collapsible element to shown or hidden.

    +

    .collapse('show')

    +

    Shows a collapsible element.

    +

    .collapse('hide')

    +

    Hides a collapsible element.

    + +

    Events

    +

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

    + + + + + + + + + + + + + + + + + + + + + + + + + +
    EventDescription
    showThis event fires immediately when the show instance method is called.
    shownThis event is fired when a collapse element has been made visible to the user (will wait for css transitions to complete).
    hide + This event is fired immediately when the hide method has been called. +
    hiddenThis event is fired when a collapse element has been hidden from the user (will wait for css transitions to complete).
    +
    +$('#myCollapsible').on('hidden', function () {
+  // do something…
+})
    +
    + + + + + + + + + +
    +
    +

    Typeahead bootstrap-typeahead.js

    +
    + + +

    Example

    +

    A basic, easily extended plugin for quickly creating elegant typeaheads with any form text input.

    +
    + +
    + 
    <input type="text" data-provide="typeahead">
    +

    You'll want to set autocomplete="off" to prevent default browser menus from appearing over the Bootstrap typeahead dropdown.

    + +
    + + +

    Usage

    + +

    Via data attributes

    +

    Add data attributes to register an element with typeahead functionality as shown in the example above.

    + +

    Via JavaScript

    +

    Call the typeahead manually with:

    + 
    $('.typeahead').typeahead()
    + +

    Options

    +

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

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Nametypedefaultdescription
    sourcearray, function[ ]The data source to query against. May be an array of strings or a function. The function is passed two arguments, the query value in the input field and the process callback. The function may be used synchronously by returning the data source directly or asynchronously via the process callback's single argument.
    itemsnumber8The max number of items to display in the dropdown.
    minLengthnumber1The minimum character length needed before triggering autocomplete suggestions
    matcherfunctioncase insensitiveThe method used to determine if a query matches an item. Accepts a single argument, the item against which to test the query. Access the current query with this.query. Return a boolean true if query is a match.
    sorterfunctionexact match,
    case sensitive,
    case insensitive    		Method used to sort autocomplete results. Accepts a single argument items and has the scope of the typeahead instance. Reference the current query with this.query.
    updaterfunctionreturns selected itemThe method used to return selected item. Accepts a single argument, the item and has the scope of the typeahead instance.
    highlighterfunctionhighlights all default matchesMethod used to highlight autocomplete results. Accepts a single argument item and has the scope of the typeahead instance. Should return html.
    + +

    Methods

    +

    .typeahead(options)

    +

    Initializes an input with a typeahead.

    +
    + + + + +
    +
    +

    Affix bootstrap-affix.js

    +
    + +

    Example

    +

    The subnavigation on the left is a live demo of the affix plugin.

    + +
    + +

    Usage

    + +

    Via data attributes

    +

    To easily add affix behavior to any element, just add data-spy="affix" to the element you want to spy on. Then use offsets to define when to toggle the pinning of an element on and off.

    + + 
    <div data-spy="affix" data-offset-top="200">...</div>
    + +
    + Heads up! + You must manage the position of a pinned element and the behavior of its immediate parent. Position is controlled by affix, affix-top, and affix-bottom. Remember to check for a potentially collapsed parent when the affix kicks in as it's removing content from the normal flow of the page. +
    + +

    Via JavaScript

    +

    Call the affix plugin via JavaScript:

    + 
    $('#navbar').affix()
    + +

    Methods

    +

    .affix('refresh')

    +

    When using affix in conjunction with adding or removing of elements from the DOM, you'll want to call the refresh method:

    +
    +$('[data-spy="affix"]').each(function () {
+  $(this).affix('refresh')
+});
+
    +

    Options

    +

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

    + + + + + + + + + + + + + + + + + + +
    Nametypedefaultdescription
    offsetnumber | function | object10Pixels to offset from screen when calculating position of scroll. If a single number is provided, the offset will be applied in both top and left directions. To listen for a single direction, or multiple unique offsets, just provide an object offset: { x: 10 }. Use a function when you need to dynamically provide an offset (useful for some responsive designs).
    +
    + + + +
    +
    + +
    -- cgit v1.2.3 From 979ca4ea7a2e88fd9bbd8051259cd2803ca5088d Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Thu, 14 Feb 2013 22:33:26 -0800 Subject: Convert JS page to pygments; nuke prettify assets --- docs/javascript.html | 556 ++++++++++++++++++++++++++++++--------------------- 1 file changed, 331 insertions(+), 225 deletions(-) (limited to 'docs/javascript.html') diff --git a/docs/javascript.html b/docs/javascript.html index 4dfd18c6b..e6ff65eaf 100644 --- a/docs/javascript.html +++ b/docs/javascript.html @@ -52,38 +52,47 @@ title: JavaScript plugins

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

    $('body').off('.data-api')
    +{% 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:

    - 
    $('body').off('.alert.data-api')
    +{% 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.

    - 
    $(".btn.danger").button("toggle").addClass("fat")
    +{% 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):

    -
    -$("#myModal").modal()                       // initialized with defaults
+{% 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').

    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.

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

    Static example

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

    -
    @@ -142,29 +150,26 @@ $('#myModal').on('show', function (e) {
    -
    -
    -<div class="modal fade">
-  <div class="modal-dialog">
-    <div class="modal-content">
-
-      <div class="modal-header">
-        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
-        <h4 class="modal-title">Modal title</h4>
-      </div>
-      <div class="modal-body">
-        <p>One fine body…</p>
-      </div>
-      <div class="modal-footer">
-        <a href="#" class="btn">Close</a>
-        <a href="#" class="btn btn-primary">Save changes</a>
-      </div>
-
-    </div>
-  </div>
-</div>
-
    +{% highlight html linenos %} +
    +
    +
    +
    + +

    Modal title

    +
    +
    +

    One fine body…

    +
    +
    + Close + Save changes +
    +
    +
    +
    +{% 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.

    @@ -209,42 +214,43 @@ $('#myModal').on('show', function (e) {
    Launch demo modal
    -
    -<!-- Button to trigger modal -->
-<a href="#myModal" role="button" class="btn" data-toggle="modal">Launch demo modal</a>
-
-<!-- Modal -->
-<div id="myModal" class="modal fade" tabindex="-1" role="dialog" aria-labelledby="myModalLabel" aria-hidden="true">
-  <div class="modal-dialog">
-    <div class="modal-content">
-
-      <div class="modal-header">
-        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
-        <h4 class="modal-title">Modal title</h4>
-      </div>
-      <div class="modal-body">
+{% highlight html linenos %}
+
    
+  
+  Launch demo modal
+
+  
+  
    
+    
    
+      
    
+        
+        
    Modal title
    
+      
    
+      
    
         ...
-      </div>
-      <div class="modal-footer">
-        <a href="#" class="btn">Close</a>
-        <a href="#" class="btn btn-primary">Save changes</a>
-      </div>
+      
    
+      
    
+        Close
+        Save changes
+      
    
+    
    
+  
    
+
    
+{% endhighlight %}
 
-    </div>
-  </div>
-</div>
-

    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.

    - 
    <button type="button" data-toggle="modal" data-target="#myModal">Launch modal</button>
    +{% highlight html linenos %} + +{% endhighlight %}

    Via JavaScript

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

    - 
    $('#myModal').modal(options)
    + {% 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="".

    @@ -281,28 +287,35 @@ $('#myModal').on('show', function (e) { path false

    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:

    - 
    <a data-toggle="modal" href="remote.html" data-target="#modal">click me</a>
    +{% highlight html linenos %} +Click me +{% endhighlight %}

    Methods

    +

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

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

    .modal('show')

    Manually opens a modal.

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

    .modal('hide')

    Manually hides a modal.

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

    Events

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

    @@ -331,11 +344,11 @@ $('#myModal').modal({
    -
    +{% highlight js linenos %}
 $('#myModal').on('hidden', function () {
   // do something…
 })
-
    +{% endhighlight %} @@ -441,30 +454,31 @@ $('#myModal').on('hidden', function () {

    Via data attributes

    Add data-toggle="dropdown" to a link or button to toggle a dropdown.

    -
    -<div class="dropdown">
-  <a class="dropdown-toggle" data-toggle="dropdown" href="#">Dropdown trigger</a>
-  <ul class="dropdown-menu" role="menu" aria-labelledby="dLabel">
+{% highlight html linenos %}
+
    
+  Dropdown trigger
+
    + +
    +{% endhighlight %}

    To keep URLs intact, use the data-target attribute instead of href="#".

    -
    -<div class="dropdown">
-  <a class="dropdown-toggle" id="dLabel" role="button" data-toggle="dropdown" data-target="#" href="/page.html">
-    Dropdown
-    <b class="caret"></b>
-  </a>
-  <ul class="dropdown-menu" role="menu" aria-labelledby="dLabel">
+{% highlight html linenos %}
+
    
+  
+    Dropdown 
+  
+
    + +
    +{% endhighlight %}

    Via JavaScript

    Call the dropdowns via JavaScript:

    - 
    $('.dropdown-toggle').dropdown()
    +{% highlight js linenos %} +$('.dropdown-toggle').dropdown() +{% endhighlight %}

    Options

    None

    @@ -531,11 +545,17 @@ $('#myModal').on('hidden', function () {

    Via data attributes

    To easily add scrollspy behavior to your topbar navigation, just add data-spy="scroll" to the element you want to spy on (most typically this would be the body) and data-target=".navbar" to select which nav to use. You'll want to use scrollspy with a .nav component.

    - 
    <body data-spy="scroll" data-target=".navbar">...</body>
    +{% highlight html linenos %} + + ... + +{% endhighlight %}

    Via JavaScript

    Call the scrollspy via JavaScript:

    - 
    $('#navbar').scrollspy()
    +{% highlight js linenos %} +$('#navbar').scrollspy() +{% endhighlight %}
    Heads up! @@ -545,11 +565,12 @@ $('#myModal').on('hidden', function () {

    Methods

    .scrollspy('refresh')

    When using scrollspy in conjunction with adding or removing of elements from the DOM, you'll need to call the refresh method like so:

    -
    +{% highlight js linenos %}
 $('[data-spy="scroll"]').each(function () {
   var $spy = $(this).scrollspy('refresh')
 });
-
    +{% endhighlight %} +

    Options

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

    @@ -635,28 +656,32 @@ $('[data-spy="scroll"]').each(function () {

    Usage

    Enable tabbable tabs via JavaScript (each tab needs to be activated individually):

    -
    +{% highlight js linenos %}
 $('#myTab a').click(function (e) {
   e.preventDefault();
   $(this).tab('show');
-})
    +}) +{% endhighlight %} +

    You can activate individual tabs in several ways:

    -
    +{% highlight js linenos %}
 $('#myTab a[href="#profile"]').tab('show'); // Select tab by name
 $('#myTab a:first').tab('show'); // Select first tab
 $('#myTab a:last').tab('show'); // Select last tab
 $('#myTab li:eq(2) a').tab('show'); // Select third tab (0-indexed)
-
    +{% endhighlight %}

    Markup

    You can activate a tab or pill navigation without writing any JavaScript by simply specifying data-toggle="tab" or data-toggle="pill" on an element. Adding the nav and nav-tabs classes to the tab ul will apply the Bootstrap tab styling.

    -
    -<ul class="nav nav-tabs">
-  <li><a href="#home" data-toggle="tab">Home</a></li>
-  <li><a href="#profile" data-toggle="tab">Profile</a></li>
-  <li><a href="#messages" data-toggle="tab">Messages</a></li>
-  <li><a href="#settings" data-toggle="tab">Settings</a></li>
-</ul>
    +{% highlight html linenos %} + +{% endhighlight %} +

    To make tabs fade in, add .fade to each .tab-pane.

    Methods

    @@ -664,27 +689,27 @@ $('#myTab li:eq(2) a').tab('show'); // Select third tab (0-indexed)

    Activates a tab element and content container. Tab should have either a data-target or an href targeting a container node in the DOM.

    -
    -<ul class="nav nav-tabs" id="myTab">
-  <li class="active"><a href="#home">Home</a></li>
-  <li><a href="#profile">Profile</a></li>
-  <li><a href="#messages">Messages</a></li>
-  <li><a href="#settings">Settings</a></li>
-</ul>
-
-<div class="tab-content">
-  <div class="tab-pane active" id="home">...</div>
-  <div class="tab-pane" id="profile">...</div>
-  <div class="tab-pane" id="messages">...</div>
-  <div class="tab-pane" id="settings">...</div>
-</div>
-
-<script>
+{% highlight html linenos %}
+
+
+
    
+  
    ...
    
+  
    ...
    
+  
    ...
    
+  
    ...
    
+
    
+
+
+{% endhighlight %}
 
           
    Events
    
           
@@ -705,12 +730,12 @@ $('#myTab li:eq(2) a').tab('show'); // Select third tab (0-indexed)
              
    
             
           
    
-
    +{% highlight js linenos %}
 $('a[data-toggle="tab"]').on('shown', function (e) {
   e.target // activated tab
   e.relatedTarget // previous tab
 })
-
    
+{% endhighlight %}
         
 
 
@@ -749,7 +774,9 @@ $('a[data-toggle="tab"]').on('shown', function (e) {
 
           
    Usage
    
           
    Trigger the tooltip via JavaScript:
    
-          
    $('#example').tooltip(options)
    
+{% highlight js linenos %}
+$('#example').tooltip(options)
+{% endhighlight %}
 
           
    Options
    
           
    Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-, as in data-animation="".
    
@@ -825,23 +852,30 @@ $('a[data-toggle="tab"]').on('shown', function (e) {

    Markup

    - 
    <a href="#" data-toggle="tooltip" title="first tooltip">hover over me</a>
    +{% highlight html linenos %} +Hover over me +{% endhighlight %}

    Methods

    +

    $().tooltip(options)

    Attaches a tooltip handler to an element collection.

    +

    .tooltip('show')

    Reveals an element's tooltip.

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

    .tooltip('hide')

    Hides an element's tooltip.

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

    .tooltip('toggle')

    Toggles an element's tooltip.

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

    .tooltip('destroy')

    Hides and destroys an element's tooltip.

    - 
    $('#element').tooltip('destroy')
    + {% highlight js linenos %}$('#element').tooltip('destroy'){% endhighlight %} @@ -916,7 +950,7 @@ $('a[data-toggle="tab"]').on('shown', function (e) {

    Usage

    Enable popovers via JavaScript:

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

    Options

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

    @@ -1003,18 +1037,22 @@ $('a[data-toggle="tab"]').on('shown', function (e) {

    Methods

    $().popover(options)

    Initializes popovers for an element collection.

    +

    .popover('show')

    Reveals an elements popover.

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

    .popover('hide')

    Hides an elements popover.

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

    .popover('toggle')

    Toggles an elements popover.

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

    .popover('destroy')

    Hides and destroys an element's popover.

    - 
    $('#element').popover('destroy')
    + {% highlight js linenos %}$('#element').popover('destroy'){% endhighlight %} @@ -1053,18 +1091,20 @@ $('a[data-toggle="tab"]').on('shown', function (e) {

    Usage

    Enable dismissal of an alert via JavaScript:

    - 
    $(".alert").alert()
    + {% highlight js linenos %}$(".alert").alert(){% endhighlight %}

    Markup

    Just add data-dismiss="alert" to your close button to automatically give an alert close functionality.

    - 
    <a class="close" data-dismiss="alert" href="#">&times;</a>
    + {% highlight html linenos %}×{% endhighlight %}

    Methods

    +

    $().alert()

    Wraps all alerts with close functionality. To have your alerts animate out when closed, make sure they have the .fade and .in class already applied to them.

    +

    .alert('close')

    Closes an alert.

    - 
    $(".alert").alert('close')
    + {% highlight js linenos %}$(".alert").alert('close'){% endhighlight %}

    Events

    @@ -1087,11 +1127,11 @@ $('a[data-toggle="tab"]').on('shown', function (e) { -
    +{% highlight js linenos %}
 $('#my-alert').bind('closed', function () {
   // do something…
 })
-
    +{% endhighlight %} @@ -1109,18 +1149,24 @@ $('#my-alert').bind('closed', function () {

    Stateful

    Add data-loading-text="Loading..." to use a loading state on a button.

    -
    - 
    <button type="button" class="btn btn-primary" data-loading-text="Loading...">Loading state</button>
    +{% highlight html linenos %} + +{% endhighlight %}

    Single toggle

    Add data-toggle="button" to activate toggling on a single button.

    - +
    - 
    <button type="button" class="btn btn-primary" data-toggle="button">Single Toggle</button>
    +{% highlight html linenos %} + +{% endhighlight %}

    Checkbox

    Add data-toggle="buttons-checkbox" for checkbox style toggling on btn-group.

    @@ -1131,13 +1177,13 @@ $('#my-alert').bind('closed', function () { -
    -<div class="btn-group" data-toggle="buttons-checkbox">
-  <button type="button" class="btn btn-primary">Left</button>
-  <button type="button" class="btn btn-primary">Middle</button>
-  <button type="button" class="btn btn-primary">Right</button>
-</div>
-
    +{% highlight html linenos %} +
    + + + +
    +{% endhighlight %}

    Radio

    Add data-toggle="buttons-radio" for radio style toggling on btn-group.

    @@ -1148,13 +1194,13 @@ $('#my-alert').bind('closed', function () { -
    -<div class="btn-group" data-toggle="buttons-radio">
-  <button type="button" class="btn btn-primary">Left</button>
-  <button type="button" class="btn btn-primary">Middle</button>
-  <button type="button" class="btn btn-primary">Right</button>
-</div>
-
    +{% highlight html linenos %} +
    + + + +
    +{% endhighlight %}
    @@ -1162,7 +1208,9 @@ $('#my-alert').bind('closed', function () {

    Usage

    Enable buttons via JavaScript:

    - 
    $('.nav-tabs').button()
    +{% highlight js linenos %} +$('.nav-tabs').button() +{% endhighlight %}

    Markup

    Data attributes are integral to the button plugin. Check out the example code below for the various markup types.

    @@ -1171,30 +1219,40 @@ $('#my-alert').bind('closed', function () {

    None

    Methods

    +

    $().button('toggle')

    Toggles push state. Gives the button the appearance that it has been activated.

    Heads up! You can enable auto toggling of a button by using the data-toggle attribute.
    - 
    <button type="button" class="btn" data-toggle="button" >…</button>
    +{% highlight html linenos %} + +{% endhighlight %} +

    $().button('loading')

    Sets button state to loading - disables button and swaps text to loading text. Loading text should be defined on the button element using the data attribute data-loading-text.

    - 
    <button type="button" class="btn" data-loading-text="loading stuff..." >...</button>
    +{% highlight html linenos %} + +{% endhighlight %} +
    Heads up! Firefox persists the disabled state across page loads. A workaround for this is to use autocomplete="off".
    +

    $().button('reset')

    Resets button state - swaps text to original text.

    +

    $().button(string)

    Resets button state - swaps text to any data defined text state.

    -
    <button type="button" class="btn" data-complete-text="finished!" >...</button>
-<script>
+{% highlight html linenos %}
+
+
+{% endhighlight %}
           
 
 
@@ -1253,43 +1311,55 @@ $('#my-alert').bind('closed', function () {
                 
               
             
-
    -<div class="accordion" id="accordion2">
-  <div class="accordion-group">
-    <div class="accordion-heading">
-      <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion2" href="#collapseOne">
+{% highlight html linenos %}
+
    
+      
+    
+    
    
+      
    
+        ...
+      
    
+    
    
+  
+  
    
+    
    
+      
+        Collapsible Group Item #3
+      
+    
    
+    
    
+      
    
+        ...
+      
    
+    
    
+  
    
+
+{% endhighlight %}
+
             
    You can also use the plugin without the accordion markup. Make a button toggle the expanding and collapsing of another element.
    
-
    -<button type="button" class="btn btn-danger" data-toggle="collapse" data-target="#demo">
+{% highlight html linenos %}
+
 
-<div id="demo" class="collapse in"> … </div>
-
    
+
    ...
    
+{% endhighlight %}
 
 
             
    
@@ -1303,7 +1373,9 @@ $('#my-alert').bind('closed', function () {
 
             
    Via JavaScript
    
             
    Enable manually with:
    
-            
    $(".collapse").collapse()
    
+{% highlight js linenos %}
+$(".collapse").collapse()
+{% endhighlight %}
 
             
    Options
    
             
    Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-, as in data-parent="".
    
@@ -1334,17 +1406,21 @@ $('#my-alert').bind('closed', function () {
 
 
             
    Methods
    
+
             
    .collapse(options)
    
             
    Activates your content as a collapsible element. Accepts an optional options object.
-
    +{% highlight js linenos %}
 $('#myCollapsible').collapse({
   toggle: false
 })
-
    
+{% endhighlight %}
+
             
    .collapse('toggle')
    
             
    Toggles a collapsible element to shown or hidden.
    
+
             
    .collapse('show')
    
             
    Shows a collapsible element.
    
+
             
    .collapse('hide')
    
             
    Hides a collapsible element.
    
 
@@ -1378,10 +1454,11 @@ $('#myCollapsible').collapse({
                
               
             
-
    +{% highlight js linenos %}
 $('#myCollapsible').on('hidden', function () {
   // do something…
-})
    
+})
+{% endhighlight %}
           
 
 
@@ -1433,24 +1510,35 @@ $('#myCollapsible').on('hidden', function () {
                 
               
             
-
    -<div id="myCarousel" class="carousel slide">
-  <ol class="carousel-indicators">
-    <li data-target="#myCarousel" data-slide-to="0" class="active"></li>
-    <li data-target="#myCarousel" data-slide-to="1"></li>
-    <li data-target="#myCarousel" data-slide-to="2"></li>
-  </ol>
-  <!-- Carousel items -->
-  <div class="carousel-inner">
-    <div class="active item">…</div>
-    <div class="item">…</div>
-    <div class="item">…</div>
-  </div>
-  <!-- Carousel nav -->
-  <a class="carousel-control left" href="#myCarousel" data-slide="prev">&lsaquo;</a>
-  <a class="carousel-control right" href="#myCarousel" data-slide="next">&rsaquo;</a>
-</div>
-
    
+{% highlight html linenos %}
+
+{% endhighlight %}
 
             
    
               Heads up!
@@ -1468,7 +1556,9 @@ $('#myCollapsible').on('hidden', function () {
 
             
    Via JavaScript
    
             
    Call carousel manually with:
    
-            
    $('.carousel').carousel()
    
+{% highlight js linenos %}
+$('.carousel').carousel()
+{% endhighlight %}
 
             
    Options
    
             
    Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-, as in data-interval="".
    
@@ -1498,21 +1588,27 @@ $('#myCollapsible').on('hidden', function () {
             
 
             
    Methods
    
+
             
    .carousel(options)
    
             
    Initializes the carousel with an optional options object and starts cycling through items.
    
-
    +{% highlight html linenos %}
 $('.carousel').carousel({
   interval: 2000
 })
-
    
+{% endhighlight %}
+
             
    .carousel('cycle')
    
             
    Cycles through the carousel items from left to right.
    
+
             
    .carousel('pause')
    
             
    Stops the carousel from cycling through items.
    
+
             
    .carousel(number)
    
             
    Cycles the carousel to a particular frame (0 based, similar to an array).
    
+
             
    .carousel('prev')
    
             
    Cycles to the previous item.
    
+
             
    .carousel('next')
    
             
    Cycles to the next item.
    
 
@@ -1553,7 +1649,10 @@ $('.carousel').carousel({
             
    
               
             
    
-            
    <input type="text" data-provide="typeahead">
    
+{% highlight html linenos %}
+
+{% endhighlight %}
+
             
    You'll want to set autocomplete="off" to prevent default browser menus from appearing over the Bootstrap typeahead dropdown.
    
 
             
    
@@ -1566,7 +1665,9 @@ $('.carousel').carousel({
 
             
    Via JavaScript
    
             
    Call the typeahead manually with:
    
-            
    $('.typeahead').typeahead()
    
+{% highlight js linenos %}
+$('.typeahead').typeahead()
+{% endhighlight %}
 
             
    Options
    
             
    Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-, as in data-source="".
    
@@ -1649,7 +1750,9 @@ $('.carousel').carousel({
             
    Via data attributes
    
             
    To easily add affix behavior to any element, just add data-spy="affix" to the element you want to spy on. Then use offsets to define when to toggle the pinning of an element on and off.
    
 
-            
    <div data-spy="affix" data-offset-top="200">...</div>
    
+{% highlight html linenos %}
+
    ...
    
+{% endhighlight %}
 
             
    
               Heads up!
@@ -1658,16 +1761,19 @@ $('.carousel').carousel({
 
             
    Via JavaScript
    
             
    Call the affix plugin via JavaScript:
    
-            
    $('#navbar').affix()
    
+{% highlight js linenos %}
+$('#navbar').affix()
+{% endhighlight %}
 
             
    Methods
    
             
    .affix('refresh')
    
             
    When using affix in conjunction with adding or removing of elements from the DOM, you'll want to call the refresh method:
    
-
    +{% highlight js linenos %}
 $('[data-spy="affix"]').each(function () {
   $(this).affix('refresh')
 });
-
    
+{% endhighlight %}
+
           
    Options
    
           
    Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-, as in data-offset-top="200".
    
 
-- 
cgit v1.2.3


From a77cd6cb5d42a9474a5b3da8b012065a681c0a81 Mon Sep 17 00:00:00 2001
From: Can Burak Cilingir 
Date: Fri, 15 Feb 2013 18:47:34 +0800
Subject: Fix typo on JavaScript documentation

---
 docs/javascript.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'docs/javascript.html')

diff --git a/docs/javascript.html b/docs/javascript.html
index e6ff65eaf..3fc8d0471 100644
--- a/docs/javascript.html
+++ b/docs/javascript.html
@@ -824,7 +824,7 @@ $('#example').tooltip(options)
                trigger
                string
                'hover focus'
-               how tooltip is triggered - click | hover | focus | manual. Note you case pass trigger mutliple, space seperated, trigger types.
+               how tooltip is triggered - click | hover | focus | manual. Note you case pass trigger multiple, space seperated, trigger types.
              
              
                delay
-- 
cgit v1.2.3


From d8e2668c1df122f61e82008821bc6b56def4fe12 Mon Sep 17 00:00:00 2001
From: Mark Otto 
Date: Sat, 16 Feb 2013 01:22:15 -0800
Subject: Overhaul carousel a bit more:

* Drop custom type arrow controls for glyphicons icons instead for more consistent rendering
* Remove the captions and instead let folks implement what they want in the carousel
* Move the indicators to the bottom middle instead of top right
* Lighten up gradients on the edges for less harsh lighting
---
 docs/javascript.html | 22 +++++-----------------
 1 file changed, 5 insertions(+), 17 deletions(-)

(limited to 'docs/javascript.html')

diff --git a/docs/javascript.html b/docs/javascript.html
index 3fc8d0471..330639267 100644
--- a/docs/javascript.html
+++ b/docs/javascript.html
@@ -1481,32 +1481,20 @@ $('#myCollapsible').on('hidden', function () {
                 
                 
    
                   
    
-                    
-                    
    
-                      
    First slide label
    
-                      
    Nulla vitae elit libero, a pharetra augue. Maecenas faucibus mollis interdum. Cum sociis natoque penatibus et magnis dis parturient montes.
    
-                    
    
+                    
                   
    
                   
    
-                    
-                    
    
-                      
    Second slide label
    
-                      
    Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean lacinia bibendum nulla sed consectetur. Nullam quis risus eget urna mollis ornare.
    
-                    
    
+                    
                   
    
                   
    
-                    
-                    
    
-                      
    Third slide label
    
-                      
    Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Integer posuere erat a ante venenatis dapibus posuere velit aliquet.
    
-                    
    
+                    
                   
    
                 
    
                 
-                  ‹
+                  
                 
                 
-                  ›
+                  
                 
               
    
             
    
-- 
cgit v1.2.3


From ce21926704778a2fb8ff76f5241b90a97abeea4c Mon Sep 17 00:00:00 2001
From: Mark Otto 
Date: Sat, 16 Feb 2013 01:26:43 -0800
Subject: All Glyphicons now require a base class, e.g.
 .glyphicon.glyphicon-star

---
 docs/javascript.html | 32 ++++++++++++++++----------------
 1 file changed, 16 insertions(+), 16 deletions(-)

(limited to 'docs/javascript.html')

diff --git a/docs/javascript.html b/docs/javascript.html
index 330639267..0b3fc3e42 100644
--- a/docs/javascript.html
+++ b/docs/javascript.html
@@ -19,20 +19,20 @@ title: JavaScript plugins
     
    
       
    
         
       
    
       
    
@@ -1491,10 +1491,10 @@ $('#myCollapsible').on('hidden', function () {
                   
    
                 
    
                 
-                  
+                  
                 
                 
-                  
+                  
                 
               
             
-- 
cgit v1.2.3


From 6d048471c47ed740453c01252ad62a42e185cb46 Mon Sep 17 00:00:00 2001
From: Mark Otto 
Date: Sat, 16 Feb 2013 02:47:15 -0800
Subject: Re-add carousel captions as optional

* They're hidden by default in the mobile-first views because otherwise they just cover up the slides
* In mobile they're centered, and then are shown left aligned at larger viewports
---
 docs/javascript.html | 64 ++++++++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 55 insertions(+), 9 deletions(-)

(limited to 'docs/javascript.html')

diff --git a/docs/javascript.html b/docs/javascript.html
index 0b3fc3e42..b79402491 100644
--- a/docs/javascript.html
+++ b/docs/javascript.html
@@ -1470,10 +1470,10 @@ $('#myCollapsible').on('hidden', function () {
               
    Carousel bootstrap-carousel.js
    
             
 
-            
    Example carousel
    
+            
    Examples
    
             
    The slideshow below shows a generic plugin and component for cycling through elements like a carousel.
    
             
    
-              
 {% highlight html linenos %}
-