docs.html 263 KB
Newer Older
3001
3002
3003
3004
3005
3006
3007
3008
3009
3010
3011
3012
3013
3014
3015
3016
3017
3018
3019
3020
3021
3022
3023
3024
3025
3026
3027
3028
    Large button <span class="caret"></span>
  </button>
  <ul class="dropdown-menu">
    ...
  </ul>
</div>

<!-- Small button 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">
    ...
  </ul>
</div>

<!-- Mini button 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">
    ...
  </ul>
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3029
    <h3 id="btn-dropdowns-dropup">Dropup buttons</h3>
Mark Otto's avatar
Mark Otto committed
3030
3031
3032
3033
3034
3035
3036
3037
3038
3039
3040
3041
3042
3043
3044
3045
3046
3047
3048
3049
3050
3051
3052
3053
3054
3055
3056
    <p>Trigger dropdown menus above elements by adding <code>.dropup</code> to the parent.</p>
    <div class="bs-docs-example">
      <div class="btn-toolbar">
        <div class="btn-group dropup">
          <button class="btn">Dropup</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 dropup">
          <button class="btn primary">Right dropup</button>
          <button class="btn primary dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
          <ul class="dropdown-menu pull-right">
            <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>
    </div><!-- /example -->
3057
3058
3059
3060
3061
3062
3063
3064
3065
3066
3067
3068
{% highlight html linenos %}
<div class="btn-group dropup">
  <button class="btn">Dropup</button>
  <button class="btn dropdown-toggle" data-toggle="dropdown">
    <span class="caret"></span>
  </button>
  <ul class="dropdown-menu">
    <!-- Dropdown menu links -->
  </ul>
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3069
  </div>
3070
3071
3072



Mark Otto's avatar
Mark Otto committed
3073
3074
  <!-- Navs
  ================================================== -->
Mark Otto's avatar
Mark Otto committed
3075
  <div class="bs-docs-section" id="nav">
Mark Otto's avatar
Mark Otto committed
3076
3077
3078
    <div class="page-header">
      <h1>Navs</small></h1>
    </div>
3079

Mark Otto's avatar
Mark Otto committed
3080
    <p class="lead">Navs available in Bootstrap have shared markup, starting with the base <code>.nav</code> class, as well as shared states. Swap modifier classes to switch between each style.</p>
3081

Mark Otto's avatar
Mark Otto committed
3082
    <h2 id="nav-tabs">Tabs</h2>
Mark Otto's avatar
Mark Otto committed
3083
3084
3085
3086
3087
3088
3089
3090
    <p>Note the <code>.nav-tabs</code> class requires the <code>.nav</code> base class.</p>
    <div class="bs-docs-example">
      <ul class="nav nav-tabs">
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
      </ul>
    </div>
3091
3092
3093
3094
3095
3096
3097
3098
{% highlight html linenos %}
<ul class="nav nav-tabs">
  <li class="active"><a href="#">Home</a></li>
  <li><a href="#">Profile</a></li>
  <li><a href="#">Messages</a></li>
</ul>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3099
    <h2 id="nav-pills">Pills</h2>
Mark Otto's avatar
Mark Otto committed
3100
3101
3102
3103
3104
3105
3106
3107
    <p>Take that same HTML, but use <code>.nav-pills</code> instead:</p>
    <div class="bs-docs-example">
      <ul class="nav nav-pills">
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
      </ul>
    </div>
3108
3109
3110
3111
3112
3113
3114
{% highlight html linenos %}
<ul class="nav nav-pills">
  <li class="active"><a href="#">Home</a></li>
  <li><a href="#">Profile</a></li>
  <li><a href="#">Messages</a></li>
</ul>
{% endhighlight %}
Mark Otto's avatar
Mark Otto committed
3115
3116
3117
3118
3119
3120
3121
3122
    <p>Pills are also vertically stackable. Just add <code>.nav-stacked</code>.</p>
    <div class="bs-docs-example">
      <ul class="nav nav-pills nav-stacked" style="max-width: 300px;">
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
      </ul>
    </div>
3123
3124
3125
3126
3127
3128
{% highlight html linenos %}
<ul class="nav nav-pills nav-stacked">
  ...
</ul>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3129
    <h2>Options</h2>
3130

Mark Otto's avatar
Mark Otto committed
3131
    <h3 id="nav-justified">Justified links</h3>
Mark Otto's avatar
Mark Otto committed
3132
3133
3134
3135
3136
3137
3138
3139
3140
3141
3142
3143
3144
3145
    <p>Easily make tabs or pills equal widths of their parent with <code>.nav-justified</code>.</p>
    <div class="bs-docs-example">
      <ul class="nav nav-tabs nav-justified">
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
      </ul>
      <br>
      <ul class="nav nav-pills nav-justified">
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
      </ul>
    </div>
3146
3147
3148
3149
3150
3151
3152
3153
3154
{% highlight html linenos %}
<ul class="nav nav-tabs nav-justified">
  ...
</ul>
<ul class="nav nav-pills nav-justified">
  ...
</ul>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3155
    <h3 id="nav-disabled-links">Disabled state</h3>
