docs.html 263 KB
Newer Older
2001
2002
2003
2004
2005
2006
    <h3>Button element</h3>
    <p>Add the <code>disabled</code> attribute to <code>&lt;button&gt;</code> buttons.</p>
    <p class="bs-docs-example">
      <button type="button" class="btn btn-large btn-primary disabled" disabled="disabled">Primary button</button>
      <button type="button" class="btn btn-large" disabled="disabled">Button</button>
    </p>
2007
2008
2009
2010
2011
{% highlight html linenos %}
<button type="button" class="btn btn-large btn-primary disabled" disabled="disabled">Primary button</button>
<button type="button" class="btn btn-large" disabled="disabled">Button</button>
{% endhighlight %}

2012
2013
2014
2015
2016
2017
    <h3>Anchor element</h3>
    <p>Add the <code>.disabled</code> class to <code>&lt;a&gt;</code> buttons.</p>
    <p class="bs-docs-example">
      <a href="#" class="btn btn-large btn-primary disabled">Primary link</a>
      <a href="#" class="btn btn-large disabled">Link</a>
    </p>
2018
2019
2020
2021
{% highlight html linenos %}
<a href="#" class="btn btn-large btn-primary disabled">Primary link</a>
<a href="#" class="btn btn-large disabled">Link</a>
{% endhighlight %}
2022
2023
2024
    <p>
      We use <code>.disabled</code> as a utility class here, similar to the common <code>.active</code> class, so no prefix is required. Also, this class is only for aesthetic; you must use custom JavaScript to disable links here.
    </p>
2025
2026


2027
2028
2029
2030
2031
2032
2033
2034
    <h2 id="buttons-tags">One class, multiple tags</h2>
    <p>Use the <code>.btn</code> class on an <code>&lt;a&gt;</code>, <code>&lt;button&gt;</code>, or <code>&lt;input&gt;</code> element.</p>
    <form class="bs-docs-example">
      <a class="btn" href="">Link</a>
      <button class="btn" type="submit">Button</button>
      <input class="btn" type="button" value="Input">
      <input class="btn" type="submit" value="Submit">
    </form>
2035
2036
2037
2038
2039
2040
{% highlight html linenos %}
<a class="btn" href="">Link</a>
<button class="btn" type="submit">Button</button>
<input class="btn" type="button" value="Input">
<input class="btn" type="submit" value="Submit">
{% endhighlight %}
2041
    <p>As a best practice, <strong>we highly recommend matching using the <code>&lt;button&lt;</code> element whenever possible</strong> to ensure matching cross-browser rendering.</p>
2042

2043
  </div>
2044
2045
2046



2047
2048
2049
2050
2051
2052
  <!-- Images
  ================================================== -->
  <div class="bs-docs-section" id="images">
    <div class="page-header">
      <h1>Images</h1>
    </div>
2053

2054
2055
2056
2057
2058
2059
    <p>Add classes to an <code>&lt;img&gt;</code> element to easily style images in any project. Rounded corners are not available in IE8.</p>
    <div class="bs-docs-example bs-docs-example-images">
      <img data-src="holder.js/140x140" class="img-rounded">
      <img data-src="holder.js/140x140" class="img-circle">
      <img data-src="holder.js/140x140" class="img-thumbnail">
    </div>
2060
2061
2062
2063
2064
2065
{% highlight html linenos %}
<img src="..." class="img-rounded">
<img src="..." class="img-circle">
<img src="..." class="img-thumbnail">
{% endhighlight %}

2066
  </div>
2067
2068


2069
2070
2071
2072
2073
2074
  <!-- Helpers
  ================================================== -->
  <div class="bs-docs-section" id="helper-classes">
    <div class="page-header">
      <h1>Helper classes</h1>
    </div>
Mark Otto's avatar
Mark Otto committed
2075

2076
2077
2078
2079
2080
    <h3>Close icon</h3>
    <p>Use the generic close icon for dismissing content like modals and alerts.</p>
    <div class="bs-docs-example">
      <p><button class="close" style="float: none;">&times;</button></p>
    </div>
Mark Otto's avatar
Mark Otto committed
2081
2082
2083
2084
{% highlight html linenos %}
<button class="close" style="float: none;">&times;</button>
{% endhighlight %}

2085
2086
    <h3>.pull-left</h3>
    <p>Float an element left</p>
Mark Otto's avatar
Mark Otto committed
2087
2088
2089
2090
2091
2092
2093
2094
2095
{% highlight html linenos %}
<div class="pull-left">...</div>
{% endhighlight %}
{% highlight css linenos %}
.pull-left {
  float: left;
}
{% endhighlight %}

2096
2097
    <h3>.pull-right</h3>
    <p>Float an element right</p>
Mark Otto's avatar
Mark Otto committed
2098
2099
2100
2101
2102
2103
2104
2105
2106
{% highlight html linenos %}
<div class="pull-right">...</div>
{% endhighlight %}
{% highlight css linenos %}
.pull-right {
  float: right;
}
{% endhighlight %}

2107
2108
    <h3>.clearfix</h3>
    <p>Clear the <code>float</code> on any element. Utilizes <a href="http://nicolasgallagher.com/micro-clearfix-hack/">the micro clearfix</a> as popularized by Nicolas Gallagher.</p>
Mark Otto's avatar
Mark Otto committed
2109
2110
2111
2112
2113
2114
2115
2116
2117
2118
2119
2120
2121
2122
2123
2124
2125
2126
2127
2128
2129
{% highlight html linenos %}
<div class="clearfix">...</div>
{% endhighlight %}
{% highlight css linenos %}
// Mixin
.clearfix {
  &:before,
  &:after {
    content: " ";
    display: table;
  }
  &:after {
    clear: both;
  }
}

// Usage
.element {
  .clearfix();
}
{% endhighlight %}
2130
  </div>
Mark Otto's avatar
Mark Otto committed
2131
2132