Mark Otto's avatar
Mark Otto committed
3156
3157
3158
3159
3160
3161
3162
3163
    <p>For any nav component (tabs, pills, or list), add <code>.disabled</code> for <strong>gray links and no hover effects</strong>. Links will remain clickable, however, unless you remove the <code>href</code> attribute. Alternatively, you could implement custom JavaScript to prevent those clicks.</p>
    <div class="bs-docs-example">
      <ul class="nav nav-pills">
        <li><a href="#">Clickable link</a></li>
        <li><a href="#">Clickable link</a></li>
        <li class="disabled"><a href="#">Disabled link</a></li>
      </ul>
    </div>
3164
3165
3166
3167
3168
3169
3170
3171
3172
{% highlight html linenos %}
<ul class="nav nav-tabs">
  ...
  <li class="disabled"><a href="#">Disabled link</a></li>
  ...
</ul>
{% endhighlight %}


Mark Otto's avatar
Mark Otto committed
3173
    <h3 id="nav-alignment">Component alignment</h3>
Mark Otto's avatar
Mark Otto committed
3174
    <p>To align nav links, use the <code>.pull-left</code> or <code>.pull-right</code> utility classes. Both classes will add a CSS float in the specified direction.</p>
3175
3176


Mark Otto's avatar
Mark Otto committed
3177
    <hr class="bs-docs-separator">
3178
3179


Mark Otto's avatar
Mark Otto committed
3180
    <h2 id="nav-dropdowns">Dropdowns</h2>
Mark Otto's avatar
Mark Otto committed
3181
    <p>Add dropdown menus with a little extra HTML and the <a href="./javascript.html#dropdowns">dropdowns JavaScript plugin</a>.</p>
3182

Mark Otto's avatar
Mark Otto committed
3183
3184
3185
3186
3187
3188
3189
3190
3191
3192
3193
3194
3195
3196
3197
3198
3199
3200
3201
    <h3>Tabs with dropdowns</h3>
    <div class="bs-docs-example">
      <ul class="nav nav-tabs">
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Help</a></li>
        <li class="dropdown">
          <a class="dropdown-toggle" data-toggle="dropdown" href="#">
            Dropdown <span class="caret"></span>
          </a>
          <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>
        </li>
      </ul>
    </div>
3202
3203
3204
3205
3206
3207
3208
3209
3210
3211
3212
3213
3214
3215
3216
{% highlight html linenos %}
<ul class="nav nav-tabs">
  ...
  <li class="dropdown">
    <a class="dropdown-toggle" data-toggle="dropdown" href="#">
      Dropdown <span class="caret"></span>
    </a>
    <ul class="dropdown-menu">
      ...
    </ul>
  </li>
  ...
</ul>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3217
3218
3219
3220
3221
3222
3223
3224
3225
3226
3227
3228
3229
3230
3231
3232
3233
3234
3235
    <h3>Pills with dropdowns</h3>
    <div class="bs-docs-example">
      <ul class="nav nav-pills">
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Help</a></li>
        <li class="dropdown">
          <a class="dropdown-toggle" data-toggle="dropdown" href="#">
            Dropdown <span class="caret"></span>
          </a>
          <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>
        </li>
      </ul>
    </div><!-- /example -->
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
3249
3250
{% highlight html linenos %}
<ul class="nav nav-pills">
  ...
  <li class="dropdown">
    <a class="dropdown-toggle" data-toggle="dropdown" href="#">
      Dropdown <span class="caret"></span>
    </a>
    <ul class="dropdown-menu">
      ...
    </ul>
  </li>
  ...
</ul>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3251
  </div>
3252
3253
3254



Mark Otto's avatar
Mark Otto committed
3255
3256
3257
3258
3259
3260
  <!-- Navbar
  ================================================== -->
  <div class="bs-docs-section" id="navbar">
    <div class="page-header">
      <h1>Navbar</h1>
    </div>
3261
3262


Mark Otto's avatar
Mark Otto committed
3263
    <h2 id="navbar-basic">Basic navbar</h2>
Mark Otto's avatar
Mark Otto committed
3264
3265
3266
3267
3268
3269
3270
3271
3272
3273
3274
    <p>To start, navbars are static (not fixed to the top) and include support for a project name and basic navigation. Place one anywhere within a <code>.container</code>, which sets the width of your site and content.</p>
    <div class="bs-docs-example">
      <div class="navbar">
        <a class="navbar-brand" href="#">Title</a>
        <ul class="nav">
          <li class="active"><a href="#">Home</a></li>
          <li><a href="#">Link</a></li>
          <li><a href="#">Link</a></li>
        </ul>
      </div>
    </div><!-- /example -->
3275
3276
3277
3278
3279
3280
3281
3282
3283
3284
3285
{% highlight html linenos %}
<div class="navbar">
  <a class="navbar-brand" href="#">Title</a>
  <ul class="nav">
    <li class="active"><a href="#">Home</a></li>
    <li><a href="#">Link</a></li>
    <li><a href="#">Link</a></li>
  </ul>
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3286
    <h2>Navbar components</h2>
3287

Mark Otto's avatar
Mark Otto committed
3288
    <h3 id="navbar-brand">Brand</h3>
Mark Otto's avatar
Mark Otto committed
3289
3290
3291
3292
3293
3294
    <p>A simple link to show your brand or project name only requires an anchor tag.</p>
    <div class="bs-docs-example">
      <div class="navbar">
        <a class="navbar-brand" href="#">Title</a>
      </div>
    </div><!-- /example -->