2133
2134
2135
2136
2137
2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
2175
2176
2177
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229
2230
2231
2232
  <!-- Responsive utilities
  ================================================== -->
  <div class="bs-docs-section" id="responsive-utilities">
    <div class="page-header">
      <h1>Responsive utilities</h1>
    </div>
    <p class="lead">For faster mobile-friendly development, use these utility classes for showing and hiding content by device via media query. Also included are utility classes for toggling content when printed.</p>

    <h3>Responsive classes</h3>
    <table class="table table-bordered table-striped responsive-utilities hidden-phone">
      <thead>
        <tr>
          <th>Class</th>
          <th>Phones <small>767px and below</small></th>
          <th>Tablets <small>979px to 768px</small></th>
          <th>Desktops <small>Default</small></th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <th><code>.visible-phone</code></th>
          <td class="is-visible">Visible</td>
          <td class="is-hidden">Hidden</td>
          <td class="is-hidden">Hidden</td>
        </tr>
        <tr>
          <th><code>.visible-tablet</code></th>
          <td class="is-hidden">Hidden</td>
          <td class="is-visible">Visible</td>
          <td class="is-hidden">Hidden</td>
        </tr>
        <tr>
          <th><code>.visible-desktop</code></th>
          <td class="is-hidden">Hidden</td>
          <td class="is-hidden">Hidden</td>
          <td class="is-visible">Visible</td>
        </tr>
        <tr>
          <th><code>.hidden-phone</code></th>
          <td class="is-hidden">Hidden</td>
          <td class="is-visible">Visible</td>
          <td class="is-visible">Visible</td>
        </tr>
        <tr>
          <th><code>.hidden-tablet</code></th>
          <td class="is-visible">Visible</td>
          <td class="is-hidden">Hidden</td>
          <td class="is-visible">Visible</td>
        </tr>
        <tr>
          <th><code>.hidden-desktop</code></th>
          <td class="is-visible">Visible</td>
          <td class="is-visible">Visible</td>
          <td class="is-hidden">Hidden</td>
        </tr>
      </tbody>
    </table>

    <h3>Print classes</h3>
    <table class="table table-bordered table-striped responsive-utilities">
      <thead>
        <tr>
          <th>Class</th>
          <th>Browser</th>
          <th>Print</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <th><code>.visible-print</code></th>
          <td class="is-hidden">Hidden</td>
          <td class="is-visible">Visible</td>
        </tr>
        <tr>
          <th><code>.hidden-print</code></th>
          <td class="is-visible">Visible</td>
          <td class="is-hidden">Hidden</td>
        </tr>
      </tbody>
    </table>

    <h3>When to use</h3>
    <p>Use on a limited basis and avoid creating entirely different versions of the same site. Instead, use them to complement each device's presentation. Responsive utilities should not be used with tables, and as such are not supported.</p>

    <h3>Test case</h3>
    <p>Resize your browser or load on different devices to test the above classes.</p>
    <h4>Visible on...</h4>
    <p>Green checkmarks indicate that class is visible in your current viewport.</p>
    <ul class="responsive-utilities-test">
      <li>Phone<span class="visible-phone">&#10004; Phone</span></li>
      <li>Tablet<span class="visible-tablet">&#10004; Tablet</span></li>
      <li>Desktop<span class="visible-desktop">&#10004; Desktop</span></li>
    </ul>
    <h4>Hidden on...</h4>
    <p>Here, green checkmarks indicate that class is hidden in your current viewport.</p>
    <ul class="responsive-utilities-test hidden-on">
      <li>Phone<span class="hidden-phone">&#10004; Phone</span></li>
      <li>Tablet<span class="hidden-tablet">&#10004; Tablet</span></li>
      <li>Desktop<span class="hidden-desktop">&#10004; Desktop</span></li>
    </ul>
Mark Otto's avatar
Mark Otto committed
2233

2234
  </div>
Mark Otto's avatar
Mark Otto committed
2235
2236


2237
2238
2239



Mark Otto's avatar
Mark Otto committed
2240
2241
2242
2243
  <div class="bs-docs-section-header" id="components">
    <h1>Components</h1>
    <p class="lead">Dozens of reusable components built to provide iconography, dropdowns, navigation, alerts, popovers, and much more.</p>
  </div>
2244
2245


Mark Otto's avatar
Mark Otto committed
2246
2247
2248
2249
2250
2251
  <!-- Icons
  ================================================== -->
  <div class="bs-docs-section" id="icons">
    <div class="page-header">
      <h1>Icons font <small>by <a href="http://glyphicons.com" target="_blank">Glyphicons</a></small></h1>
    </div>
2252