3295
3296
3297
3298
{% highlight html linenos %}
<a class="navbar-brand" href="#">Title</a>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3299
    <h3 id="navbar-nav">Nav links</h3>
Mark Otto's avatar
Mark Otto committed
3300
3301
3302
3303
3304
3305
3306
3307
3308
3309
    <p>Nav items are simple to add via unordered lists.</p>
    <div class="bs-docs-example">
      <div class="navbar">
        <ul class="nav">
          <li class="active"><a href="#">Home</a></li>
          <li><a href="#">Link</a></li>
          <li class="disabled"><a href="#">Disabled</a></li>
        </ul>
      </div>
    </div><!-- /example -->
3310
3311
3312
3313
3314
3315
3316
{% highlight html linenos %}
<ul class="nav">
  <li class="active"><a href="#">Home</a></li>
  <li><a href="#">Link</a></li>
  <li class="disabled"><a href="#">Disabled</a></li>
</ul>
{% endhighlight %}
Mark Otto's avatar
Mark Otto committed
3317
3318
3319
3320
3321
3322
3323
3324
3325
3326
3327
3328
3329
    <p>You can easily add dividers to your nav links with an empty list item and a simple class. Just add the appropriate class to <code>&lt;li&gt;</code> elements between links. Dividers will be horizontal to start, but at resolutions above 768px they become vertical with the navigation.</p>
    <div class="bs-docs-example">
      <div class="navbar">
        <ul class="nav">
          <li class="active"><a href="#">Home</a></li>
          <li class="divider"></li>
          <li><a href="#">Link</a></li>
          <li class="divider"></li>
          <li><a href="#">Link</a></li>
          <li class="divider"></li>
        </ul>
      </div>
    </div><!-- /example -->
3330
3331
3332
3333
3334
3335
3336
3337
{% highlight html linenos %}
<ul class="nav">
  ...
  <li class="divider"></li>
  ...
</ul>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3338
    <h3 id="navbar-forms">Forms</h3>
Mark Otto's avatar
Mark Otto committed
3339
3340
3341
3342
3343
3344
3345
3346
3347
    <p>To properly style and position a form within the navbar, add the appropriate classes as shown below. For a default form, include <code>.navbar-form</code> and either <code>.pull-left</code> or <code>.pull-right</code> to properly align it.</p>
    <div class="bs-docs-example">
      <div class="navbar">
        <form class="navbar-form pull-left">
          <input type="text" style="width: 200px;">
          <button type="submit" class="btn">Submit</button>
        </form>
      </div>
    </div><!-- /example -->
3348
3349
3350
3351
3352
3353
3354
{% highlight html linenos %}
<form class="navbar-form pull-left">
  <input type="text" style="width: 200px;">
  <button type="submit" class="btn">Submit</button>
</form>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3355
3356
    <h3>Component alignment</h3>
    <p>Align nav links, search form, or text, use the <code>.pull-left</code> or <code>.pull-right</code> utility classes. Both classes will add a CSS float in the specified direction.</p>
3357

Mark Otto's avatar
Mark Otto committed
3358
3359
    <h3>Using dropdowns</h3>
    <p>Add dropdowns and dropups to the nav with a bit of markup and the <a href="./javascript.html#dropdowns">dropdowns JavaScript plugin</a>.</p>
3360

Mark Otto's avatar
Mark Otto committed
3361
3362
    <h3>Text</h3>
    <p>Wrap strings of text in an element with <code>.navbar-text</code>, usually on a <code>&lt;p&gt;</code> tag for proper leading and color.</p>
3363
3364


Mark Otto's avatar
Mark Otto committed
3365
3366
    <h2>Optional display variations</h2>
    <p>Fix the navbar to the top or bottom of the viewport with an additional class on the outermost div, <code>.navbar</code>.</p>
3367

Mark Otto's avatar
Mark Otto committed
3368
    <h3 id="navbar-fixed-top">Fixed to top</h3>
Mark Otto's avatar
Mark Otto committed
3369
3370
3371
3372
3373
3374
3375
3376
3377
3378
3379
3380
3381
    <p>Add <code>.navbar-fixed-top</code> and remember to account for the hidden area underneath it by adding at least 40px <code>padding</code> to the <code>&lt;body&gt;</code>. Be sure to add this after the core Bootstrap CSS and before the optional responsive CSS.</p>
    <div class="bs-docs-example bs-navbar-top-example">
      <div class="navbar navbar-fixed-top" style="position: absolute; top: -1px;">
        <div class="container" style="width: auto;">
          <a class="navbar-brand" href="#">Title</a>
          <ul class="nav">
            <li class="active"><a href="#">Home</a></li>
            <li><a href="#">Link</a></li>
            <li><a href="#">Link</a></li>
          </ul>
        </div>
      </div>
    </div><!-- /example -->
3382
3383
3384
3385
3386
3387
{% highlight html linenos %}
<div class="navbar navbar-fixed-top">
  ...
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3388
    <h3 id="navbar-fixed-bottom">Fixed to bottom</h3>
Mark Otto's avatar
Mark Otto committed
3389
3390
3391
3392
3393
3394
3395
3396
3397
3398
3399
3400
3401
    <p>Add <code>.navbar-fixed-bottom</code> instead.</p>
    <div class="bs-docs-example bs-navbar-bottom-example">
      <div class="navbar navbar-fixed-bottom" style="position: absolute; bottom: -1px;">
        <div class="container" style="width: auto;">
          <a class="navbar-brand" href="#">Title</a>
          <ul class="nav">
            <li class="active"><a href="#">Home</a></li>
            <li><a href="#">Link</a></li>
            <li><a href="#">Link</a></li>
          </ul>
        </div>
      </div>
    </div><!-- /example -->
3402
3403
3404
3405
3406
3407
{% highlight html linenos %}
<div class="navbar navbar-fixed-bottom">
  ...
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3408
    <h3 id="navbar-static-top">Static top navbar</h3>
Mark Otto's avatar
Mark Otto committed
3409
3410
3411
3412
3413
3414
3415
3416
3417
3418
3419
3420
3421
    <p>Create a full-width navbar that scrolls away with the page by adding <code>.navbar-static-top</code>. Unlike the <code>.navbar-fixed-top</code> class, you do not need to change any padding on the <code>body</code>.</p>
    <div class="bs-docs-example bs-navbar-top-example">
      <div class="navbar navbar-static-top" style="margin: -1px -1px 0;">
        <div class="container" style="width: auto;">
          <a class="navbar-brand" href="#">Title</a>
          <ul class="nav">
            <li class="active"><a href="#">Home</a></li>
            <li><a href="#">Link</a></li>
            <li><a href="#">Link</a></li>
          </ul>
        </div>
      </div>
    </div><!-- /example -->
3422
3423
3424
3425
3426
3427
3428
{% highlight html linenos %}
<div class="navbar navbar-static-top">
  ...
</div>
{% endhighlight %}


Mark Otto's avatar
Mark Otto committed
3429
    <h2 id="navbar-responsive">Responsive navbar</h2>
Mark Otto's avatar
Mark Otto committed
3430
3431
3432
3433
3434
3435
3436
3437
3438
3439
3440
3441
3442
3443
3444
3445
3446
3447
3448
3449
3450
3451
3452
3453
3454
3455
3456
3457
3458
3459
3460
3461
3462
3463
3464
3465
3466
3467
3468
3469
3470
3471
3472
3473
3474
3475
3476
3477
3478
    <p>To implement a collapsing responsive navbar, wrap your navbar content in a containing div, <code>.nav-collapse.collapse</code>, and add the navbar toggle button, <code>.navbar-toggle</code>.</p>
    <div class="bs-docs-example">
      <div class="navbar">
        <div class="container">
          <a class="navbar-toggle" data-toggle="collapse" data-target=".navbar-responsive-collapse">
            <span class="icon-bar"></span>
            <span class="icon-bar"></span>
            <span class="icon-bar"></span>
          </a>
          <a class="navbar-brand" href="#">Title</a>
          <div class="nav-collapse collapse navbar-responsive-collapse">
            <ul class="nav">
              <li class="active"><a href="#">Home</a></li>
              <li><a href="#">Link</a></li>
              <li><a href="#">Link</a></li>
              <li class="dropdown">
                <a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown <b class="caret"></b></a>
                <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 class="nav-header">Nav header</li>
                  <li><a href="#">Separated link</a></li>
                  <li><a href="#">One more separated link</a></li>
                </ul>
              </li>
            </ul>
            <form class="navbar-form pull-left" action="">
              <input type="text" class="span8" placeholder="Search">
            </form>
            <ul class="nav pull-right">
              <li><a href="#">Link</a></li>
              <li class="divider"></li>
              <li class="dropdown">
                <a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown <b class="caret"></b></a>
                <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>
              </li>
            </ul>
          </div><!-- /.nav-collapse -->
        </div><!-- /.container -->
      </div><!-- /.navbar -->
    </div><!-- /example -->
3479
3480
3481
3482
3483
3484
3485
3486
3487
3488
3489
3490
3491
3492
3493
3494
3495
3496
3497
3498
3499
3500
{% highlight html linenos %}
<div class="navbar">
  <div class="container">

    <!-- .navbar-toggle is used as the toggle for collapsed navbar content -->
    <a class="navbar-toggle" data-toggle="collapse" data-target=".navbar-responsive-collapse">
      <span class="icon-bar"></span>
      <span class="icon-bar"></span>
      <span class="icon-bar"></span>
    </a>

    <!-- Be sure to leave the brand out there if you want it shown -->
    <a class="navbar-brand" href="#">Title</a>

    <!-- Place everything within .navbar-collapse to hide it until above 768px -->
    <div class="nav-collapse collapse navbar-responsive-collapse">
      ...
    </div><!-- /.nav-collapse -->
  </div><!-- /.container -->
</div><!-- /.navbar -->
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3501
3502
3503
    <div class="alert alert-info">
      <strong>Heads up!</strong> The responsive navbar requires the <a href="./javascript.html#collapse">collapse plugin</a> and <a href="./scaffolding.html#responsive">responsive Bootstrap CSS file</a>.
    </div>
3504
3505