Mark Otto's avatar
Mark Otto committed
2253
2254
2255
2256
2257
2258
2259
2260
2261
2262
2263
2264
2265
2266
2267
2268
2269
2270
2271
2272
2273
2274
2275
2276
2277
2278
2279
2280
2281
2282
2283
2284
2285
2286
2287
2288
2289
2290
2291
2292
2293
2294
2295
2296
2297
2298
2299
2300
2301
2302
2303
2304
2305
2306
2307
2308
2309
2310
2311
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335
2336
2337
2338
2339
2340
2341
2342
2343
2344
2345
2346
2347
2348
2349
2350
2351
2352
2353
2354
2355
2356
2357
2358
2359
2360
2361
2362
2363
2364
2365
2366
2367
2368
2369
2370
2371
2372
2373
2374
2375
2376
2377
2378
2379
2380
2381
2382
2383
2384
2385
2386
2387
2388
2389
2390
2391
2392
2393
2394
2395
2396
2397
2398
2399
2400
2401
2402
2403
2404
2405
2406
2407
2408
2409
2410
2411
2412
2413
2414
2415
2416
2417
2418
2419
2420
2421
    <h2>Included glyphs</h2>
    <p>Bootstrap comes with all 160 of <a href="http://glyphicons.com" target="_blank">Glyphicons</a> Halflings set, all available in font formats for easy coloring, sizing, and placement.</p>

    <ul class="the-icons clearfix">
      <li><i class="glyphicon glyphicon-glass"></i> glyphicon-glass</li>
      <li><i class="glyphicon glyphicon-music"></i> glyphicon-music</li>
      <li><i class="glyphicon glyphicon-search"></i> glyphicon-search</li>
      <li><i class="glyphicon glyphicon-envelope"></i> glyphicon-envelope</li>
      <li><i class="glyphicon glyphicon-heart"></i> glyphicon-heart</li>
      <li><i class="glyphicon glyphicon-star"></i> glyphicon-star</li>
      <li><i class="glyphicon glyphicon-star-empty"></i> glyphicon-star-empty</li>
      <li><i class="glyphicon glyphicon-user"></i> glyphicon-user</li>
      <li><i class="glyphicon glyphicon-film"></i> glyphicon-film</li>
      <li><i class="glyphicon glyphicon-th-large"></i> glyphicon-th-large</li>
      <li><i class="glyphicon glyphicon-th"></i> glyphicon-th</li>
      <li><i class="glyphicon glyphicon-th-list"></i> glyphicon-th-list</li>
      <li><i class="glyphicon glyphicon-ok"></i> glyphicon-ok</li>
      <li><i class="glyphicon glyphicon-remove"></i> glyphicon-remove</li>
      <li><i class="glyphicon glyphicon-zoom-in"></i> glyphicon-zoom-in</li>
      <li><i class="glyphicon glyphicon-zoom-out"></i> glyphicon-zoom-out</li>
      <li><i class="glyphicon glyphicon-off"></i> glyphicon-off</li>
      <li><i class="glyphicon glyphicon-signal"></i> glyphicon-signal</li>
      <li><i class="glyphicon glyphicon-cog"></i> glyphicon-cog</li>
      <li><i class="glyphicon glyphicon-trash"></i> glyphicon-trash</li>
      <li><i class="glyphicon glyphicon-home"></i> glyphicon-home</li>
      <li><i class="glyphicon glyphicon-file"></i> glyphicon-file</li>
      <li><i class="glyphicon glyphicon-time"></i> glyphicon-time</li>
      <li><i class="glyphicon glyphicon-road"></i> glyphicon-road</li>
      <li><i class="glyphicon glyphicon-download-alt"></i> glyphicon-download-alt</li>
      <li><i class="glyphicon glyphicon-download"></i> glyphicon-download</li>
      <li><i class="glyphicon glyphicon-upload"></i> glyphicon-upload</li>
      <li><i class="glyphicon glyphicon-inbox"></i> glyphicon-inbox</li>

      <li><i class="glyphicon glyphicon-play-circle"></i> glyphicon-play-circle</li>
      <li><i class="glyphicon glyphicon-repeat"></i> glyphicon-repeat</li>
      <li><i class="glyphicon glyphicon-refresh"></i> glyphicon-refresh</li>
      <li><i class="glyphicon glyphicon-list-alt"></i> glyphicon-list-alt</li>
      <li><i class="glyphicon glyphicon-lock"></i> glyphicon-lock</li>
      <li><i class="glyphicon glyphicon-flag"></i> glyphicon-flag</li>
      <li><i class="glyphicon glyphicon-headphones"></i> glyphicon-headphones</li>
      <li><i class="glyphicon glyphicon-volume-off"></i> glyphicon-volume-off</li>
      <li><i class="glyphicon glyphicon-volume-down"></i> glyphicon-volume-down</li>
      <li><i class="glyphicon glyphicon-volume-up"></i> glyphicon-volume-up</li>
      <li><i class="glyphicon glyphicon-qrcode"></i> glyphicon-qrcode</li>
      <li><i class="glyphicon glyphicon-barcode"></i> glyphicon-barcode</li>
      <li><i class="glyphicon glyphicon-tag"></i> glyphicon-tag</li>
      <li><i class="glyphicon glyphicon-tags"></i> glyphicon-tags</li>
      <li><i class="glyphicon glyphicon-book"></i> glyphicon-book</li>
      <li><i class="glyphicon glyphicon-bookmark"></i> glyphicon-bookmark</li>
      <li><i class="glyphicon glyphicon-print"></i> glyphicon-print</li>
      <li><i class="glyphicon glyphicon-camera"></i> glyphicon-camera</li>
      <li><i class="glyphicon glyphicon-font"></i> glyphicon-font</li>
      <li><i class="glyphicon glyphicon-bold"></i> glyphicon-bold</li>
      <li><i class="glyphicon glyphicon-italic"></i> glyphicon-italic</li>
      <li><i class="glyphicon glyphicon-text-height"></i> glyphicon-text-height</li>
      <li><i class="glyphicon glyphicon-text-width"></i> glyphicon-text-width</li>
      <li><i class="glyphicon glyphicon-align-left"></i> glyphicon-align-left</li>
      <li><i class="glyphicon glyphicon-align-center"></i> glyphicon-align-center</li>
      <li><i class="glyphicon glyphicon-align-right"></i> glyphicon-align-right</li>
      <li><i class="glyphicon glyphicon-align-justify"></i> glyphicon-align-justify</li>
      <li><i class="glyphicon glyphicon-list"></i> glyphicon-list</li>

      <li><i class="glyphicon glyphicon-indent-left"></i> glyphicon-indent-left</li>
      <li><i class="glyphicon glyphicon-indent-right"></i> glyphicon-indent-right</li>
      <li><i class="glyphicon glyphicon-facetime-video"></i> glyphicon-facetime-video</li>
      <li><i class="glyphicon glyphicon-picture"></i> glyphicon-picture</li>
      <li><i class="glyphicon glyphicon-pencil"></i> glyphicon-pencil</li>
      <li><i class="glyphicon glyphicon-map-marker"></i> glyphicon-map-marker</li>
      <li><i class="glyphicon glyphicon-adjust"></i> glyphicon-adjust</li>
      <li><i class="glyphicon glyphicon-tint"></i> glyphicon-tint</li>
      <li><i class="glyphicon glyphicon-edit"></i> glyphicon-edit</li>
      <li><i class="glyphicon glyphicon-share"></i> glyphicon-share</li>
      <li><i class="glyphicon glyphicon-check"></i> glyphicon-check</li>
      <li><i class="glyphicon glyphicon-move"></i> glyphicon-move</li>
      <li><i class="glyphicon glyphicon-step-backward"></i> glyphicon-step-backward</li>
      <li><i class="glyphicon glyphicon-fast-backward"></i> glyphicon-fast-backward</li>
      <li><i class="glyphicon glyphicon-backward"></i> glyphicon-backward</li>
      <li><i class="glyphicon glyphicon-play"></i> glyphicon-play</li>
      <li><i class="glyphicon glyphicon-pause"></i> glyphicon-pause</li>
      <li><i class="glyphicon glyphicon-stop"></i> glyphicon-stop</li>
      <li><i class="glyphicon glyphicon-forward"></i> glyphicon-forward</li>
      <li><i class="glyphicon glyphicon-fast-forward"></i> glyphicon-fast-forward</li>
      <li><i class="glyphicon glyphicon-step-forward"></i> glyphicon-step-forward</li>
      <li><i class="glyphicon glyphicon-eject"></i> glyphicon-eject</li>
      <li><i class="glyphicon glyphicon-chevron-left"></i> glyphicon-chevron-left</li>
      <li><i class="glyphicon glyphicon-chevron-right"></i> glyphicon-chevron-right</li>
      <li><i class="glyphicon glyphicon-plus-sign"></i> glyphicon-plus-sign</li>
      <li><i class="glyphicon glyphicon-minus-sign"></i> glyphicon-minus-sign</li>
      <li><i class="glyphicon glyphicon-remove-sign"></i> glyphicon-remove-sign</li>
      <li><i class="glyphicon glyphicon-ok-sign"></i> glyphicon-ok-sign</li>

      <li><i class="glyphicon glyphicon-question-sign"></i> glyphicon-question-sign</li>
      <li><i class="glyphicon glyphicon-info-sign"></i> glyphicon-info-sign</li>
      <li><i class="glyphicon glyphicon-screenshot"></i> glyphicon-screenshot</li>
      <li><i class="glyphicon glyphicon-remove-circle"></i> glyphicon-remove-circle</li>
      <li><i class="glyphicon glyphicon-ok-circle"></i> glyphicon-ok-circle</li>
      <li><i class="glyphicon glyphicon-ban-circle"></i> glyphicon-ban-circle</li>
      <li><i class="glyphicon glyphicon-arrow-left"></i> glyphicon-arrow-left</li>
      <li><i class="glyphicon glyphicon-arrow-right"></i> glyphicon-arrow-right</li>
      <li><i class="glyphicon glyphicon-arrow-up"></i> glyphicon-arrow-up</li>
      <li><i class="glyphicon glyphicon-arrow-down"></i> glyphicon-arrow-down</li>
      <li><i class="glyphicon glyphicon-share-alt"></i> glyphicon-share-alt</li>
      <li><i class="glyphicon glyphicon-resize-full"></i> glyphicon-resize-full</li>
      <li><i class="glyphicon glyphicon-resize-small"></i> glyphicon-resize-small</li>
      <li><i class="glyphicon glyphicon-plus"></i> glyphicon-plus</li>
      <li><i class="glyphicon glyphicon-minus"></i> glyphicon-minus</li>
      <li><i class="glyphicon glyphicon-asterisk"></i> glyphicon-asterisk</li>
      <li><i class="glyphicon glyphicon-exclamation-sign"></i> glyphicon-exclamation-sign</li>
      <li><i class="glyphicon glyphicon-gift"></i> glyphicon-gift</li>
      <li><i class="glyphicon glyphicon-leaf"></i> glyphicon-leaf</li>
      <li><i class="glyphicon glyphicon-fire"></i> glyphicon-fire</li>
      <li><i class="glyphicon glyphicon-eye-open"></i> glyphicon-eye-open</li>
      <li><i class="glyphicon glyphicon-eye-close"></i> glyphicon-eye-close</li>
      <li><i class="glyphicon glyphicon-warning-sign"></i> glyphicon-warning-sign</li>
      <li><i class="glyphicon glyphicon-plane"></i> glyphicon-plane</li>
      <li><i class="glyphicon glyphicon-calendar"></i> glyphicon-calendar</li>
      <li><i class="glyphicon glyphicon-random"></i> glyphicon-random</li>
      <li><i class="glyphicon glyphicon-comment"></i> glyphicon-comment</li>
      <li><i class="glyphicon glyphicon-magnet"></i> glyphicon-magnet</li>

      <li><i class="glyphicon glyphicon-chevron-up"></i> glyphicon-chevron-up</li>
      <li><i class="glyphicon glyphicon-chevron-down"></i> glyphicon-chevron-down</li>
      <li><i class="glyphicon glyphicon-retweet"></i> glyphicon-retweet</li>
      <li><i class="glyphicon glyphicon-shopping-cart"></i> glyphicon-shopping-cart</li>
      <li><i class="glyphicon glyphicon-folder-close"></i> glyphicon-folder-close</li>
      <li><i class="glyphicon glyphicon-folder-open"></i> glyphicon-folder-open</li>
      <li><i class="glyphicon glyphicon-resize-vertical"></i> glyphicon-resize-vertical</li>
      <li><i class="glyphicon glyphicon-resize-horizontal"></i> glyphicon-resize-horizontal</li>
      <li><i class="glyphicon glyphicon-hdd"></i> glyphicon-hdd</li>
      <li><i class="glyphicon glyphicon-bullhorn"></i> glyphicon-bullhorn</li>
      <li><i class="glyphicon glyphicon-bell"></i> glyphicon-bell</li>
      <li><i class="glyphicon glyphicon-certificate"></i> glyphicon-certificate</li>
      <li><i class="glyphicon glyphicon-thumbs-up"></i> glyphicon-thumbs-up</li>
      <li><i class="glyphicon glyphicon-thumbs-down"></i> glyphicon-thumbs-down</li>
      <li><i class="glyphicon glyphicon-hand-right"></i> glyphicon-hand-right</li>
      <li><i class="glyphicon glyphicon-hand-left"></i> glyphicon-hand-left</li>
      <li><i class="glyphicon glyphicon-hand-up"></i> glyphicon-hand-up</li>
      <li><i class="glyphicon glyphicon-hand-down"></i> glyphicon-hand-down</li>
      <li><i class="glyphicon glyphicon-circle-arrow-right"></i> glyphicon-circle-arrow-right</li>
      <li><i class="glyphicon glyphicon-circle-arrow-left"></i> glyphicon-circle-arrow-left</li>
      <li><i class="glyphicon glyphicon-circle-arrow-up"></i> glyphicon-circle-arrow-up</li>
      <li><i class="glyphicon glyphicon-circle-arrow-down"></i> glyphicon-circle-arrow-down</li>
      <li><i class="glyphicon glyphicon-globe"></i> glyphicon-globe</li>
      <li><i class="glyphicon glyphicon-wrench"></i> glyphicon-wrench</li>
      <li><i class="glyphicon glyphicon-tasks"></i> glyphicon-tasks</li>
      <li><i class="glyphicon glyphicon-filter"></i> glyphicon-filter</li>
      <li><i class="glyphicon glyphicon-briefcase"></i> glyphicon-briefcase</li>
      <li><i class="glyphicon glyphicon-fullscreen"></i> glyphicon-fullscreen</li>

      <li><i class="glyphicon glyphicon-dashboard"></i> glyphicon-dashboard</li>
      <li><i class="glyphicon glyphicon-paperclip"></i> glyphicon-paperclip</li>
      <li><i class="glyphicon glyphicon-heart-empty"></i> glyphicon-heart-empty</li>
      <li><i class="glyphicon glyphicon-link"></i> glyphicon-link</li>
      <li><i class="glyphicon glyphicon-phone"></i> glyphicon-phone</li>
      <li><i class="glyphicon glyphicon-pushpin"></i> glyphicon-pushpin</li>
      <li><i class="glyphicon glyphicon-euro"></i> glyphicon-euro</li>
      <li><i class="glyphicon glyphicon-usd"></i> glyphicon-usd</li>
      <li><i class="glyphicon glyphicon-gbp"></i> glyphicon-gbp</li>
      <li><i class="glyphicon glyphicon-sort"></i> glyphicon-sort</li>
      <li><i class="glyphicon glyphicon-sort-by-alphabet"></i> glyphicon-sort-by-alphabet</li>
      <li><i class="glyphicon glyphicon-sort-by-alphabet-alt"></i> glyphicon-sort-by-alphabet-alt</li>
      <li><i class="glyphicon glyphicon-sort-by-order"></i> glyphicon-sort-by-order</li>
      <li><i class="glyphicon glyphicon-sort-by-order-alt"></i> glyphicon-sort-by-order-alt</li>
      <li><i class="glyphicon glyphicon-sort-by-attributes"></i> glyphicon-sort-by-attributes</li>
      <li><i class="glyphicon glyphicon-sort-by-attributes-alt"></i> glyphicon-sort-by-attributes-alt</li>
      <li><i class="glyphicon glyphicon-unchecked"></i> glyphicon-unchecked</li>
      <li><i class="glyphicon glyphicon-expand"></i> glyphicon-expand</li>
      <li><i class="glyphicon glyphicon-collapse"></i> glyphicon-collapse</li>
      <li><i class="glyphicon glyphicon-collapse-top"></i> glyphicon-collapse-top</li>
2422

Mark Otto's avatar
Mark Otto committed
2423
    </ul>
2424

Mark Otto's avatar
Mark Otto committed
2425
2426
    <h3>Glyphicons attribution</h3>
    <p><a href="http://glyphicons.com/">Glyphicons</a> Halflings are normally not available for free, but an arrangement between Bootstrap and the Glyphicons creator have made this possible at no cost to you as developers. As a thank you, we ask you to include an optional link back to <a href="http://glyphicons.com/">Glyphicons</a> whenever practical.</p>
2427
2428


Mark Otto's avatar
Mark Otto committed
2429
2430
    <h2>How to use</h2>
    <p>Add the appropriate class to any inline element. All icon classes are prefixed with <code>glyphicon-</code> for easy styling. To use, place the following code just about anywhere:</p>
2431
2432
2433
{% highlight html linenos %}
<span class="glyphicon glyphicon-search"></span>
{% endhighlight %}
Mark Otto's avatar
Mark Otto committed
2434
2435
    <p>Want to change the icon color? Just change the <code>color</code> of the parent element.</p>
    <p>When using beside strings of text, as in buttons or nav links, be sure to leave a space after the icon for proper spacing.</p>
2436
2437


Mark Otto's avatar
Mark Otto committed
2438
2439
    <h2>Icon examples</h2>
    <p>Use them in buttons, button groups for a toolbar, navigation, or prepended form inputs.</p>