Mark Otto's avatar
Mark Otto committed
3506
3507
3508
3509
3510
3511
3512
3513
3514
3515
3516
3517
3518
3519
3520
3521
3522
3523
3524
3525
3526
3527
3528
3529
3530
3531
3532
3533
3534
3535
3536
3537
3538
3539
3540
3541
3542
3543
3544
3545
3546
3547
3548
3549
3550
3551
3552
3553
3554
3555
    <h2>Inverted variation</h2>
    <p>Modify the look of the navbar by adding <code>.navbar-inverse</code>.</p>
    <div class="bs-docs-example">
      <div class="navbar navbar-inverse" style="position: static;">
        <div class="container">
          <a class="navbar-toggle" data-toggle="collapse" data-target=".navbar-inverse-collapse">
            <span class="icon-bar"></span>
            <span class="icon-bar"></span>
            <span class="icon-bar"></span>
          </a>
          <a class="navbar-brand" href="#">Title</a>
          <div class="nav-collapse collapse navbar-inverse-collapse">
            <ul class="nav">
              <li class="active"><a href="#">Home</a></li>
              <li><a href="#">Link</a></li>
              <li><a href="#">Link</a></li>
              <li class="dropdown">
                <a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown <b class="caret"></b></a>
                <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 class="nav-header">Nav header</li>
                  <li><a href="#">Separated link</a></li>
                  <li><a href="#">One more separated link</a></li>
                </ul>
              </li>
            </ul>
            <form class="navbar-form pull-left" action="">
              <input type="text" class="span8" placeholder="Search">
            </form>
            <ul class="nav pull-right">
              <li><a href="#">Link</a></li>
              <li class="divider"></li>
              <li class="dropdown">
                <a href="#" class="dropdown-toggle" data-toggle="dropdown">Dropdown <b class="caret"></b></a>
                <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>
              </li>
            </ul>
          </div><!-- /.nav-collapse -->
        </div>
      </div><!-- /navbar -->
    </div><!-- /example -->
3556
3557
3558
3559
3560
3561
{% highlight html linenos %}
<div class="navbar navbar-inverse">
  ...
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3562
  </div>
3563
3564
3565



Mark Otto's avatar
Mark Otto committed
3566
3567
3568
3569
3570
3571
3572
  <!-- Breadcrumbs
  ================================================== -->
  <div class="bs-docs-section" id="breadcrumbs">
    <div class="page-header">
      <h1>Breadcrumbs <small></small></h1>
    </div>
    <p class="lead">Indicate the current page's location within a navigational hierarchy.</p>
3573

Mark Otto's avatar
Mark Otto committed
3574
3575
3576
3577
3578
3579
3580
3581
3582
3583
3584
3585
3586
3587
    <div class="bs-docs-example">
      <ul class="breadcrumb">
        <li class="active">Home</li>
      </ul>
      <ul class="breadcrumb">
        <li><a href="#">Home</a></li>
        <li class="active">Library</li>
      </ul>
      <ul class="breadcrumb" style="margin-bottom: 5px;">
        <li><a href="#">Home</a></li>
        <li><a href="#">Library</a></li>
        <li class="active">Data</li>
      </ul>
    </div>
3588
3589
3590
3591
3592
3593
3594
{% highlight html linenos %}
<ul class="breadcrumb">
  <li><a href="#">Home</a></li>
  <li><a href="#">Library</a></li>
  <li class="active">Data</li>
</ul>
{% endhighlight %}
Mark Otto's avatar
Mark Otto committed
3595
  </div>
3596
3597
3598



Mark Otto's avatar
Mark Otto committed
3599
3600
3601
3602
3603
3604
3605
  <!-- Pagination
  ================================================== -->
  <div class="bs-docs-section" id="pagination">
    <div class="page-header">
      <h1>Pagination</h1>
    </div>
    <p class="lead">Provide pagination links for your site or app with the multi-page pagination component, or the simpler <a href="./components.html#pagination-pager">pager alternative</a>.</p>
3606

Mark Otto's avatar
Mark Otto committed
3607
3608
3609
3610
3611
3612
3613
3614
3615
3616
3617
3618
3619
    <h2 id="pagination-default">Standard pagination</h2>
    <p>Simple pagination inspired by Rdio, great for apps and search results. The large block is hard to miss, easily scalable, and provides large click areas.</p>
    <div class="bs-docs-example">
      <ul class="pagination">
        <li><a href="#">&laquo;</a></li>
        <li><a href="#">1</a></li>
        <li><a href="#">2</a></li>
        <li><a href="#">3</a></li>
        <li><a href="#">4</a></li>
        <li><a href="#">5</a></li>
        <li><a href="#">&raquo;</a></li>
      </ul>
    </div>
3620
3621
3622
3623
3624
3625
3626
3627
3628
3629
3630
3631
{% highlight html linenos %}
<ul class="pagination">
  <li><a href="#">&laquo;</a></li>
  <li><a href="#">1</a></li>
  <li><a href="#">2</a></li>
  <li><a href="#">3</a></li>
  <li><a href="#">4</a></li>
  <li><a href="#">5</a></li>
  <li><a href="#">&raquo;</a></li>