2440

Mark Otto's avatar
Mark Otto committed
2441
    <h4>Buttons</h4>
2442

Mark Otto's avatar
Mark Otto committed
2443
2444
2445
2446
2447
2448
2449
2450
2451
2452
2453
    <h5>Button group in a button toolbar</h5>
    <div class="bs-docs-example">
      <div class="btn-toolbar">
        <div class="btn-group">
          <a class="btn" href="#"><span class="glyphicon glyphicon-align-left"></span></a>
          <a class="btn" href="#"><span class="glyphicon glyphicon-align-center"></span></a>
          <a class="btn" href="#"><span class="glyphicon glyphicon-align-right"></span></a>
          <a class="btn" href="#"><span class="glyphicon glyphicon-align-justify"></span></a>
        </div>
      </div>
    </div><!-- /bs-docs-example -->
2454
2455
2456
2457
2458
2459
2460
2461
2462
2463
2464
{% highlight html linenos %}
<div class="btn-toolbar">
  <div class="btn-group">
    <a class="btn" href="#"><span class="glyphicon glyphicon-align-left"></span></a>
    <a class="btn" href="#"><span class="glyphicon glyphicon-align-center"></span></a>
    <a class="btn" href="#"><span class="glyphicon glyphicon-align-right"></span></a>
    <a class="btn" href="#"><span class="glyphicon glyphicon-align-justify"></span></a>
  </div>
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
2465
2466
2467
2468
2469
2470
2471
2472
2473
2474
2475
2476
2477
2478
    <h5>Dropdown in a button group</h5>
    <div class="bs-docs-example">
      <div class="btn-group">
        <a class="btn btn-primary" href="#"><i class="glyphicon glyphicon-user"></i> User</a>
        <a class="btn btn-primary dropdown-toggle" data-toggle="dropdown" href="#"><span class="caret"></span></a>
        <ul class="dropdown-menu">
          <li><a href="#"><i class="glyphicon glyphicon-pencil"></i> Edit</a></li>
          <li><a href="#"><i class="glyphicon glyphicon-trash"></i> Delete</a></li>
          <li><a href="#"><i class="glyphicon glyphicon-ban-circle"></i> Ban</a></li>
          <li class="divider"></li>
          <li><a href="#"><i class="glyphicon glyphicon-"></i> Make admin</a></li>
        </ul>
      </div>
    </div><!-- /bs-docs-example -->
2479
2480
2481
2482
2483
2484
2485
2486
2487
2488
2489
2490
2491
2492
{% highlight html linenos %}
<div class="btn-group">
  <a class="btn btn-primary" href="#"><span class="glyphicon glyphicon-user"></span> User</a>
  <a class="btn btn-primary dropdown-toggle" data-toggle="dropdown" href="#"><span class="caret"></span></a>
  <ul class="dropdown-menu">
    <li><a href="#"><span class="glyphicon glyphicon-pencil"></span> Edit</a></li>
    <li><a href="#"><span class="glyphicon glyphicon-trash"></span> Delete</a></li>
    <li><a href="#"><span class="glyphicon glyphicon-ban-circle"></span> Ban</a></li>
    <li class="divider"></li>
    <li><a href="#"><span class="glyphicon glyphicon-"></span> Make admin</a></li>
  </ul>
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
2493
2494
2495
2496
    <h5>Large button</h5>
    <div class="bs-docs-example">
      <a class="btn btn-large" href="#"><span class="glyphicon glyphicon-star"></span> Star</a>
    </div><!-- /bs-docs-example -->
2497
2498
2499
2500
{% highlight html linenos %}
<a class="btn btn-large" href="#"><span class="glyphicon glyphicon-star"></span> Star</a>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
2501
2502
2503
2504
    <h5>Small button</h5>
    <div class="bs-docs-example">
      <a class="btn btn-small" href="#"><span class="glyphicon glyphicon-star"></span></a>
    </div><!-- /bs-docs-example -->
2505
2506
2507
2508
2509
{% highlight html linenos %}
<a class="btn btn-small" href="#"><span class="glyphicon glyphicon-star"></span></a>
{% endhighlight %}


Mark Otto's avatar
Mark Otto committed
2510
2511
    <h4>Navigation</h4>
    <div class="bs-docs-example">
2512
      <ul class="nav nav-pills nav-stacked">
Mark Otto's avatar
Mark Otto committed
2513
2514
2515
2516
2517
2518
        <li class="active"><a href="#"><span class="glyphicon glyphicon-home"></span> Home</a></li>
        <li><a href="#"><span class="glyphicon glyphicon-book"></span> Library</a></li>
        <li><a href="#"><span class="glyphicon glyphicon-pencil"></span> Applications</a></li>
        <li><a href="#"><span class="glyphicon glyphicon-"></span> Misc</a></li>
      </ul>
    </div><!-- /bs-docs-example -->