</ul>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3632
3633
3634
3635
3636
3637
3638
3639
3640
3641
3642
3643
3644
    <h3>Disabled and active states</h3>
    <p>Links are customizable for different circumstances. Use <code>.disabled</code> for unclickable links and <code>.active</code> to indicate the current page.</p>
    <div class="bs-docs-example">
      <ul class="pagination">
        <li class="disabled"><a href="#">&laquo;</a></li>
        <li class="active"><a href="#">1</a></li>
        <li><a href="#">2</a></li>
        <li><a href="#">3</a></li>
        <li><a href="#">4</a></li>
        <li><a href="#">5</a></li>
        <li><a href="#">&raquo;</a></li>
     </ul>
    </div>
3645
3646
3647
3648
3649
3650
3651
{% highlight html linenos %}
<ul class="pagination">
  <li class="disabled"><a href="#">&laquo;</a></li>
  <li class="active"><a href="#">1</a></li>
  ...
</ul>
{% endhighlight %}
Mark Otto's avatar
Mark Otto committed
3652
    <p>You can optionally swap out active or disabled anchors for <code>&lt;span&gt;</code> to remove click functionality while retaining intended styles.</p>
3653
3654
3655
3656
3657
3658
3659
3660
3661
{% highlight html linenos %}
<ul class="pagination">
  <li class="disabled"><span>&laquo;</span></li>
  <li class="active"><span>1</span></li>
  ...
</ul>
{% endhighlight %}


Mark Otto's avatar
Mark Otto committed
3662
3663
3664
3665
3666
3667
3668
3669
3670
3671
3672
3673
3674
3675
3676
3677
3678
3679
3680
3681
3682
3683
3684
3685
3686
3687
3688
3689
3690
3691
3692
3693
3694
3695
3696
3697
3698
3699
3700
3701
3702
3703
3704
3705
3706
3707
3708
3709
    <h3>Sizes</h3>
    <p>Fancy larger or smaller pagination? Add <code>.pagination-large</code>, <code>.pagination-small</code>, or <code>.pagination-mini</code> for additional sizes.</p>
    <div class="bs-docs-example">
      <div>
        <ul class="pagination pagination-large">
          <li><a href="#">&laquo;</a></li>
          <li><a href="#">1</a></li>
          <li><a href="#">2</a></li>
          <li><a href="#">3</a></li>
          <li><a href="#">4</a></li>
          <li><a href="#">5</a></li>
          <li><a href="#">&raquo;</a></li>
        </ul>
      </div>
      <div>
        <ul class="pagination">
          <li><a href="#">&laquo;</a></li>
          <li><a href="#">1</a></li>
          <li><a href="#">2</a></li>
          <li><a href="#">3</a></li>
          <li><a href="#">4</a></li>
          <li><a href="#">5</a></li>
          <li><a href="#">&raquo;</a></li>
        </ul>
      </div>
      <div>
        <ul class="pagination pagination-small">
          <li><a href="#">&laquo;</a></li>
          <li><a href="#">1</a></li>
          <li><a href="#">2</a></li>
          <li><a href="#">3</a></li>
          <li><a href="#">4</a></li>
          <li><a href="#">5</a></li>
          <li><a href="#">&raquo;</a></li>
        </ul>
      </div>
      <div>
        <ul class="pagination pagination-mini">
          <li><a href="#">&laquo;</a></li>
          <li><a href="#">1</a></li>
          <li><a href="#">2</a></li>
          <li><a href="#">3</a></li>
          <li><a href="#">4</a></li>
          <li><a href="#">5</a></li>
          <li><a href="#">&raquo;</a></li>
        </ul>
      </div>
    </div>
3710
3711
3712
3713
3714
3715
3716
3717
{% highlight html linenos %}
<ul class="pagination pagination-large">...</ul>
<ul class="pagination pagination">...</ul>
<ul class="pagination pagination-small">...</ul>
<ul class="pagination pagination-mini">...</ul>
{% endhighlight %}


Mark Otto's avatar
Mark Otto committed
3718
3719
    <h2 id="pagination-pager">Pager</h2>
    <p>Quick previous and next links for simple pagination implementations with light markup and styles. It's great for simple sites like blogs or magazines.</p>
3720

Mark Otto's avatar
Mark Otto committed
3721
3722
3723
3724
3725
3726
3727
3728
    <h3>Default example</h3>
    <p>By default, the pager centers links.</p>
    <div class="bs-docs-example">
      <ul class="pager">
        <li><a href="#">Previous</a></li>
        <li><a href="#">Next</a></li>
      </ul>
    </div>
3729
3730
3731
3732
3733
3734
3735
{% highlight html linenos %}
<ul class="pager">
  <li><a href="#">Previous</a></li>
  <li><a href="#">Next</a></li>
</ul>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3736
3737
3738
3739
3740
3741
3742
3743
    <h3>Aligned links</h3>
    <p>Alternatively, you can align each link to the sides:</p>
    <div class="bs-docs-example">
      <ul class="pager">
        <li class="previous"><a href="#">&larr; Older</a></li>
        <li class="next"><a href="#">Newer &rarr;</a></li>
      </ul>
    </div>
3744
3745
3746
3747
3748
3749
3750
3751
{% highlight html linenos %}
<ul class="pager">
  <li class="previous"><a href="#">&larr; Older</a></li>
  <li class="next"><a href="#">Newer &rarr;</a></li>
</ul>
{% endhighlight %}