2519
{% highlight html linenos %}
2520
<ul class="nav nav-pills nav-stacked">
2521
2522
2523
2524
2525
2526
2527
  <li class="active"><a href="#"><span class="glyphicon glyphicon-home"></span> Home</a></li>
  <li><a href="#"><span class="glyphicon glyphicon-book"></span> Library</a></li>
  <li><a href="#"><span class="glyphicon glyphicon-pencil"></span> Applications</a></li>
  <li><a href="#"><span class="glyphicon glyphicon-"></span> Misc</a></li>
</ul>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
2528
2529
2530
2531
2532
2533
2534
2535
2536
2537
2538
2539
    <h4>Form fields</h4>
    <form class="bs-docs-example form-horizontal">
      <div class="control-group">
        <label class="control-label" for="inputIcon">Email address</label>
        <div class="controls">
          <div class="input-group">
            <span class="input-group-addon"><span class="glyphicon glyphicon-envelope"></span></span>
            <input class="span2" id="inputIcon" type="text">
          </div>
        </div>
      </div>
    </form>
2540
2541
2542
2543
2544
2545
2546
2547
2548
2549
2550
2551
{% highlight html linenos %}
<div class="control-group">
  <label class="control-label" for="inputIcon">Email address</label>
  <div class="controls">
    <div class="input-group">
      <span class="input-group-addon"><span class="glyphicon glyphicon-envelope"></span></span>
      <input class="span2" id="inputIcon" type="text">
    </div>
  </div>
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
2552
  </div>
2553
2554
2555



Mark Otto's avatar
Mark Otto committed
2556
2557
2558
2559
2560
2561
2562
  <!-- Dropdowns
  ================================================== -->
  <div class="bs-docs-section" id="dropdowns">
    <div class="page-header">
      <h1>Dropdown menus</h1>
    </div>
    <p class="lead">Toggleable, contextual menu for displaying lists of links. Made interactive with the <a href="./javascript.html#dropdowns">dropdown JavaScript plugin</a>.</p>
2563

Mark Otto's avatar
Mark Otto committed
2564
    <h3 id="dropdowns-example">Example</h3>
Mark Otto's avatar
Mark Otto committed
2565
2566
2567
2568
2569
2570
2571
2572
2573
2574
2575
2576
    <p>Wrap the dropdown's trigger and the dropdown menu within <code>.dropdown</code>, or another element that declares <code>position: relative;</code>. Then add the menu's HTML.</p>
    <div class="bs-docs-example">
      <div class="dropdown clearfix">
        <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu">
          <li><a tabindex="-1" href="#">Action</a></li>
          <li><a tabindex="-1" href="#">Another action</a></li>
          <li><a tabindex="-1" href="#">Something else here</a></li>
          <li class="divider"></li>
          <li><a tabindex="-1" href="#">Separated link</a></li>
        </ul>
      </div>
    </div><!-- /example -->
2577
2578
2579
2580
2581
2582
2583
2584
2585
2586
2587
2588
2589
{% highlight html linenos %}
<div class="dropdown">
  <!-- Link or button to toggle dropdown -->
  <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu">
    <li><a tabindex="-1" href="#">Action</a></li>
    <li><a tabindex="-1" href="#">Another action</a></li>
    <li><a tabindex="-1" href="#">Something else here</a></li>
    <li class="divider"></li>
    <li><a tabindex="-1" href="#">Separated link</a></li>
  </ul>
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
2590
    <h3 id="dropdowns-alignment">Aligning the menus</h3>
Mark Otto's avatar
Mark Otto committed
2591
    <p>Add <code>.pull-right</code> to a <code>.dropdown-menu</code> to right align the dropdown menu.</p>
2592
2593
2594
2595
2596
2597
{% highlight html linenos %}
<ul class="dropdown-menu pull-right" role="menu" aria-labelledby="dLabel">
  ...
</ul>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
2598
    <h3 id="dropdowns-disabled">Disabled menu options</h3>
Mark Otto's avatar
Mark Otto committed
2599
2600
2601
2602
2603
2604
2605
2606
2607
2608
    <p>Add <code>.disabled</code> to a <code>&lt;li&gt;</code> in the dropdown to disable the link.</p>
    <div class="bs-docs-example">
      <div class="dropdown clearfix">
        <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu">
          <li><a tabindex="-1" href="#">Regular link</a></li>
          <li class="disabled"><a tabindex="-1" href="#">Disabled link</a></li>
          <li><a tabindex="-1" href="#">Another link</a></li>
        </ul>
      </div>
    </div><!-- /example -->
2609
2610
2611
2612
2613
2614
2615
2616
{% highlight html linenos %}
<ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu">
  <li><a tabindex="-1" href="#">Regular link</a></li>
  <li class="disabled"><a tabindex="-1" href="#">Disabled link</a></li>
  <li><a tabindex="-1" href="#">Another link</a></li>
</ul>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
2617
    <h3 id="dropdowns-submenus">Sub menus on dropdowns</h3>
Mark Otto's avatar
Mark Otto committed
2618
2619
    <p>Add an extra level of dropdown menus, appearing on hover like those of OS X, with some simple markup additions. Add <code>.dropdown-submenu</code> to any <code>li</code> in an existing dropdown menu for automatic styling.</p>
    <div class="bs-docs-example bs-docs-example-submenu">
2620

Mark Otto's avatar
Mark Otto committed
2621
2622
2623
2624
2625
2626
2627
2628
2629
2630
2631
2632
2633
2634
2635
2636
2637
2638
2639
2640
2641
      <div class="pull-left">
        <p class="text-muted">Default</p>
        <div class="dropdown clearfix">
          <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu">
            <li><a tabindex="-1" href="#">Action</a></li>
            <li><a tabindex="-1" href="#">Another action</a></li>
            <li><a tabindex="-1" href="#">Something else here</a></li>
            <li class="divider"></li>
            <li class="dropdown-submenu">
              <a tabindex="-1" href="#">More options</a>
              <ul class="dropdown-menu">
                <li><a tabindex="-1" href="#">Second level link</a></li>
                <li><a tabindex="-1" href="#">Second level link</a></li>
                <li><a tabindex="-1" href="#">Second level link</a></li>
                <li><a tabindex="-1" href="#">Second level link</a></li>
                <li><a tabindex="-1" href="#">Second level link</a></li>
              </ul>
            </li>
          </ul>
        </div>
      </div>
2642

Mark Otto's avatar
Mark Otto committed
2643
2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655
2656
2657
2658
2659
2660
2661
2662
2663
      <div class="pull-left">
        <p class="text-muted">Dropup</p>
        <div class="dropup">
          <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu">
            <li><a tabindex="-1" href="#">Action</a></li>
            <li><a tabindex="-1" href="#">Another action</a></li>
            <li><a tabindex="-1" href="#">Something else here</a></li>
            <li class="divider"></li>
            <li class="dropdown-submenu">
              <a tabindex="-1" href="#">More options</a>
              <ul class="dropdown-menu">
                <li><a tabindex="-1" href="#">Second level link</a></li>
                <li><a tabindex="-1" href="#">Second level link</a></li>
                <li><a tabindex="-1" href="#">Second level link</a></li>
                <li><a tabindex="-1" href="#">Second level link</a></li>
                <li><a tabindex="-1" href="#">Second level link</a></li>
              </ul>
            </li>
          </ul>
        </div>
      </div>
2664

Mark Otto's avatar
Mark Otto committed
2665
2666
2667
2668
2669
2670
2671
2672
2673
2674
2675
2676
2677
2678
2679
2680
2681
2682
2683
2684
2685
      <div class="pull-left">
        <p class="text-muted">Left submenu</p>
        <div class="dropdown">
          <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu">
            <li><a tabindex="-1" href="#">Action</a></li>
            <li><a tabindex="-1" href="#">Another action</a></li>
            <li><a tabindex="-1" href="#">Something else here</a></li>
            <li class="divider"></li>
            <li class="dropdown-submenu pull-left">
              <a tabindex="-1" href="#">More options</a>
              <ul class="dropdown-menu">
                <li><a tabindex="-1" href="#">Second level link</a></li>
                <li><a tabindex="-1" href="#">Second level link</a></li>
                <li><a tabindex="-1" href="#">Second level link</a></li>
                <li><a tabindex="-1" href="#">Second level link</a></li>
                <li><a tabindex="-1" href="#">Second level link</a></li>
              </ul>
            </li>
          </ul>
        </div>
      </div>
2686

Mark Otto's avatar
Mark Otto committed
2687
    </div>
2688
2689
2690
2691
2692
2693
2694
2695
2696
2697
2698
2699
2700
2701
2702
2703
2704
{% highlight html linenos %}
<ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu">
  ...
  <li class="dropdown-submenu pull-left">
    <a tabindex="-1" href="#">More options</a>
    <ul class="dropdown-menu">
      <li><a tabindex="-1" href="#">Second level link</a></li>
      <li><a tabindex="-1" href="#">Second level link</a></li>
      <li><a tabindex="-1" href="#">Second level link</a></li>
      <li><a tabindex="-1" href="#">Second level link</a></li>
      <li><a tabindex="-1" href="#">Second level link</a></li>
    </ul>
  </li>
  ...
</ul>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
2705
  </div>
2706
2707
2708



Mark Otto's avatar
Mark Otto committed
2709
2710
  <!-- Button Groups
  ================================================== -->
Mark Otto's avatar
Mark Otto committed
2711
  <div class="bs-docs-section" id="btn-groups">
Mark Otto's avatar
Mark Otto committed
2712
2713
2714
2715
    <div class="page-header">
      <h1>Button groups</h1>
    </div>
    <p class="lead">Group a series of buttons together on a single line with the button group. Add on optional JavaScript radio and checkbox style behavior with <a href="./javascript.html#buttons">our buttons plugin</a>.</p>
2716

Mark Otto's avatar
Mark Otto committed
2717
    <h3 id="btn-groups-single">Basic button group</h3>
Mark Otto's avatar
Mark Otto committed
2718
2719
2720
2721
2722
2723
2724
2725
    <p>Wrap a series of buttons with <code>.btn</code> in <code>.btn-group</code>.</p>
    <div class="bs-docs-example">
      <div class="btn-group" style="margin: 9px 0 5px;">
        <button type="button" class="btn">Left</button>
        <button type="button" class="btn">Middle</button>
        <button type="button" class="btn">Right</button>
      </div>
    </div>
2726
2727
2728
2729
2730
2731
2732
2733
{% highlight html linenos %}
<div class="btn-group">
  <button type="button" class="btn">Left</button>
  <button type="button" class="btn">Middle</button>
  <button type="button" class="btn">Right</button>
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
2734
    <h3 id="btn-groups-toolbar">Multiple button groups</h3>
Mark Otto's avatar
Mark Otto committed
2735
2736
2737
2738
2739
2740
2741
2742
2743
2744
2745
2746
2747
2748
2749
2750
2751
2752
2753
    <p>Combine sets of <code>&lt;div class="btn-group"&gt;</code> into a <code>&lt;div class="btn-toolbar"&gt;</code> for more complex components.</p>
    <div class="bs-docs-example">
      <div class="btn-toolbar" style="margin: 0;">
        <div class="btn-group">
          <button type="button" class="btn">1</button>
          <button type="button" class="btn">2</button>
          <button type="button" class="btn">3</button>
          <button type="button" class="btn">4</button>
        </div>
        <div class="btn-group">
          <button type="button" class="btn">5</button>
          <button type="button" class="btn">6</button>
          <button type="button" class="btn">7</button>
        </div>
        <div class="btn-group">
          <button type="button" class="btn">8</button>
        </div>
      </div>
    </div>
2754
2755
2756
2757
2758
2759
2760
2761
{% highlight html linenos %}
<div class="btn-toolbar">
  <div class="btn-group">...</div>
  <div class="btn-group">...</div>
  <div class="btn-group">...</div>
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
2762
    <h3 id="btn-groups-vertical">Vertical button groups</h3>
Mark Otto's avatar
Mark Otto committed
2763
2764
2765
2766
2767
2768
2769
2770
2771
    <p>Make a set of buttons appear vertically stacked rather than horizontally.</p>
    <div class="bs-docs-example">
      <div class="btn-group btn-group-vertical">
        <button type="button" class="btn"><i class="glyphicon glyphicon-align-left"></i></button>
        <button type="button" class="btn"><i class="glyphicon glyphicon-align-center"></i></button>
        <button type="button" class="btn"><i class="glyphicon glyphicon-align-right"></i></button>
        <button type="button" class="btn"><i class="glyphicon glyphicon-align-justify"></i></button>
      </div>
    </div>
2772
2773
2774
2775
2776
2777
{% highlight html linenos %}
<div class="btn-group btn-group-vertical">
  ...
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
2778
    <h3 id="btn-groups-justified">Justified button groups</h3>