Mark Otto's avatar
Mark Otto committed
3752
3753
3754
3755
3756
3757
3758
3759
    <h3>Optional disabled state</h3>
    <p>Pager links also use the general <code>.disabled</code> utility class from the pagination.</p>
    <div class="bs-docs-example">
      <ul class="pager">
        <li class="previous disabled"><a href="#">&larr; Older</a></li>
        <li class="next"><a href="#">Newer &rarr;</a></li>
      </ul>
    </div>
3760
3761
3762
3763
3764
3765
{% highlight html linenos %}
<ul class="pager">
  <li class="previous disabled"><a href="#">&larr; Older</a></li>
  <li class="next"><a href="#">Newer &rarr;</a></li>
</ul>
{% endhighlight %}
Mark Otto's avatar
Mark Otto committed
3766
  </div>
3767
3768
3769



Mark Otto's avatar
Mark Otto committed
3770
3771
3772
3773
3774
3775
3776
  <!-- Labels
  ================================================== -->
  <div class="bs-docs-section" id="labels">
    <div class="page-header">
      <h1>Labels</h1>
    </div>
    <p class="lead"></p>
3777

Mark Otto's avatar
Mark Otto committed
3778
3779
3780
3781
3782
3783
3784
3785
3786
    <h3>Example</h3>
    <div class="bs-docs-example">
      <h1>Example heading <span class="label">New</span></h1>
      <h2>Example heading <span class="label">New</span></h2>
      <h3>Example heading <span class="label">New</span></h3>
      <h4>Example heading <span class="label">New</span></h4>
      <h5>Example heading <span class="label">New</span></h5>
      <h6>Example heading <span class="label">New</span></h6>
    </div>
3787
3788
3789
3790
{% highlight html linenos %}
<h3>Example heading <span class="label">New</span></h3>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3791
3792
3793
3794
3795
3796
3797
3798
3799
3800
3801
3802
3803
3804
3805
3806
3807
3808
3809
3810
3811
3812
3813
3814
3815
3816
3817
3818
3819
3820
3821
3822
3823
3824
3825
3826
3827
3828
3829
3830
3831
3832
3833
3834
3835
3836
3837
3838
3839
3840
3841
3842
    <h3>Available variations</h3>
    <p>Add any of the below mentioned modifier classes to change the appearance of a label.</p>
    <table class="table table-bordered table-striped">
      <thead>
        <tr>
          <th>Labels</th>
          <th>Markup</th>
        </tr>
      </thead>
      <tbody>
        <tr>
          <td>
            <span class="label">Default</span>
          </td>
          <td>
            <code>&lt;span class="label"&gt;Default&lt;/span&gt;</code>
          </td>
        </tr>
        <tr>
          <td>
            <span class="label label-success">Success</span>
          </td>
          <td>
            <code>&lt;span class="label label-success"&gt;Success&lt;/span&gt;</code>
          </td>
        </tr>
        <tr>
          <td>
            <span class="label label-warning">Warning</span>
          </td>
          <td>
            <code>&lt;span class="label label-warning"&gt;Warning&lt;/span&gt;</code>
          </td>
        </tr>
        <tr>
          <td>
            <span class="label label-danger">Danger</span>
          </td>
          <td>
            <code>&lt;span class="label label-danger"&gt;Danger&lt;/span&gt;</code>
          </td>
        </tr>
        <tr>
          <td>
            <span class="label label-info">Info</span>
          </td>
          <td>
            <code>&lt;span class="label label-info"&gt;Info&lt;/span&gt;</code>
          </td>
        </tr>
      </tbody>
    </table>
3843

Mark Otto's avatar
Mark Otto committed
3844
3845
3846
3847
3848
3849
3850
3851
3852
3853
3854
3855
3856
3857
3858
  </div>



  <!-- Badges
  ================================================== -->
  <div class="bs-docs-section" id="badges">
    <div class="page-header">
      <h1>Badges</h1>
    </div>
    <p class="lead">Easily highlight new or unread items by adding a <code>&lt;span class="badge"&gt;</code> to links, Bootstrap navs, and more.</p>

    <div class="bs-docs-example">
      <a href="#">Inbox <span class="badge">42</span></a>
    </div>
3859
3860
3861
3862
{% highlight html linenos %}
<a href="#">Inbox <span class="badge">42</span></a>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3863
3864
    <h4>Self collapsing</h4>
    <p>When there are no new or unread items, badges will simply collapse (via CSS's <code>:empty</code> selector) provided no content exists within.</p>
3865

Mark Otto's avatar
Mark Otto committed
3866
3867
3868
3869
3870
3871
3872
3873
3874
    <h4>Adapts to active nav states</h4>
    <p>Built-in styles are included for placing badges in active states in pill and list navigations.</p>
    <div class="bs-docs-example">
      <ul class="nav nav-pills">
        <li class="active"><a href="#">Home <span class="badge">42</span></a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages <span class="badge">3</span></a></li>
      </ul>
      <br>
3875
      <ul class="nav nav-pills nav-stacked" style="max-width: 260px;">
Mark Otto's avatar
Mark Otto committed
3876
3877
3878
3879
3880
3881
3882
3883
3884
3885
3886
3887
3888
3889
3890
        <li class="active">
          <a href="#">
            <span class="badge pull-right">42</span>
            Home
          </a>
        </li>
        <li><a href="#">Profile</a></li>
        <li>
          <a href="#">
            <span class="badge pull-right">3</span>
            Messages
          </a>
        </li>
      </ul>
    </div>
3891
3892
3893
3894
3895
3896
3897
3898
3899
3900
3901
{% highlight html linenos %}
<ul class="nav nav-list">
  <li class="active">
    <a href="#">
      <span class="badge pull-right">42</span>
      Home
    </a>
  </li>
  ...
</ul>
{% endhighlight %}
Mark Otto's avatar
Mark Otto committed
3902
  </div>
3903
3904
3905



Mark Otto's avatar
Mark Otto committed
3906
3907
3908
3909
3910
3911
  <!-- Typographic components
  ================================================== -->
  <div class="bs-docs-section" id="type-components">
    <div class="page-header">
      <h1>Typographic components</h1>
    </div>
3912

Mark Otto's avatar
Mark Otto committed
3913
3914
3915
3916
3917
3918
3919
3920
3921
    <h2 id="type-components-jumbotron">Jumbotron</h2>
    <p>A lightweight, flexible component to showcase key content on your site. It works well on marketing and content-heavy sites.</p>
    <div class="bs-docs-example">
      <div class="jumbotron">
        <h1>Hello, world!</h1>
        <p>This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.</p>
        <p><a class="btn btn-primary btn-large">Learn more</a></p>
      </div>
    </div>
3922
3923
3924
3925
3926
3927
3928
3929
{% highlight html linenos %}
<div class="jumbotron">
  <h1>Hello, world!</h1>
  <p>...</p>
  <p><a class="btn btn-primary btn-large">Learn more</a></p>
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3930
3931
3932
3933
3934
3935
3936
    <h2 id="type-components-page-header">Page header</h2>
    <p>A simple shell for an <code>h1</code> to appropriately space out and segment sections of content on a page. It can utilize the <code>h1</code>'s default <code>small</code>, element as well most other components (with additional styles).</p>
    <div class="bs-docs-example">
      <div class="page-header">
        <h1>Example page header <small>Subtext for header</small></h1>
      </div>
    </div>
3937
3938
3939
3940
3941
{% highlight html linenos %}
<div class="page-header">
  <h1>Example page header <small>Subtext for header</small></h1>
</div>
{% endhighlight %}
Mark Otto's avatar
Mark Otto committed
3942
  </div>
3943
3944
3945



Mark Otto's avatar
Mark Otto committed
3946
3947
3948
3949
3950
3951
3952
3953
3954
3955
3956
3957
  <!-- Thumbnails
  ================================================== -->
  <div class="bs-docs-section" id="thumbnails">
    <div class="page-header">
      <h1>Thumbnails</h1>
    </div>
    <p class="lead">Extend Bootstrap's <a href="./css/#gridsystem">grid system</a> with the thumbnail component to easily display grids of images, videos, text, and more.</p>

    <h3>Default thumbnails</h3>
    <p>By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.</p>
    <div class="bs-docs-example">
      <div class="row">
Mark Otto's avatar
Mark Otto committed
3958
        <div class="col-span-3">
Mark Otto's avatar
Mark Otto committed
3959
3960
3961
3962
          <a href="#" class="thumbnail">
            <img data-src="holder.js/260x180" alt="">
          </a>
        </div>
Mark Otto's avatar
Mark Otto committed
3963
        <div class="col-span-3">
Mark Otto's avatar
Mark Otto committed
3964
3965
3966
3967
          <a href="#" class="thumbnail">
            <img data-src="holder.js/260x180" alt="">
          </a>
        </div>
Mark Otto's avatar
Mark Otto committed
3968
        <div class="col-span-3">
Mark Otto's avatar
Mark Otto committed
3969
3970
3971
3972
          <a href="#" class="thumbnail">
            <img data-src="holder.js/260x180" alt="">
          </a>
        </div>
Mark Otto's avatar
Mark Otto committed
3973
        <div class="col-span-3">
Mark Otto's avatar
Mark Otto committed
3974
3975
3976
3977
3978
3979
          <a href="#" class="thumbnail">
            <img data-src="holder.js/260x180" alt="">
          </a>
        </div>
      </div>
    </div><!-- /.bs-docs-example -->
3980
3981
{% highlight html linenos %}
<div class="row">
Mark Otto's avatar
Mark Otto committed
3982
  <div class="col-span-3">
3983
3984
3985
3986
3987
3988
3989
3990
    <a href="#" class="thumbnail">
      <img data-src="holder.js/260x180" alt="">
    </a>
  </div>
  ...
</div>
{% endhighlight %}

Mark Otto's avatar
Mark Otto committed
3991
3992
3993
3994
    <h3>Custom content thumbnails</h3>
    <p>With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.</p>
    <div class="bs-docs-example">
      <div class="row">
Mark Otto's avatar
Mark Otto committed
3995
        <div class="col-span-4">
Mark Otto's avatar
Mark Otto committed
3996
3997
3998
3999
4000
          <div class="thumbnail">
            <img data-src="holder.js/300x200" alt="">
            <div class="caption">
              <h3>Thumbnail label</h3>
              <p>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.</p>
For faster browsing, not all history is shown. View entire blame