Mark Otto's avatar
Mark Otto committed
2779
2780
2781
2782
2783
2784
2785
2786
    <p>Make a group of buttons stretch at the same size to span the entire width of its parent. <strong>This only works with <code>&lt;a&gt;</code> elements</strong> as the <code>&lt;button&gt;</code> doesn't pick up these styles.</p>
    <div class="bs-docs-example">
      <div class="btn-group btn-group-justified">
        <a href="#" class="btn">Left</a>
        <a href="#" class="btn">Right</a>
        <a href="#" class="btn">Middle</a>
      </div>
    </div>
2787
2788
2789
2790
2791
2792
{% highlight html linenos %}
<div class="btn-group btn-group-justified">
  ...
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
2793
  </div>
2794
2795
2796



Mark Otto's avatar
Mark Otto committed
2797
2798
  <!-- Split button dropdowns
  ================================================== -->
Mark Otto's avatar
Mark Otto committed
2799
  <div class="bs-docs-section" id="btn-dropdowns">
Mark Otto's avatar
Mark Otto committed
2800
2801
2802
2803
    <div class="page-header">
      <h1>Button dropdown menus</h1>
    </div>
    <p class="lead">Use any button to trigger a dropdown menu by placing it within a <code>.btn-group</code> and providing the proper menu markup. Requires the <a href="./javascript.html#dropdowns">Bootstrap dropdown plugin</a>.</p>
2804

Mark Otto's avatar
Mark Otto committed
2805
    <h3 id="btn-dropdowns-single">Single button dropdowns</h3>
Mark Otto's avatar
Mark Otto committed
2806
    <p>Turn a button into dropdown toggle with some basic markup changes.</p>
Mark Otto's avatar
Mark Otto committed
2807
2808
2809
2810
2811
2812
2813
2814
2815
2816
2817
2818
2819
2820
2821
2822
2823
2824
2825
2826
2827
2828
2829
2830
2831
2832
2833
2834
2835
2836
2837
2838
2839
2840
2841
2842
2843
2844
2845
2846
2847
2848
2849
2850
2851
2852
2853
2854
2855
2856
2857
2858
2859
    <div class="bs-docs-example">
      <div class="btn-toolbar" style="margin-bottom: 10px;">
        <div class="btn-group">
          <button class="btn dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
          <button class="btn btn-primary dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
          <button class="btn btn-danger dropdown-toggle" data-toggle="dropdown">Danger <span class="caret"></span></button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
          <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown">Warning <span class="caret"></span></button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
          <button class="btn btn-success dropdown-toggle" data-toggle="dropdown">Success <span class="caret"></span></button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
      </div>
Mark Otto's avatar
Mark Otto committed
2860
2861
2862
2863
2864
2865
2866
2867
2868
2869
2870
2871
2872
2873
2874
2875
    </div>
{% highlight html linenos %}
<!-- Single button -->
<div class="btn-group">
  <button class="btn dropdown-toggle" data-toggle="dropdown">
    Action <span class="caret"></span>
  </button>
  <ul class="dropdown-menu">
    <li><a href="#">Action</a></li>
    <li><a href="#">Another action</a></li>
    <li><a href="#">Something else here</a></li>
    <li class="divider"></li>
    <li><a href="#">Separated link</a></li>
  </ul>
</div>
{% endhighlight %}
Mark Otto's avatar
Mark Otto committed
2876

Mark Otto's avatar
Mark Otto committed
2877
    <h3 id="btn-dropdowns-split">Split button dropdowns</h3>
Mark Otto's avatar
Mark Otto committed
2878
2879
    <p>Similarly, create split button dropdowns with the same markup changes, only with a separate button.</p>
    <div class="bs-docs-example">
Mark Otto's avatar
Mark Otto committed
2880
2881
2882
2883
2884
2885
2886
2887
2888
2889
2890
2891
2892
2893
2894
2895
2896
2897
2898
2899
2900
2901
2902
2903
2904
2905
2906
2907
2908
2909
2910
2911
2912
2913
2914
2915
2916
2917
2918
2919
2920
2921
2922
2923
2924
2925
2926
2927
2928
2929
2930
2931
2932
2933
2934
2935
2936
2937
      <div class="btn-toolbar" style="margin: 0;">
        <div class="btn-group">
          <button class="btn">Action</button>
          <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
          <button class="btn btn-primary">Action</button>
          <button class="btn btn-primary dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
          <button class="btn btn-danger">Danger</button>
          <button class="btn btn-danger dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
          <button class="btn btn-warning">Warning</button>
          <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
          <button class="btn btn-success">Success</button>
          <button class="btn btn-success dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
      </div><!-- /btn-toolbar -->
    </div>
2938
2939
2940
2941
2942
2943
2944
2945
2946
2947
2948
2949
2950
2951
2952
2953
2954
{% highlight html linenos %}
<!-- Split button -->
<div class="btn-group">
  <button class="btn">Action</button>
  <button class="btn dropdown-toggle" data-toggle="dropdown">
    <span class="caret"></span>
  </button>
  <ul class="dropdown-menu">
    <li><a href="#">Action</a></li>
    <li><a href="#">Another action</a></li>
    <li><a href="#">Something else here</a></li>
    <li class="divider"></li>
    <li><a href="#">Separated link</a></li>
  </ul>
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
2955
    <h3 id="btn-dropdowns-sizes">Works with all button sizes</h3>
Mark Otto's avatar
Mark Otto committed
2956
2957
2958
2959
2960
2961
2962
2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
2977
2978
2979
2980
2981
2982
2983
2984
2985
2986
2987
2988
2989
2990
2991
2992
2993
2994
2995
2996
    <p>Button dropdowns work at any size: <code>.btn-large</code>, <code>.btn-small</code>, or <code>.btn-mini</code>.</p>
    <div class="bs-docs-example">
      <div class="btn-toolbar" style="margin: 0;">
        <div class="btn-group">
          <button class="btn btn-large dropdown-toggle" type="button" data-toggle="dropdown">
            Large button <span class="caret"></span>
          </button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
          <button class="btn btn-small dropdown-toggle" type="button" data-toggle="dropdown">
            Small button <span class="caret"></span>
          </button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
        <div class="btn-group">
          <button class="btn btn-mini dropdown-toggle" type="button" data-toggle="dropdown">
            Mini button <span class="caret"></span>
          </button>
          <ul class="dropdown-menu">
            <li><a href="#">Action</a></li>
            <li><a href="#">Another action</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Separated link</a></li>
          </ul>
        </div><!-- /btn-group -->
      </div><!-- /btn-toolbar -->
    </div><!-- /example -->
2997
2998
2999
3000
{% highlight html linenos %}
<!-- Large button group -->
<div class="btn-group">
  <button class="btn btn-large dropdown-toggle" type="button" data-toggle="dropdown">
For faster browsing, not all history is shown. View entire blame