diff --git a/docs/assets/css/bootstrap-responsive.css b/docs/assets/css/bootstrap-responsive.css index 8916f313c1..4d104846b7 100644 --- a/docs/assets/css/bootstrap-responsive.css +++ b/docs/assets/css/bootstrap-responsive.css @@ -362,6 +362,9 @@ .uneditable-input { margin-left: 0; } + .controls-row [class*="span"] + [class*="span"] { + margin-left: 30px; + } input.span12, textarea.span12, .uneditable-input.span12 { @@ -704,6 +707,9 @@ .uneditable-input { margin-left: 0; } + .controls-row [class*="span"] + [class*="span"] { + margin-left: 20px; + } input.span12, textarea.span12, .uneditable-input.span12 { @@ -798,6 +804,9 @@ .thumbnails { margin-left: 0; } + .thumbnails > li { + float: none; + } [class*="span"], .row-fluid [class*="span"] { display: block; diff --git a/docs/assets/css/bootstrap.css b/docs/assets/css/bootstrap.css index 4a66eb66d2..e98f9357bc 100644 --- a/docs/assets/css/bootstrap.css +++ b/docs/assets/css/bootstrap.css @@ -851,7 +851,7 @@ legend { display: block; width: 100%; padding: 0; - margin-bottom: 30px; + margin-bottom: 20px; font-size: 21px; line-height: 40px; color: #333333; @@ -1143,6 +1143,10 @@ textarea, margin-left: 0; } +.controls-row [class*="span"] + [class*="span"] { + margin-left: 20px; +} + input.span12, textarea.span12, .uneditable-input.span12 { @@ -1215,6 +1219,25 @@ textarea.span1, width: 50px; } +.controls-row { + *zoom: 1; +} + +.controls-row:before, +.controls-row:after { + display: table; + line-height: 0; + content: ""; +} + +.controls-row:after { + clear: both; +} + +.controls-row [class*="span"] { + float: left; +} + input[disabled], select[disabled], textarea[disabled], @@ -1385,19 +1408,19 @@ select:focus:required:invalid:focus { *zoom: 1; } -.input-prepend, -.input-append { +.input-append, +.input-prepend { margin-bottom: 5px; font-size: 0; white-space: nowrap; } -.input-prepend input, .input-append input, -.input-prepend select, +.input-prepend input, .input-append select, -.input-prepend .uneditable-input, -.input-append .uneditable-input { +.input-prepend select, +.input-append .uneditable-input, +.input-prepend .uneditable-input { position: relative; margin-bottom: 0; *margin-left: 0; @@ -1408,17 +1431,17 @@ select:focus:required:invalid:focus { border-radius: 0 3px 3px 0; } -.input-prepend input:focus, .input-append input:focus, -.input-prepend select:focus, +.input-prepend input:focus, .input-append select:focus, -.input-prepend .uneditable-input:focus, -.input-append .uneditable-input:focus { +.input-prepend select:focus, +.input-append .uneditable-input:focus, +.input-prepend .uneditable-input:focus { z-index: 2; } -.input-prepend .add-on, -.input-append .add-on { +.input-append .add-on, +.input-prepend .add-on { display: inline-block; width: auto; height: 20px; @@ -1434,18 +1457,18 @@ select:focus:required:invalid:focus { border: 1px solid #ccc; } -.input-prepend .add-on, .input-append .add-on, -.input-prepend .btn, -.input-append .btn { +.input-prepend .add-on, +.input-append .btn, +.input-prepend .btn { margin-left: -1px; -webkit-border-radius: 0; -moz-border-radius: 0; border-radius: 0; } -.input-prepend .active, -.input-append .active { +.input-append .active, +.input-prepend .active { background-color: #a9dba9; border-color: #46a546; } @@ -1501,7 +1524,7 @@ select:focus:required:invalid:focus { border-radius: 0 3px 3px 0; } -input.search-query { +.search-query { padding-right: 14px; padding-right: 4px \9; padding-left: 14px; @@ -1514,6 +1537,39 @@ input.search-query { border-radius: 14px; } +/* Allow for input prepend/append in search forms */ + +.form-search .input-append .search-query, +.form-search .input-prepend .search-query { + -webkit-border-radius: 0; + -moz-border-radius: 0; + border-radius: 0; +} + +.form-search .input-append .search-query { + -webkit-border-radius: 14px 0 0 14px; + -moz-border-radius: 14px 0 0 14px; + border-radius: 14px 0 0 14px; +} + +.form-search .input-append .btn { + -webkit-border-radius: 0 14px 14px 0; + -moz-border-radius: 0 14px 14px 0; + border-radius: 0 14px 14px 0; +} + +.form-search .input-prepend .search-query { + -webkit-border-radius: 0 14px 14px 0; + -moz-border-radius: 0 14px 14px 0; + border-radius: 0 14px 14px 0; +} + +.form-search .input-prepend .btn { + -webkit-border-radius: 14px 0 0 14px; + -moz-border-radius: 14px 0 0 14px; + border-radius: 14px 0 0 14px; +} + .form-search input, .form-inline input, .form-horizontal input, @@ -2740,7 +2796,7 @@ button.close { background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#ffffff), to(#e6e6e6)); background-image: -webkit-linear-gradient(top, #ffffff, #e6e6e6); background-image: -o-linear-gradient(top, #ffffff, #e6e6e6); - background-image: linear-gradient(top, #ffffff, #e6e6e6); + background-image: linear-gradient(to bottom, #ffffff, #e6e6e6); background-image: -moz-linear-gradient(top, #ffffff, #e6e6e6); background-repeat: repeat-x; border: 1px solid #cccccc; @@ -2764,6 +2820,7 @@ button.close { .btn.active, .btn.disabled, .btn[disabled] { + color: #333333; background-color: #e6e6e6; *background-color: #d9d9d9; } @@ -2849,22 +2906,6 @@ button.close { line-height: 16px; } -.btn-primary, -.btn-primary:hover, -.btn-warning, -.btn-warning:hover, -.btn-danger, -.btn-danger:hover, -.btn-success, -.btn-success:hover, -.btn-info, -.btn-info:hover, -.btn-inverse, -.btn-inverse:hover { - color: #ffffff; - text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); -} - .btn-primary.active, .btn-warning.active, .btn-danger.active, @@ -2880,12 +2921,14 @@ button.close { } .btn-primary { + color: #ffffff; + text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); background-color: #006dcc; *background-color: #0044cc; background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#0088cc), to(#0044cc)); background-image: -webkit-linear-gradient(top, #0088cc, #0044cc); background-image: -o-linear-gradient(top, #0088cc, #0044cc); - background-image: linear-gradient(top, #0088cc, #0044cc); + background-image: linear-gradient(to bottom, #0088cc, #0044cc); background-image: -moz-linear-gradient(top, #0088cc, #0044cc); background-repeat: repeat-x; border-color: #0044cc #0044cc #002a80; @@ -2899,6 +2942,7 @@ button.close { .btn-primary.active, .btn-primary.disabled, .btn-primary[disabled] { + color: #ffffff; background-color: #0044cc; *background-color: #003bb3; } @@ -2909,12 +2953,14 @@ button.close { } .btn-warning { + color: #ffffff; + text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); background-color: #faa732; *background-color: #f89406; background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#fbb450), to(#f89406)); background-image: -webkit-linear-gradient(top, #fbb450, #f89406); background-image: -o-linear-gradient(top, #fbb450, #f89406); - background-image: linear-gradient(top, #fbb450, #f89406); + background-image: linear-gradient(to bottom, #fbb450, #f89406); background-image: -moz-linear-gradient(top, #fbb450, #f89406); background-repeat: repeat-x; border-color: #f89406 #f89406 #ad6704; @@ -2928,6 +2974,7 @@ button.close { .btn-warning.active, .btn-warning.disabled, .btn-warning[disabled] { + color: #ffffff; background-color: #f89406; *background-color: #df8505; } @@ -2938,12 +2985,14 @@ button.close { } .btn-danger { + color: #ffffff; + text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); background-color: #da4f49; *background-color: #bd362f; background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#ee5f5b), to(#bd362f)); background-image: -webkit-linear-gradient(top, #ee5f5b, #bd362f); background-image: -o-linear-gradient(top, #ee5f5b, #bd362f); - background-image: linear-gradient(top, #ee5f5b, #bd362f); + background-image: linear-gradient(to bottom, #ee5f5b, #bd362f); background-image: -moz-linear-gradient(top, #ee5f5b, #bd362f); background-repeat: repeat-x; border-color: #bd362f #bd362f #802420; @@ -2957,6 +3006,7 @@ button.close { .btn-danger.active, .btn-danger.disabled, .btn-danger[disabled] { + color: #ffffff; background-color: #bd362f; *background-color: #a9302a; } @@ -2967,12 +3017,14 @@ button.close { } .btn-success { + color: #ffffff; + text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); background-color: #5bb75b; *background-color: #51a351; background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#62c462), to(#51a351)); background-image: -webkit-linear-gradient(top, #62c462, #51a351); background-image: -o-linear-gradient(top, #62c462, #51a351); - background-image: linear-gradient(top, #62c462, #51a351); + background-image: linear-gradient(to bottom, #62c462, #51a351); background-image: -moz-linear-gradient(top, #62c462, #51a351); background-repeat: repeat-x; border-color: #51a351 #51a351 #387038; @@ -2986,6 +3038,7 @@ button.close { .btn-success.active, .btn-success.disabled, .btn-success[disabled] { + color: #ffffff; background-color: #51a351; *background-color: #499249; } @@ -2996,12 +3049,14 @@ button.close { } .btn-info { + color: #ffffff; + text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); background-color: #49afcd; *background-color: #2f96b4; background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#5bc0de), to(#2f96b4)); background-image: -webkit-linear-gradient(top, #5bc0de, #2f96b4); background-image: -o-linear-gradient(top, #5bc0de, #2f96b4); - background-image: linear-gradient(top, #5bc0de, #2f96b4); + background-image: linear-gradient(to bottom, #5bc0de, #2f96b4); background-image: -moz-linear-gradient(top, #5bc0de, #2f96b4); background-repeat: repeat-x; border-color: #2f96b4 #2f96b4 #1f6377; @@ -3015,6 +3070,7 @@ button.close { .btn-info.active, .btn-info.disabled, .btn-info[disabled] { + color: #ffffff; background-color: #2f96b4; *background-color: #2a85a0; } @@ -3025,12 +3081,14 @@ button.close { } .btn-inverse { + color: #ffffff; + text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); background-color: #363636; *background-color: #222222; background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#444444), to(#222222)); background-image: -webkit-linear-gradient(top, #444444, #222222); background-image: -o-linear-gradient(top, #444444, #222222); - background-image: linear-gradient(top, #444444, #222222); + background-image: linear-gradient(to bottom, #444444, #222222); background-image: -moz-linear-gradient(top, #444444, #222222); background-repeat: repeat-x; border-color: #222222 #222222 #000000; @@ -3044,6 +3102,7 @@ button.close { .btn-inverse.active, .btn-inverse.disabled, .btn-inverse[disabled] { + color: #ffffff; background-color: #222222; *background-color: #151515; } @@ -3775,7 +3834,7 @@ input[type="submit"].btn.btn-mini { background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#222222), to(#111111)); background-image: -webkit-linear-gradient(top, #222222, #111111); background-image: -o-linear-gradient(top, #222222, #111111); - background-image: linear-gradient(top, #222222, #111111); + background-image: linear-gradient(to bottom, #222222, #111111); background-repeat: repeat-x; -webkit-border-radius: 4px; -moz-border-radius: 4px; @@ -3828,7 +3887,7 @@ input[type="submit"].btn.btn-mini { .navbar .btn, .navbar .btn-group { - margin-top: 5px; + margin-top: 6px; } .navbar .btn-group .btn { @@ -3855,11 +3914,12 @@ input[type="submit"].btn.btn-mini { .navbar-form select, .navbar-form .radio, .navbar-form .checkbox { - margin-top: 5px; + margin-top: 6px; } .navbar-form input, -.navbar-form select { +.navbar-form select, +.navbar-form .btn { display: inline-block; margin-bottom: 0; } @@ -4044,12 +4104,14 @@ input[type="submit"].btn.btn-mini { padding: 7px 10px; margin-right: 5px; margin-left: 5px; + color: #ffffff; + text-shadow: 0 -1px 0 rgba(0, 0, 0, 0.25); background-color: #0e0e0e; *background-color: #040404; background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#151515), to(#040404)); background-image: -webkit-linear-gradient(top, #151515, #040404); background-image: -o-linear-gradient(top, #151515, #040404); - background-image: linear-gradient(top, #151515, #040404); + background-image: linear-gradient(to bottom, #151515, #040404); background-image: -moz-linear-gradient(top, #151515, #040404); background-repeat: repeat-x; border-color: #040404 #040404 #000000; @@ -4066,6 +4128,7 @@ input[type="submit"].btn.btn-mini { .navbar .btn-navbar.active, .navbar .btn-navbar.disabled, .navbar .btn-navbar[disabled] { + color: #ffffff; background-color: #040404; *background-color: #000000; } @@ -4178,7 +4241,7 @@ input[type="submit"].btn.btn-mini { background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#ffffff), to(#f1f1f1)); background-image: -webkit-linear-gradient(top, #ffffff, #f1f1f1); background-image: -o-linear-gradient(top, #ffffff, #f1f1f1); - background-image: linear-gradient(top, #ffffff, #f1f1f1); + background-image: linear-gradient(to bottom, #ffffff, #f1f1f1); background-image: -moz-linear-gradient(top, #ffffff, #f1f1f1); background-repeat: repeat-x; border: 1px solid #e5e5e5; @@ -4281,7 +4344,7 @@ input[type="submit"].btn.btn-mini { background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#ffffff), to(#f5f5f5)); background-image: -webkit-linear-gradient(top, #ffffff, #f5f5f5); background-image: -o-linear-gradient(top, #ffffff, #f5f5f5); - background-image: linear-gradient(top, #ffffff, #f5f5f5); + background-image: linear-gradient(to bottom, #ffffff, #f5f5f5); background-repeat: repeat-x; border: 1px solid #ddd; -webkit-border-radius: 3px; @@ -4579,91 +4642,19 @@ input[type="submit"].btn.btn-mini { } .tooltip.top { - margin-top: -2px; + margin-top: -3px; } .tooltip.right { - margin-left: 2px; + margin-left: 3px; } .tooltip.bottom { - margin-top: 2px; + margin-top: 3px; } .tooltip.left { - margin-left: -2px; -} - -.tooltip.top .tooltip-arrow { - bottom: -10px; - left: 50%; - margin-left: -10px; - border-top: 10px solid #cccccc; - border-top: 10px solid rgba(0, 0, 0, 0.2); - border-right: 10px solid transparent; - border-left: 10px solid transparent; -} - -.tooltip.top .tooltip-arrow:after { - bottom: 1px; - left: -9px; - border-top: 9px solid #ffffff; - border-right: 9px solid transparent; - border-left: 9px solid transparent; -} - -.tooltip.left .tooltip-arrow { - top: 50%; - right: -10px; - margin-top: -10px; - border-top: 10px solid transparent; - border-bottom: 10px solid transparent; - border-left: 10px solid #cccccc; - border-left: 10px solid rgba(0, 0, 0, 0.2); -} - -.tooltip.left .tooltip-arrow:after { - right: 1px; - bottom: -9px; - border-top: 9px solid transparent; - border-bottom: 9px solid transparent; - border-left: 9px solid #ffffff; -} - -.tooltip.bottom .tooltip-arrow { - top: -10px; - left: 50%; - margin-left: -10px; - border-right: 10px solid transparent; - border-bottom: 10px solid #cccccc; - border-bottom: 10px solid rgba(0, 0, 0, 0.2); - border-left: 10px solid transparent; -} - -.tooltip.bottom .tooltip-arrow:after { - top: 1px; - left: -9px; - border-right: 9px solid transparent; - border-bottom: 9px solid #f5f5f5; - border-left: 9px solid transparent; -} - -.tooltip.right .tooltip-arrow { - top: 50%; - left: -10px; - margin-top: -10px; - border-top: 10px solid transparent; - border-right: 10px solid #cccccc; - border-right: 10px solid rgba(0, 0, 0, 0.2); - border-bottom: 10px solid transparent; -} - -.tooltip.right .tooltip-arrow:after { - bottom: -9px; - left: 1px; - border-top: 9px solid transparent; - border-right: 9px solid #ffffff; - border-bottom: 9px solid transparent; + margin-left: -3px; } .tooltip-inner { @@ -4682,6 +4673,40 @@ input[type="submit"].btn.btn-mini { position: absolute; width: 0; height: 0; + border-color: transparent; + border-style: solid; +} + +.tooltip.top .tooltip-arrow { + bottom: 0; + left: 50%; + margin-left: -5px; + border-top-color: #000000; + border-width: 5px 5px 0; +} + +.tooltip.right .tooltip-arrow { + top: 50%; + left: 0; + margin-top: -5px; + border-right-color: #000000; + border-width: 5px 5px 5px 0; +} + +.tooltip.left .tooltip-arrow { + top: 50%; + right: 0; + margin-top: -5px; + border-left-color: #000000; + border-width: 5px 0 5px 5px; +} + +.tooltip.bottom .tooltip-arrow { + top: 0; + left: 50%; + margin-left: -5px; + border-bottom-color: #000000; + border-width: 0 5px 5px; } .popover { @@ -4690,7 +4715,7 @@ input[type="submit"].btn.btn-mini { left: 0; z-index: 1010; display: none; - width: 218px; + width: 238px; background-color: #fff; border: 1px solid #ccc; border: 1px solid rgba(0, 0, 0, 0.2); @@ -4721,99 +4746,14 @@ input[type="submit"].btn.btn-mini { margin-right: 10px; } -.popover.top .arrow { - bottom: -10px; - left: 50%; - margin-left: -10px; - border-top: 10px solid #cccccc; - border-top: 10px solid rgba(0, 0, 0, 0.2); - border-right: 10px solid transparent; - border-left: 10px solid transparent; -} - -.popover.top .arrow:after { - bottom: 1px; - left: -9px; - border-top: 9px solid #ffffff; - border-right: 9px solid transparent; - border-left: 9px solid transparent; -} - -.popover.right .arrow { - top: 50%; - left: -10px; - margin-top: -10px; - border-top: 10px solid transparent; - border-right: 10px solid #cccccc; - border-right: 10px solid rgba(0, 0, 0, 0.2); - border-bottom: 10px solid transparent; -} - -.popover.right .arrow:after { - bottom: -9px; - left: 1px; - border-top: 9px solid transparent; - border-right: 9px solid #ffffff; - border-bottom: 9px solid transparent; -} - -.popover.bottom .arrow { - top: -10px; - left: 50%; - margin-left: -10px; - border-right: 10px solid transparent; - border-bottom: 10px solid #cccccc; - border-bottom: 10px solid rgba(0, 0, 0, 0.2); - border-left: 10px solid transparent; -} - -.popover.bottom .arrow:after { - top: 1px; - left: -9px; - border-right: 9px solid transparent; - border-bottom: 9px solid #f5f5f5; - border-left: 9px solid transparent; -} - -.popover.left .arrow { - top: 50%; - right: -10px; - margin-top: -10px; - border-top: 10px solid transparent; - border-bottom: 10px solid transparent; - border-left: 10px solid #cccccc; - border-left: 10px solid rgba(0, 0, 0, 0.2); -} - -.popover.left .arrow:after { - right: 1px; - bottom: -9px; - border-top: 9px solid transparent; - border-bottom: 9px solid transparent; - border-left: 9px solid #ffffff; -} - -.popover .arrow { - position: absolute; - width: 0; - height: 0; -} - -.popover .arrow:after { - position: absolute; - display: inline-block; - width: 0; - height: 0; - content: ""; -} - .popover-title { padding: 8px 14px; + margin: 0; font-size: 14px; font-weight: normal; line-height: 18px; background-color: #f5f5f5; - border-bottom: 1px solid #e5e5e5; + border-bottom: 1px solid #dcdcdc; -webkit-border-radius: 5px 5px 0 0; -moz-border-radius: 5px 5px 0 0; border-radius: 5px 5px 0 0; @@ -4829,6 +4769,81 @@ input[type="submit"].btn.btn-mini { margin-bottom: 0; } +.popover .arrow, +.popover .arrow:after { + position: absolute; + display: inline-block; + width: 0; + height: 0; + border-color: transparent; + border-style: solid; +} + +.popover .arrow:after { + z-index: -1; + content: ""; +} + +.popover.top .arrow { + bottom: -10px; + left: 50%; + margin-left: -10px; + border-top-color: #ffffff; + border-width: 10px 10px 0; +} + +.popover.top .arrow:after { + bottom: -1px; + left: -11px; + border-top-color: rgba(0, 0, 0, 0.2); + border-width: 11px 11px 0; +} + +.popover.right .arrow { + top: 50%; + left: -10px; + margin-top: -10px; + border-right-color: #ffffff; + border-width: 10px 10px 10px 0; +} + +.popover.right .arrow:after { + bottom: -11px; + left: -1px; + border-right-color: rgba(0, 0, 0, 0.2); + border-width: 11px 11px 11px 0; +} + +.popover.bottom .arrow { + top: -10px; + left: 50%; + margin-left: -10px; + border-bottom-color: #f5f5f5; + border-width: 0 10px 10px; +} + +.popover.bottom .arrow:after { + top: -1px; + left: -11px; + border-bottom-color: rgba(0, 0, 0, 0.2); + border-width: 0 11px 11px; +} + +.popover.left .arrow { + top: 50%; + right: -10px; + margin-top: -10px; + border-left-color: #ffffff; + border-width: 10px 0 10px 10px; +} + +.popover.left .arrow:after { + right: -1px; + bottom: -11px; + border-left-color: rgba(0, 0, 0, 0.2); + border-width: 11px 0 11px 11px; +} + .thumbnails { margin-left: -20px; list-style: none; @@ -5025,7 +5040,7 @@ a.badge:hover { background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#f5f5f5), to(#f9f9f9)); background-image: -webkit-linear-gradient(top, #f5f5f5, #f9f9f9); background-image: -o-linear-gradient(top, #f5f5f5, #f9f9f9); - background-image: linear-gradient(top, #f5f5f5, #f9f9f9); + background-image: linear-gradient(to bottom, #f5f5f5, #f9f9f9); background-repeat: repeat-x; -webkit-border-radius: 4px; -moz-border-radius: 4px; @@ -5047,7 +5062,7 @@ a.badge:hover { background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#149bdf), to(#0480be)); background-image: -webkit-linear-gradient(top, #149bdf, #0480be); background-image: -o-linear-gradient(top, #149bdf, #0480be); - background-image: linear-gradient(top, #149bdf, #0480be); + background-image: linear-gradient(to bottom, #149bdf, #0480be); background-image: -moz-linear-gradient(top, #149bdf, #0480be); background-repeat: repeat-x; filter: progid:dximagetransform.microsoft.gradient(startColorstr='#ff149bdf', endColorstr='#ff0480be', GradientType=0); @@ -5090,7 +5105,7 @@ a.badge:hover { background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#ee5f5b), to(#c43c35)); background-image: -webkit-linear-gradient(top, #ee5f5b, #c43c35); background-image: -o-linear-gradient(top, #ee5f5b, #c43c35); - background-image: linear-gradient(top, #ee5f5b, #c43c35); + background-image: linear-gradient(to bottom, #ee5f5b, #c43c35); background-repeat: repeat-x; filter: progid:dximagetransform.microsoft.gradient(startColorstr='#ffee5f5b', endColorstr='#ffc43c35', GradientType=0); } @@ -5110,7 +5125,7 @@ a.badge:hover { background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#62c462), to(#57a957)); background-image: -webkit-linear-gradient(top, #62c462, #57a957); background-image: -o-linear-gradient(top, #62c462, #57a957); - background-image: linear-gradient(top, #62c462, #57a957); + background-image: linear-gradient(to bottom, #62c462, #57a957); background-repeat: repeat-x; filter: progid:dximagetransform.microsoft.gradient(startColorstr='#ff62c462', endColorstr='#ff57a957', GradientType=0); } @@ -5130,7 +5145,7 @@ a.badge:hover { background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#5bc0de), to(#339bb9)); background-image: -webkit-linear-gradient(top, #5bc0de, #339bb9); background-image: -o-linear-gradient(top, #5bc0de, #339bb9); - background-image: linear-gradient(top, #5bc0de, #339bb9); + background-image: linear-gradient(to bottom, #5bc0de, #339bb9); background-repeat: repeat-x; filter: progid:dximagetransform.microsoft.gradient(startColorstr='#ff5bc0de', endColorstr='#ff339bb9', GradientType=0); } @@ -5150,7 +5165,7 @@ a.badge:hover { background-image: -webkit-gradient(linear, 0 0, 0 100%, from(#fbb450), to(#f89406)); background-image: -webkit-linear-gradient(top, #fbb450, #f89406); background-image: -o-linear-gradient(top, #fbb450, #f89406); - background-image: linear-gradient(top, #fbb450, #f89406); + background-image: linear-gradient(to bottom, #fbb450, #f89406); background-repeat: repeat-x; filter: progid:dximagetransform.microsoft.gradient(startColorstr='#fffbb450', endColorstr='#fff89406', GradientType=0); } diff --git a/docs/assets/css/docs.css b/docs/assets/css/docs.css index 9593ae772a..bbdff228dc 100644 --- a/docs/assets/css/docs.css +++ b/docs/assets/css/docs.css @@ -598,6 +598,17 @@ form.bs-docs-example { line-height: 18px; } +/* Tooltips */ +.bs-docs-tooltip-examples { + text-align: center; + margin: 0 0 10px; + list-style: none; +} +.bs-docs-tooltip-examples li { + display: inline; + padding: 0 10px; +} + /* Popovers */ .bs-docs-example-popover { padding-bottom: 24px; @@ -607,8 +618,8 @@ form.bs-docs-example { position: relative; display: block; float: left; - width: 210px; - margin: 10px; + width: 260px; + margin: 20px; } diff --git a/docs/base-css.html b/docs/base-css.html index 0c5bf0bea4..75296003b4 100644 --- a/docs/base-css.html +++ b/docs/base-css.html @@ -68,26 +68,17 @@
On top of the scaffolding, basic HTML elements are styled and enhanced with extensible classes to provide a fresh, consistent look and feel.
-All HTML headings, <h1>
through <h6>
are available.
All HTML headings, <h1>
through <h6>
are available.
Bootstrap's global default font-size
is 14px, with a line-height
of 20px. This is applied to the <body>
and all paragraphs. In addition, <p>
(paragraphs) receive a bottom margin of half their line-height (9px by default).
Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Nullam id dolor id nibh ultricies vehicula.
-Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec ullamcorper nulla non metus auctor fringilla. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Donec ullamcorper nulla non metus auctor fringilla.
-Maecenas sed diam eget risus varius blandit sit amet non magna. Donec id elit non mi porta gravida at eget metus. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit.
-Bootstrap's global default font-size
is 14px, with a line-height
of 20px. This is applied to the <body>
and all paragraphs. In addition, <p>
(paragraphs) receive a bottom margin of half their line-height (9px by default).
Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Nullam id dolor id nibh ultricies vehicula.
+Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec ullamcorper nulla non metus auctor fringilla. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Donec ullamcorper nulla non metus auctor fringilla.
+Maecenas sed diam eget risus varius blandit sit amet non magna. Donec id elit non mi porta gravida at eget metus. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit.
+Make a paragraph stand out by adding .lead
.
Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus.
-Make a paragraph stand out by adding .lead
.
Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus.
+The typographic scale is based on two LESS variables in variables.less: @baseFontSize
and @baseLineHeight
. The first is the base font-size used throughout and the second is the base line-height. We use those variables and some simple math to create the margins, paddings, and line-heights of all our type and more. Customize them and Bootstrap adapts.
The typographic scale is based on two LESS variables in variables.less: @baseFontSize
and @baseLineHeight
. The first is the base font-size used throughout and the second is the base line-height. We use those variables and some simple math to create the margins, paddings, and line-heights of all our type and more. Customize them and Bootstrap adapts.
Make use of HTML's default emphasis tags, <strong>
and <em>
.
Make use of HTML's default emphasis tags, <strong>
and <em>
.
<strong>
For emphasizing a snippet of text with important
-The following snippet of text is rendered as bold text.
-<strong>
For emphasizing a snippet of text with important
+The following snippet of text is rendered as bold text.
+<strong>rendered as bold text</strong>-
<em>
For emphasizing a snippet of text with stress
-The following snippet of text is rendered as italicized text.
--<em>rendered as italicized text</em> -+
<em>
For emphasizing a snippet of text with stress
+The following snippet of text is rendered as italicized text.
++ <em>rendered as italicized text</em> +-
Heads up! Feel free to use <b>
and <i>
in HTML5. <b>
is meant to highlight words or phrases without conveying additional importance while <i>
is mostly for voice, technical terms, etc.
Heads up! Feel free to use <b>
and <i>
in HTML5. <b>
is meant to highlight words or phrases without conveying additional importance while <i>
is mostly for voice, technical terms, etc.
Stylized implemenation of HTML's <abbr>
element for abbreviations and acronyms to show the expanded version on hover. Abbreviations with a title
attribute have a light dotted bottom border and a help cursor on hover, providing additional context on hover.
Stylized implemenation of HTML's <abbr>
element for abbreviations and acronyms to show the expanded version on hover. Abbreviations with a title
attribute have a light dotted bottom border and a help cursor on hover, providing additional context on hover.
<abbr>
For expanded text on long hover of an abbreviation, include the title
attribute.
An abbreviation of the word attribute is attr.
-<abbr>
For expanded text on long hover of an abbreviation, include the title
attribute.
An abbreviation of the word attribute is attr.
+<abbr title="attribute">attr</abbr>-
<abbr class="initialism">
Add .initialism
to an abbreviation for a slightly smaller font-size.
HTML is the best thing since sliced bread.
-<abbr class="initialism">
Add .initialism
to an abbreviation for a slightly smaller font-size.
HTML is the best thing since sliced bread.
+<abbr title="attribute" class="initialism">attr</abbr>-
Present contact information for the nearest ancestor or the entire body of work.
+Present contact information for the nearest ancestor or the entire body of work.
-<address>
Preserve formatting by ending all lines with <br>
.
<address>
Preserve formatting by ending all lines with <br>
.
<address> <strong>Twitter, Inc.</strong><br> @@ -226,36 +217,36 @@-
For quoting blocks of content from another source within your document.
+For quoting blocks of content from another source within your document.
-Wrap <blockquote>
around any HTML as the quote. For straight quotes we recommend a <p>
.
--Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
-
Wrap <blockquote>
around any HTML as the quote. For straight quotes we recommend a <p>
.
++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
+
<blockquote> <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p> </blockquote>-
Style and content changes for simple variations on a standard blockquote.
+Style and content changes for simple variations on a standard blockquote.
-Add <small>
tag for identifying the source. Wrap the name of the source work in <cite>
.
--Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
- Someone famous in Source Title -
Add <small>
tag for identifying the source. Wrap the name of the source work in <cite>
.
++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
+ Someone famous in Source Title +
<blockquote> <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p> @@ -263,14 +254,14 @@ </blockquote>-
Use .pull-left
and .pull-right
classes for floated, right-aligned blockquote content.
--Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
- Someone famous in Source Title -
Use .pull-left
and .pull-right
classes for floated, right-aligned blockquote content.
++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
+ Someone famous in Source Title +
<blockquote class="pull-right"> <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p> @@ -279,99 +270,99 @@-
A list of items in which the order does not explicitly matter.
-A list of items in which the order does not explicitly matter.
+<ul> <li>...</li> </ul>-
A list of items in which the order does explicitly matter.
-A list of items in which the order does explicitly matter.
+<ol> <li>...</li> </ol>-
A list of items with no list-style
or additional left padding.
A list of items with no list-style
or additional left padding.
<ul class="unstyled"> <li>...</li> </ul>-
A list of terms with their associated descriptions.
-A list of terms with their associated descriptions.
+<dl> <dt>...</dt> @@ -379,21 +370,21 @@ </dl>-
Make terms and descriptions in <dl>
line up side-by-side.
Make terms and descriptions in <dl>
line up side-by-side.
<dl class="dl-horizontal"> <dt>...</dt> @@ -401,28 +392,28 @@ </dl>
- Heads up!
- Horizontal description lists will truncate terms that are too long to fit in the left column fix text-overflow
. In narrower viewports, they will change to the default stacked layout.
-
text-overflow
. In narrower viewports, they will change to the default stacked layout.
+
+ Wrap inline snippets of code with <code>
.
Wrap inline snippets of code with <code>
.
For example, <code>section</code> should be wrapped as inline.-
Use <pre>
for multiple lines of code. Be sure to escape any angle brackets in the code for proper rendering.
Use <pre>
for multiple lines of code. Be sure to escape any angle brackets in the code for proper rendering.
<p>Sample text here...</p>@@ -431,53 +422,53 @@ For example, <code>section</code> should be wrapped as inline. <p>Sample text here...</p> </pre> -
Note: Be sure to keep code within <pre>
tags as close to the left as possible; it will render all tabs.
You may optionally add the .pre-scrollable
class which will set a max-height of 350px and provide a y-axis scrollbar.
Note: Be sure to keep code within <pre>
tags as close to the left as possible; it will render all tabs.
You may optionally add the .pre-scrollable
class which will set a max-height of 350px and provide a y-axis scrollbar.
For basic styling—light padding and only horizontal dividers—add the base class .table
to any <table>
.
# | -First Name | -Last Name | -Username | -
---|---|---|---|
1 | -Mark | -Otto | -@mdo | -
2 | -Jacob | -Thornton | -@fat | -
3 | -Larry | -the Bird | -
For basic styling—light padding and only horizontal dividers—add the base class .table
to any <table>
.
# | +First Name | +Last Name | +Username | +
---|---|---|---|
1 | +Mark | +Otto | +@mdo | +
2 | +Jacob | +Thornton | +@fat | +
3 | +Larry | +the Bird | +
<table class="table"> … @@ -485,168 +476,168 @@ For example, <code>section</code> should be wrapped as inline.-
Add any of the follow classes to the .table
base class.
Add any of the follow classes to the .table
base class.
.table-striped
Adds zebra-striping to any table row within the <tbody>
via the :nth-child
CSS selector (not available in IE7-IE8).
# | -First Name | -Last Name | -Username | -
---|---|---|---|
1 | -Mark | -Otto | -@mdo | -
2 | -Jacob | -Thornton | -@fat | -
3 | -Larry | -the Bird | -
.table-striped
Adds zebra-striping to any table row within the <tbody>
via the :nth-child
CSS selector (not available in IE7-IE8).
# | +First Name | +Last Name | +Username | +
---|---|---|---|
1 | +Mark | +Otto | +@mdo | +
2 | +Jacob | +Thornton | +@fat | +
3 | +Larry | +the Bird | +
<table class="table table-striped"> … </table>-
.table-bordered
Add borders and rounded corners to the table.
-# | -First Name | -Last Name | -Username | -
---|---|---|---|
1 | -Mark | -Otto | -@mdo | -
Mark | -Otto | -@TwBootstrap | -|
2 | -Jacob | -Thornton | -@fat | -
3 | -Larry the Bird | -
.table-bordered
Add borders and rounded corners to the table.
+# | +First Name | +Last Name | +Username | +
---|---|---|---|
1 | +Mark | +Otto | +@mdo | +
Mark | +Otto | +@TwBootstrap | +|
2 | +Jacob | +Thornton | +@fat | +
3 | +Larry the Bird | +
<table class="table table-bordered"> … </table>-
.table-hover
Enable a hover state on table rows within a <tbody>
.
# | -First Name | -Last Name | -Username | -
---|---|---|---|
1 | -Mark | -Otto | -@mdo | -
2 | -Jacob | -Thornton | -@fat | -
3 | -Larry the Bird | -
.table-hover
Enable a hover state on table rows within a <tbody>
.
# | +First Name | +Last Name | +Username | +
---|---|---|---|
1 | +Mark | +Otto | +@mdo | +
2 | +Jacob | +Thornton | +@fat | +
3 | +Larry the Bird | +
<table class="table table-hover"> … </table>-
.table-condensed
Makes tables more compact by cutting cell padding in half.
-# | -First Name | -Last Name | -Username | -
---|---|---|---|
1 | -Mark | -Otto | -@mdo | -
2 | -Jacob | -Thornton | -@fat | -
3 | -Larry the Bird | -
.table-condensed
Makes tables more compact by cutting cell padding in half.
+# | +First Name | +Last Name | +Username | +
---|---|---|---|
1 | +Mark | +Otto | +@mdo | +
2 | +Jacob | +Thornton | +@fat | +
3 | +Larry the Bird | +
<table class="table table-condensed"> … @@ -654,82 +645,82 @@ For example, <code>section</code> should be wrapped as inline.-
List of supported table HTML elements and how they should be used.
-Tag | -Description | -
---|---|
- <table>
- |
- - Wrapping element for displaying data in a tabular format - | -
- <thead>
- |
-
- Container element for table header rows (<tr> ) to label table columns
- |
-
- <tbody>
- |
-
- Container element for table rows (<tr> ) in the body of the table
- |
-
- <tr>
- |
-
- Container element for a set of table cells (<td> or <th> ) that appears on a single row
- |
-
- <td>
- |
- - Default table cell - | -
- <th>
- |
-
- Special table cell for column (or row, depending on scope and placement) labels - Must be used within a <thead>
- |
-
- <caption>
- |
- - Description or summary of what the table holds, especially useful for screen readers - | -
List of supported table HTML elements and how they should be used.
+Tag | +Description | +
---|---|
+ <table>
+ |
+ + Wrapping element for displaying data in a tabular format + | +
+ <thead>
+ |
+
+ Container element for table header rows (<tr> ) to label table columns
+ |
+
+ <tbody>
+ |
+
+ Container element for table rows (<tr> ) in the body of the table
+ |
+
+ <tr>
+ |
+
+ Container element for a set of table cells (<td> or <th> ) that appears on a single row
+ |
+
+ <td>
+ |
+ + Default table cell + | +
+ <th>
+ |
+
+ Special table cell for column (or row, depending on scope and placement) labels + Must be used within a <thead>
+ |
+
+ <caption>
+ |
+ + Description or summary of what the table holds, especially useful for screen readers + | +
<table> <thead> @@ -747,28 +738,29 @@ For example, <code>section</code> should be wrapped as inline. </table>-
Individual form controls receive styling, but without any required base class on the <form>
or large changes in markup. Results in stacked, left-aligned labels on top of form controls.
Individual form controls receive styling, but without any required base class on the <form>
or large changes in markup. Results in stacked, left-aligned labels on top of form controls.
<form class="well"> <label>Label name</label> @@ -782,18 +774,18 @@ For example, <code>section</code> should be wrapped as inline.-
Included with Bootstrap are three optional form layouts for common use cases.
+Included with Bootstrap are three optional form layouts for common use cases.
-Add .form-search
to the form and .search-query
to the <input>
for an extra-rounded text input.
Add .form-search
to the form and .search-query
to the <input>
for an extra-rounded text input.
<form class="form-search"> <input type="text" class="input-medium search-query"> @@ -801,16 +793,16 @@ For example, <code>section</code> should be wrapped as inline. </form>-
Add .form-inline
for left-aligned labels and inline-block controls for a compact layout.
Add .form-inline
for left-aligned labels and inline-block controls for a compact layout.
<form class="form-inline"> <input type="text" class="input-small" placeholder="Email"> @@ -822,36 +814,37 @@ For example, <code>section</code> should be wrapped as inline. </form>-
Right align labels and float them to the left to make them appear on the same line as controls. Requires the most markup changes from a default form:
-.form-horizontal
to the form.control-group
.control-label
to the label.controls
for proper alignmentRight align labels and float them to the left to make them appear on the same line as controls. Requires the most markup changes from a default form:
+.form-horizontal
to the form.control-group
.control-label
to the label.controls
for proper alignment<form class="form-horizontal"> <div class="control-group"> @@ -878,49 +871,49 @@ For example, <code>section</code> should be wrapped as inline.-
Examples of standard form controls supported in an example form layout.
+Examples of standard form controls supported in an example form layout.
-Most common form control, text-based input fields. Includes support for all HTML5 types: text, password, datetime, datetime-local, date, month, time, week, number, email, url, search, tel, and color.
-Requires the use of a specified type
at all times.
Most common form control, text-based input fields. Includes support for all HTML5 types: text, password, datetime, datetime-local, date, month, time, week, number, email, url, search, tel, and color.
+Requires the use of a specified type
at all times.
<input type="text" placeholder="Text input">-
Form control which supports multiple lines of text. Change row
attribute as necessary.
Form control which supports multiple lines of text. Change row
attribute as necessary.
<textarea id="textarea" rows="3"></textarea>-
Checkboxes are for selecting one or several options in a list while radios are for selecting one option from many.
-Checkboxes are for selecting one or several options in a list while radios are for selecting one option from many.
+<label class="checkbox"> <input type="checkbox" value=""> @@ -937,19 +930,19 @@ For example, <code>section</code> should be wrapped as inline. </label>-
Add the .inline
class to a series of checkboxes or radios for controls appear on the same line.
Add the .inline
class to a series of checkboxes or radios for controls appear on the same line.
<label class="checkbox inline"> <input type="checkbox" id="inlineCheckbox1" value="option1"> 1 @@ -962,25 +955,25 @@ For example, <code>section</code> should be wrapped as inline. </label>-
Use the default option or specify a multiple="multiple"
to show multiple options at once.
Use the default option or specify a multiple="multiple"
to show multiple options at once.
<select> <option>something</option> @@ -1000,28 +993,28 @@ For example, <code>section</code> should be wrapped as inline.-
Adding on top of existing browser controls, Bootstrap includes other useful form components.
+Adding on top of existing browser controls, Bootstrap includes other useful form components.
-Add text or buttons before or after any text-based input. Do note that select
elements are not supported here.
Add text or buttons before or after any text-based input. Do note that select
elements are not supported here.
Wrap a .add-on
and an input
with one of two classes to prepend or append text to an input.
Wrap a .add-on
and an input
with one of two classes to prepend or append text to an input.
<div class="input-prepend"> <span class="add-on">@</span><input class="span2" id="prependedInput" size="16" type="text" placeholder="Username"> @@ -1031,35 +1024,35 @@ For example, <code>section</code> should be wrapped as inline. </div>-
Use both classes and two instances of .add-on
to prepend and append an input.
Use both classes and two instances of .add-on
to prepend and append an input.
<div class="input-prepend input-append"> <span class="add-on">$</span><input class="span2" id="appendedPrependedInput" size="16" type="text"><span class="add-on">.00</span> </div>-
Instead of a <span>
with text, use a .btn
to attach a button (or two) to an input.
Instead of a <span>
with text, use a .btn
to attach a button (or two) to an input.
<div class="input-append"> <input class="span2" id="appendedInputButton" size="16" type="text"><button class="btn" type="button">Go!</button> @@ -1070,20 +1063,38 @@ For example, <code>section</code> should be wrapped as inline. </div>-
Use relative sizing classes like .input-large
or match your inputs to the grid column sizes using .span*
classes.
+<form class="form-search"> + <input type="text" class="span2 search-query"> + <button type="submit" class="btn">Search</button> +</form> +-
Use relative sizing classes like .input-large
or match your inputs to the grid column sizes using .span*
classes.
<input class="input-mini" type="text"> <input class="input-small" type="text"> @@ -1092,60 +1103,92 @@ For example, <code>section</code> should be wrapped as inline. <input class="input-xlarge" type="text"> <input class="input-xxlarge" type="text">+
+ Heads up! In future versions, we'll be altering the use of these relative input classes to match our button sizes. For example, .input-large
will increase the padding and font-size of an input.
+
Use .span1
to .span12
for inputs that match the same sizes of the grid columns.
Use .span1
to .span12
for inputs that match the same sizes of the grid columns.
<input class="span1" type="text"> <input class="span2" type="text"> <input class="span3" type="text">-
Present data in a form that's not editable without using actual form markup.
- +For multiple grid inputs per line, use the .controls-row
modifier class for proper spacing. It floats the inputs to collapse white-space, sets the proper margins, and the clears the float.
+<div class="controls controls-row"> + <input class="span4" type="text" placeholder=".span4"> + <input class="span1" type="text" placeholder=".span1"> +</div> ++ +
Present data in a form that's not editable without using actual form markup.
+<span class="input-xlarge uneditable-input">Some value here</span>-
End a form with a group of actions (buttons). When placed within a .form-horizontal
, the buttons will automatically indent to line up with the form controls.
End a form with a group of actions (buttons). When placed within a .form-horizontal
, the buttons will automatically indent to line up with the form controls.
<div class="form-actions"> <button type="submit" class="btn btn-primary">Save changes</button> @@ -1153,76 +1196,76 @@ For example, <code>section</code> should be wrapped as inline. </div>-
Inline and block level support for help text that appears around form controls.
-Inline and block level support for help text that appears around form controls.
+<span class="help-inline">Inline help text</span>-
<span class="help-block">A longer block of help text that breaks onto a new line and may extend beyond one line.</span>-
Provide feedback to users or visitors with basic feedback states on form controls and labels.
+Provide feedback to users or visitors with basic feedback states on form controls and labels.
-We remove the default outline
styles on some form controls and apply a box-shadow
in its place for :focus
.
We remove the default outline
styles on some form controls and apply a box-shadow
in its place for :focus
.
<input class="input-xlarge" id="focusedInput" type="text" value="This is focused...">-
Add the disabled
attribute on an input to prevent user input and trigger a slightly different look.
Add the disabled
attribute on an input to prevent user input and trigger a slightly different look.
<input class="input-xlarge" id="disabledInput" type="text" placeholder="Disabled input here..." disabled>-
Bootstrap includes validation styles for error, warning, and success messages. To use, add the appropriate class to the surrounding .control-group
.
Bootstrap includes validation styles for error, warning, and success messages. To use, add the appropriate class to the surrounding .control-group
.
<div class="control-group warning"> <label class="control-label" for="inputWarning">Input with warning</label> @@ -1247,133 +1290,133 @@ For example, <code>section</code> should be wrapped as inline. </div>-
Button styles can be applied to anything with the .btn
class applied. However, typically you'll want to apply these to only <a>
and <button>
elements for the best rendering.
Button | -class="" | -Description | -
---|---|---|
- | btn |
- Standard gray button with gradient | -
- | btn btn-primary |
- Provides extra visual weight and identifies the primary action in a set of buttons | -
- | btn btn-info |
- Used as an alternative to the default styles | -
- | btn btn-success |
- Indicates a successful or positive action | -
- | btn btn-warning |
- Indicates caution should be taken with this action | -
- | btn btn-danger |
- Indicates a dangerous or potentially negative action | -
- | btn btn-inverse |
- Alternate dark gray button, not tied to a semantic action or use | -
Button styles can be applied to anything with the .btn
class applied. However, typically you'll want to apply these to only <a>
and <button>
elements for the best rendering.
Button | +class="" | +Description | +
---|---|---|
+ | btn |
+ Standard gray button with gradient | +
+ | btn btn-primary |
+ Provides extra visual weight and identifies the primary action in a set of buttons | +
+ | btn btn-info |
+ Used as an alternative to the default styles | +
+ | btn btn-success |
+ Indicates a successful or positive action | +
+ | btn btn-warning |
+ Indicates caution should be taken with this action | +
+ | btn btn-danger |
+ Indicates a dangerous or potentially negative action | +
+ | btn btn-inverse |
+ Alternate dark gray button, not tied to a semantic action or use | +
IE9 doesn't crop background gradients on rounded corners, so we remove it. Related, IE9 jankifies disabled button
elements, rendering text gray with a nasty text-shadow that we cannot fix.
IE9 doesn't crop background gradients on rounded corners, so we remove it. Related, IE9 jankifies disabled button
elements, rendering text gray with a nasty text-shadow that we cannot fix.
Fancy larger or smaller buttons? Add .btn-large
, .btn-small
, or .btn-mini
for two additional sizes.
- - -
-- - -
-- - -
+Fancy larger or smaller buttons? Add .btn-large
, .btn-small
, or .btn-mini
for two additional sizes.
+ + +
++ + +
++ + +
-Make buttons look unclickable by fading them back 50%.
+Make buttons look unclickable by fading them back 50%.
-Add the .disabled
class to <a>
buttons.
- Primary link - Link -
+Add the .disabled
class to <a>
buttons.
+ Primary link + Link +
<a href="#" class="btn btn-large btn-primary disabled">Primary link</a> <a href="#" class="btn btn-large disabled">Link</a>-
- Heads up!
- We use .disabled
as a utility class here, similar to the common .active
class, so no prefix is required.
-
+ Heads up!
+ We use .disabled
as a utility class here, similar to the common .active
class, so no prefix is required.
+
Add the disabled
attribute to <button>
buttons.
- - -
+Add the disabled
attribute to <button>
buttons.
+ + +
<button type="button" class="btn btn-large btn-primary disabled" disabled="disabled">Primary button</button> <button type="button" class="btn btn-large" disabled>Button</button>-
Use the .btn
class on an <a>
, <button>
, or <input>
element.
Use the .btn
class on an <a>
, <button>
, or <input>
element.
<a class="btn" href="">Link</a> <button class="btn" type="submit"> @@ -1384,247 +1427,250 @@ For example, <code>section</code> should be wrapped as inline. <input class="btn" type="submit" value="Submit">-
As a best practice, try to match the element for you context to ensure matching cross-browser rendering. If you have an input
, use an <input type="submit">
for your button.
As a best practice, try to match the element for you context to ensure matching cross-browser rendering. If you have an input
, use an <input type="submit">
for your button.
140 icons in sprite form, available in dark gray (default) and white, provided by Glyphicons.
-140 icons in sprite form, available in dark gray (default) and white, provided by Glyphicons.
+Glyphicons Halflings are normally not available for free, but an arrangement between Bootstrap and the Glyphicons creators have made this possible at not cost to you as developers. As a thank you, we ask you to include an optional link back to Glyphicons whenever practical.
+Glyphicons Halflings are normally not available for free, but an arrangement between Bootstrap and the Glyphicons creators have made this possible at not cost to you as developers. As a thank you, we ask you to include an optional link back to Glyphicons whenever practical.
-All icons require an <i>
tag with a unique class, prefixed with icon-
. To use, place the following code just about anywhere:
All icons require an <i>
tag with a unique class, prefixed with icon-
. To use, place the following code just about anywhere:
<i class="icon-search"></i>-
There are also styles available for inverted (white) icons, made ready with one extra class:
+There are also styles available for inverted (white) icons, made ready with one extra class:
<i class="icon-search icon-white"></i>-
- Heads up!
- When using beside strings of text, as in buttons or nav links, be sure to leave a space after the <i>
tag for proper spacing.
-
+ Heads up!
+ When using beside strings of text, as in buttons or nav links, be sure to leave a space after the <i>
tag for proper spacing.
+
Use them in buttons, button groups for a toolbar, navigation, or prepended form inputs.
+Use them in buttons, button groups for a toolbar, navigation, or prepended form inputs.
-Dozens of reusable components are built into Bootstrap to provide navigation, alerts, popovers, and much more.
-An isolated (without dropdown toggle) dropdown menu example, designed to be used with the dropdown javascript plugin.
-An isolated (without dropdown toggle) dropdown menu example, designed to be used with the dropdown javascript plugin.
+<ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu"> <li><a tabindex="-1" href="#">Action</a></li> @@ -159,11 +133,11 @@-
Dropdowns require...
+Dropdowns require...
<ul class="nav nav-pills"> @@ -185,50 +159,50 @@ </ul>-
...
+...
-...
+...
-...
+...
-...
+...
-Two basic options, along with two more specific variations.
+Two basic options, along with two more specific variations.
-Wrap a series of buttons with .btn
in .btn-group
.
Wrap a series of buttons with .btn
in .btn-group
.
<div class="btn-group"> <button class="btn">1</button> @@ -237,26 +211,26 @@ </div>-
Combine sets of <div class="btn-group">
into a <div class="btn-toolbar">
for more complex components.
Combine sets of <div class="btn-group">
into a <div class="btn-toolbar">
for more complex components.
<div class="btn-toolbar"> <div class="btn-group"> @@ -265,16 +239,16 @@ </div>-
Make a set of buttons appear vertically stacked rather than horizontally.
-Make a set of buttons appear vertically stacked rather than horizontally.
+<div class="btn-group btn-group-vertical"> ... @@ -282,102 +256,102 @@-
Button groups can also function as radios, where only one button may be active, or checkboxes, where any number of buttons may be active. View the Javascript docs for that.
+Button groups can also function as radios, where only one button may be active, or checkboxes, where any number of buttons may be active. View the Javascript docs for that.
-Heads up! Buttons with dropdowns must be individually wrapped in their own .btn-group
within a .btn-toolbar
for proper rendering.
Heads up! Buttons with dropdowns must be individually wrapped in their own .btn-group
within a .btn-toolbar
for proper rendering.
Use any button to trigger a dropdown menu by placing it within a .btn-group
and providing the proper menu markup.
Use any button to trigger a dropdown menu by placing it within a .btn-group
and providing the proper menu markup.
<div class="btn-group"> <a class="btn dropdown-toggle" data-toggle="dropdown" href="#"> @@ -390,134 +364,134 @@ </div>-
Button dropdowns work at any size. your button sizes to .btn-large
, .btn-small
, or .btn-mini
.
Button dropdowns work at any size. your button sizes to .btn-large
, .btn-small
, or .btn-mini
.
Button dropdowns require the Bootstrap dropdown plugin to function.
-In some cases—like mobile—dropdown menus will extend outside the viewport. You need to resolve the alignment manually or with custom javascript.
+Button dropdowns require the Bootstrap dropdown plugin to function.
+In some cases—like mobile—dropdown menus will extend outside the viewport. You need to resolve the alignment manually or with custom javascript.
-Building on the button group styles and markup, we can easily create a split button. Split buttons feature a standard action on the left and a dropdown toggle on the right with contextual links.
-Building on the button group styles and markup, we can easily create a split button. Split buttons feature a standard action on the left and a dropdown toggle on the right with contextual links.
+<div class="btn-group"> <button class="btn">Action</button> @@ -530,49 +504,49 @@ </div>-
Utilize the extra button classes .btn-mini
, .btn-small
, or .btn-large
for sizing.
Utilize the extra button classes .btn-mini
, .btn-small
, or .btn-large
for sizing.
<div class="btn-group"> <button class="btn btn-mini">Action</button> @@ -585,34 +559,34 @@ </div>-
Dropdown menus can also be toggled from the bottom up by adding a single class to the immediate parent of .dropdown-menu
. It will flip the direction of the .caret
and reposition the menu itself to move from the bottom up instead of top down.
Dropdown menus can also be toggled from the bottom up by adding a single class to the immediate parent of .dropdown-menu
. It will flip the direction of the .caret
and reposition the menu itself to move from the bottom up instead of top down.
<div class="btn-group dropup"> <button class="btn">Dropup</button> @@ -625,29 +599,29 @@ </div>-
All nav components here—tabs, pills, and lists—share the same base markup and styles through the .nav
class.
All nav components here—tabs, pills, and lists—share the same base markup and styles through the .nav
class.
Take a regular <ul>
of links and add .nav-tabs
:
Take a regular <ul>
of links and add .nav-tabs
:
<ul class="nav nav-tabs"> <li class="active"> @@ -658,15 +632,15 @@ </ul>-
Take that same HTML, but use .nav-pills
instead:
Take that same HTML, but use .nav-pills
instead:
<ul class="nav nav-pills"> <li class="active"> @@ -677,15 +651,15 @@ </ul>-
For any nav component (tabs, pills, or list), add .disabled
for gray links and no hover effects. Links will remain clickable, however, unless custom javascript is implemented to prevent those clicks.
For any nav component (tabs, pills, or list), add .disabled
for gray links and no hover effects. Links will remain clickable, however, unless custom javascript is implemented to prevent those clicks.
<ul class="nav nav-pills"> ... @@ -694,38 +668,38 @@ </ul>-
To align nav links, use the .pull-left
or .pull-right
utility classes. Both classes will add a CSS float in the specified direction.
To align nav links, use the .pull-left
or .pull-right
utility classes. Both classes will add a CSS float in the specified direction.
As tabs and pills are horizontal by default, just add a second class, .nav-stacked
, to make them appear vertically stacked.
As tabs and pills are horizontal by default, just add a second class, .nav-stacked
, to make them appear vertically stacked.
<ul class="nav nav-tabs nav-stacked"> ... </ul>-
<ul class="nav nav-pills nav-stacked"> ... @@ -733,29 +707,29 @@-
Add dropdown menus with a little extra HTML and the dropdowns javascript plugin.
+Add dropdown menus with a little extra HTML and the dropdowns javascript plugin.
-<ul class="nav nav-tabs"> <li class="dropdown"> @@ -772,23 +746,23 @@ </ul>-
<ul class="nav nav-pills"> <li class="dropdown"> @@ -806,29 +780,29 @@-
A simple and easy way to build groups of nav links with optional headers. They're best used in sidebars like the Finder in OS X.
+A simple and easy way to build groups of nav links with optional headers. They're best used in sidebars like the Finder in OS X.
-Take a list of links and add class="nav nav-list"
:
Take a list of links and add class="nav nav-list"
:
<ul class="nav nav-list"> <li class="nav-header">List header</li> @@ -837,50 +811,50 @@ ... </ul>-
- Note
- For nesting within a nav list, include class="nav nav-list"
on any nested <ul>
.
-
+ Note
+ For nesting within a nav list, include class="nav nav-list"
on any nested <ul>
.
+
Add a horizontal divider by creating an empty list item with the class .divider
, like so:
Add a horizontal divider by creating an empty list item with the class .divider
, like so:
<ul class="nav nav-list"> ... <li class="divider"></li> ... </ul> -+ -
Bring your tabs to life with a simple plugin to toggle between content via tabs. Bootstrap integrates tabbable tabs in four styles: top (default), right, bottom, and left.
+Bring your tabs to life with a simple plugin to toggle between content via tabs. Bootstrap integrates tabbable tabs in four styles: top (default), right, bottom, and left.
-To make tabs tabbable, create a .tab-pane
with unique ID for every tab and wrap them in .tab-content
.
I'm in Section 1.
-Howdy, I'm in Section 2.
-What up girl, this is Section 3.
-To make tabs tabbable, create a .tab-pane
with unique ID for every tab and wrap them in .tab-content
.
<div class="tabbable"> <!-- Only required for left/right tabs --> <ul class="nav nav-tabs"> @@ -898,36 +872,36 @@ </div>-
To make tabs fade in, add .fade
to each .tab-pane
.
To make tabs fade in, add .fade
to each .tab-pane
.
All tabbable tabs are powered by our lightweight jQuery plugin. Read more about how to bring tabbable tabs to life on the javascript docs page.
+All tabbable tabs are powered by our lightweight jQuery plugin. Read more about how to bring tabbable tabs to life on the javascript docs page.
-Flip the order of the HTML and add a class to put tabs on the bottom.
-I'm in Section A.
-Howdy, I'm in Section B.
-What up girl, this is Section C.
-Flip the order of the HTML and add a class to put tabs on the bottom.
+<div class="tabbable tabs-below"> <div class="tab-content"> @@ -939,28 +913,28 @@ </div>-
Swap the class to put tabs on the left.
-I'm in Section A.
-Howdy, I'm in Section B.
-What up girl, this is Section C.
-Swap the class to put tabs on the left.
+ -<div class="tabbable tabs-left"> <ul class="nav nav-tabs"> @@ -972,28 +946,28 @@ </div>-
Swap the class to put tabs on the right.
-I'm in Section A.
-Howdy, I'm in Section B.
-What up girl, this is Section C.
-Swap the class to put tabs on the right.
+ -<div class="tabbable tabs-right"> <ul class="nav nav-tabs"> @@ -1005,32 +979,32 @@ </div>- + - -
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 .container
, which sets the width of your site and content.
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 .container
, which sets the width of your site and content.
<div class="navbar"> <div class="navbar-inner"> @@ -1045,19 +1019,19 @@-
A simple link to show your brand or project name only requires an anchor tag.
+A simple link to show your brand or project name only requires an anchor tag.
<a class="brand" href="#">Project name</a>-
Nav items are simple to add via unordered lists.
+Nav items are simple to add via unordered lists.
<ul class="nav"> <li class="active"> @@ -1067,7 +1041,7 @@ <li><a href="#">Link</a></li> </ul>-
You can easily add dividers to your nav links with an empty list item and a simple class. Just add this between links:
+You can easily add dividers to your nav links with an empty list item and a simple class. Just add this between links:
<ul class="nav"> ... @@ -1076,27 +1050,27 @@ </ul>-
To properly style and position a form within the navbar, add the appropriate classes as shown below. For a default form, include .navbar-form
and either .pull-left
or .pull-right
to properly align it.
To properly style and position a form within the navbar, add the appropriate classes as shown below. For a default form, include .navbar-form
and either .pull-left
or .pull-right
to properly align it.
<form class="navbar-form pull-left"> <input type="text" class="span2"> </form>-
For a more customized search form, add .navbar-search
to the form
and .search-query
to the input for specialized styles in the navbar.
For a more customized search form, add .navbar-search
to the form
and .search-query
to the input for specialized styles in the navbar.
<form class="navbar-search pull-left"> <input type="text" class="search-query" placeholder="Search"> </form>-
Align nav links, search form, or text, use the .pull-left
or .pull-right
utility classes. Both classes will add a CSS float in the specified direction.
Align nav links, search form, or text, use the .pull-left
or .pull-right
utility classes. Both classes will add a CSS float in the specified direction.
Add dropdowns and dropups to the nav with a bit of markup and the dropdowns javascript plugin.
+Add dropdowns and dropups to the nav with a bit of markup and the dropdowns javascript plugin.
<ul class="nav"> <li class="dropdown"> @@ -1110,56 +1084,56 @@ </li> </ul>-
Visit the javascript dropdowns documentation for more markup and information on calling dropdowns.
+Visit the javascript dropdowns documentation for more markup and information on calling dropdowns.
-Wrap strings of text in an element with .navbar-text
, usually on a <p>
tag for proper leading and color.
Wrap strings of text in an element with .navbar-text
, usually on a <p>
tag for proper leading and color.
Fix the navbar to the top or bottom of the viewport with an additional class on the outermost div, .navbar
.
Fix the navbar to the top or bottom of the viewport with an additional class on the outermost div, .navbar
.
Add .navbar-fixed-top
and remember to account for the hidden area underneath it by adding at least 40px padding
to the <body>
. Be sure to add this after the core Bootstrap CSS and before the optional responsive CSS.
Add .navbar-fixed-top
and remember to account for the hidden area underneath it by adding at least 40px padding
to the <body>
. Be sure to add this after the core Bootstrap CSS and before the optional responsive CSS.
<div class="navbar navbar-fixed-top"> ... </div>-
Add .navbar-fixed-bottom
instead.
<div class="navbar navbar-fixed-bottom"> ... @@ -1167,61 +1141,61 @@-
To implement a collapsing responsive navbar, wrap your navbar content in a containing div, .nav-collapse.collapse
, and add the navbar toggle button, .btn-navbar
.
To implement a collapsing responsive navbar, wrap your navbar content in a containing div, .nav-collapse.collapse
, and add the navbar toggle button, .btn-navbar
.
<div class="navbar"> <div class="navbar-inner"> @@ -1246,94 +1220,94 @@ </div> </div>-
To implement a collapsing responsive navbar, wrap your navbar content in a containing div, .nav-collapse.collapse
, and add the navbar toggle button, .btn-navbar
.
To implement a collapsing responsive navbar, wrap your navbar content in a containing div, .nav-collapse.collapse
, and add the navbar toggle button, .btn-navbar
.
A single example shown as it might be displayed across multiple pages.
- +A single example shown as it might be displayed across multiple pages.
+<ul class="breadcrumb"> <li><a href="#">Home</a> <span class="divider">/</span></li> @@ -1342,32 +1316,32 @@ </ul>-
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.
- +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.
+<div class="pagination"> <ul> @@ -1382,26 +1356,26 @@-
Links are customizable for different circumstances. Use .disabled
for unclickable links and .active
to indicate the current page.
Links are customizable for different circumstances. Use .disabled
for unclickable links and .active
to indicate the current page.
<div class="pagination "> <ul> @@ -1412,39 +1386,39 @@ </div>-
Add one of two optional classes to change the alignment of pagination links: .pagination-centered
and .pagination-right
.
Add one of two optional classes to change the alignment of pagination links: .pagination-centered
and .pagination-right
.
<div class="pagination pagination-centered"> ... </div>- +
<div class="pagination pagination-right"> ... @@ -1452,20 +1426,20 @@-
Quick previous and next links for simple pagination implementations with light markup and styles. It's great for simple sites like blogs or magazines.
+Quick previous and next links for simple pagination implementations with light markup and styles. It's great for simple sites like blogs or magazines.
-By default, the pager centers links.
- +By default, the pager centers links.
+<ul class="pager"> <li> @@ -1477,14 +1451,14 @@ </ul>-
Alternatively, you can align each link to the sides:
- +Alternatively, you can align each link to the sides:
+<ul class="pager"> <li class="previous"> @@ -1496,14 +1470,14 @@ </ul>-
Pager links also use the general .disabled
utility class from the pagination.
Pager links also use the general .disabled
utility class from the pagination.
<ul class="pager"> <li class="previous disabled"> @@ -1513,187 +1487,187 @@ </ul>-
Labels | -Markup | -
---|---|
- Default - | -
- <span class="label">Default</span>
- |
-
- Success - | -
- <span class="label label-success">Success</span>
- |
-
- Warning - | -
- <span class="label label-warning">Warning</span>
- |
-
- Important - | -
- <span class="label label-important">Important</span>
- |
-
- Info - | -
- <span class="label label-info">Info</span>
- |
-
- Inverse - | -
- <span class="label label-inverse">Inverse</span>
- |
-
Labels | +Markup | +
---|---|
+ Default + | +
+ <span class="label">Default</span>
+ |
+
+ Success + | +
+ <span class="label label-success">Success</span>
+ |
+
+ Warning + | +
+ <span class="label label-warning">Warning</span>
+ |
+
+ Important + | +
+ <span class="label label-important">Important</span>
+ |
+
+ Info + | +
+ <span class="label label-info">Info</span>
+ |
+
+ Inverse + | +
+ <span class="label label-inverse">Inverse</span>
+ |
+
Badges are small, simple components for displaying an indicator or count of some sort. They're commonly found in email clients like Mail.app or on mobile apps for push notifications.
+Badges are small, simple components for displaying an indicator or count of some sort. They're commonly found in email clients like Mail.app or on mobile apps for push notifications.
-Name | -Example | -Markup | -
---|---|---|
- Default - | -- 1 - | -
- <span class="badge">1</span>
- |
-
- Success - | -- 2 - | -
- <span class="badge badge-success">2</span>
- |
-
- Warning - | -- 4 - | -
- <span class="badge badge-warning">4</span>
- |
-
- Important - | -- 6 - | -
- <span class="badge badge-important">6</span>
- |
-
- Info - | -- 8 - | -
- <span class="badge badge-info">8</span>
- |
-
- Inverse - | -- 10 - | -
- <span class="badge badge-inverse">10</span>
- |
-
Name | +Example | +Markup | +
---|---|---|
+ Default + | ++ 1 + | +
+ <span class="badge">1</span>
+ |
+
+ Success + | ++ 2 + | +
+ <span class="badge badge-success">2</span>
+ |
+
+ Warning + | ++ 4 + | +
+ <span class="badge badge-warning">4</span>
+ |
+
+ Important + | ++ 6 + | +
+ <span class="badge badge-important">6</span>
+ |
+
+ Info + | ++ 8 + | +
+ <span class="badge badge-info">8</span>
+ |
+
+ Inverse + | ++ 10 + | +
+ <span class="badge badge-inverse">10</span>
+ |
+
A lightweight, flexible component called a hero unit to showcase content on your site. It works well on marketing and content-heavy sites.
-This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
- -A lightweight, flexible component called a hero unit to showcase content on your site. It works well on marketing and content-heavy sites.
+This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.
+ +<div class="hero-unit"> <h1>Heading</h1> @@ -1706,105 +1680,105 @@ </div>-
A simple shell for an h1
to appropriately space out and segment sections of content on a page. It can utilize the h1
's default small
, element as well most other components (with additional styles).
A simple shell for an h1
to appropriately space out and segment sections of content on a page. It can utilize the h1
's default small
, element as well most other components (with additional styles).
<div class="page-header"> <h1>Example page header</h1> </div>-
By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.
- +By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.
+ -With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.
-With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.
+Thumbnails (previously .media-grid
up until v1.4) are great for grids of photos or videos, image search results, retail products, portfolios, and much more. They can be links or static content.
Thumbnails (previously .media-grid
up until v1.4) are great for grids of photos or videos, image search results, retail products, portfolios, and much more. They can be links or static content.
Thumbnail markup is simple—a ul
with any number of li
elements is all that is required. It's also super flexible, allowing for any type of content with just a bit more markup to wrap your contents.
Thumbnail markup is simple—a ul
with any number of li
elements is all that is required. It's also super flexible, allowing for any type of content with just a bit more markup to wrap your contents.
Lastly, the thumbnails component uses existing grid system classes—like .span2
or .span3
—for control of thumbnail dimensions.
Lastly, the thumbnails component uses existing grid system classes—like .span2
or .span3
—for control of thumbnail dimensions.
As mentioned previously, the required markup for thumbnails is light and straightforward. Here's a look at the default setup for linked images:
+As mentioned previously, the required markup for thumbnails is light and straightforward. Here's a look at the default setup for linked images:
<ul class="thumbnails"> <li class="span4"> @@ -1815,7 +1789,7 @@ ... </ul>-
For custom HTML content in thumbnails, the markup changes slightly. To allow block level content anywhere, we swap the <a>
for a <div>
like so:
For custom HTML content in thumbnails, the markup changes slightly. To allow block level content anywhere, we swap the <a>
for a <div>
like so:
<ul class="thumbnails"> <li class="span4"> @@ -1829,65 +1803,65 @@ </ul>-
Explore all your options with the various grid classes available to you. You can also mix and match different sizes.
- +Explore all your options with the various grid classes available to you. You can also mix and match different sizes.
+ -Wrap any text and an optional dismiss button in .alert
for a basic warning alert message.
Wrap any text and an optional dismiss button in .alert
for a basic warning alert message.
<div class="alert"> <button type="button" class="close" data-dismiss="alert">×</button> @@ -1895,32 +1869,32 @@ </div>-
Mobile Safari and Mobile Opera browsers, in addition to the data-dismiss="alert"
attribute, require an href="#"
for the dismissal of alerts when using an <a>
tag.
Mobile Safari and Mobile Opera browsers, in addition to the data-dismiss="alert"
attribute, require an href="#"
for the dismissal of alerts when using an <a>
tag.
<a href="#" class="close" data-dismiss="alert">×</button>-
Alternatively, you may use a <button>
element with the data attribute, which we have opted to do for our docs. When using <button>
, you must include type="button"
or your forms may not submit.
Alternatively, you may use a <button>
element with the data attribute, which we have opted to do for our docs. When using <button>
, you must include type="button"
or your forms may not submit.
<button type="button" class="close" data-dismiss="alert">×</button>-
Use the alerts jQuery plugin for quick and easy dismissal of alerts.
+Use the alerts jQuery plugin for quick and easy dismissal of alerts.
-For longer messages, increase the padding on the top and bottom of the alert wrapper by adding .alert-block
.
Best check yo self, you're not looking too good. Nulla vitae elit libero, a pharetra augue. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.
-For longer messages, increase the padding on the top and bottom of the alert wrapper by adding .alert-block
.
Best check yo self, you're not looking too good. Nulla vitae elit libero, a pharetra augue. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.
+<div class="alert alert-block"> <a class="close" data-dismiss="alert" href="#">×</a> @@ -1930,97 +1904,97 @@-
Add optional classes to change an alert's connotation.
+Add optional classes to change an alert's connotation.
-<div class="alert alert-error"> ... </div>-
<div class="alert alert-success"> ... </div>-
<div class="alert alert-info"> ... </div>-
Default progress bar with a vertical gradient.
-Default progress bar with a vertical gradient.
+<div class="progress"> <div class="bar" style="width: 60%;"></div> </div>-
Uses a gradient to create a striped effect. Not available in IE7-8.
-Uses a gradient to create a striped effect. Not available in IE7-8.
+<div class="progress progress-striped"> <div class="bar" style="width: 20%;"></div> </div>-
Add .active
to .progress-striped
to animate the stripes right to left. Not available in all versions of IE.
Add .active
to .progress-striped
to animate the stripes right to left. Not available in all versions of IE.
<div class="progress progress-striped active"> <div class="bar" style="width: 40%;"></div> @@ -2028,27 +2002,27 @@-
Progress bars use some of the same button and alert classes for consistent styles.
-Progress bars use some of the same button and alert classes for consistent styles.
+<div class="progress progress-info"> <div class="bar" style="width: 20%"></div> @@ -2064,22 +2038,22 @@ </div>-
Similar to the solid colors, we have varied striped progress bars.
-Similar to the solid colors, we have varied striped progress bars.
+<div class="progress progress-info progress-striped"> <div class="bar" style="width: 20%"></div> @@ -2096,74 +2070,74 @@-
Progress bars use CSS3 gradients, transitions, and animations to achieve all their effects. These features are not supported in IE7-9 or older versions of Firefox.
-Opera and IE do not support animations at this time.
+Progress bars use CSS3 gradients, transitions, and animations to achieve all their effects. These features are not supported in IE7-9 or older versions of Firefox.
+Opera and IE do not support animations at this time.
-Use the well as a simple effect on an element to give it an inset effect.
-Use the well as a simple effect on an element to give it an inset effect.
+<div class="well"> ... </div>-
Control padding and rounded corners with two optional modifier classes.
-Control padding and rounded corners with two optional modifier classes.
+<div class="well well-large"> ... </div>-
<div class="well well-small"> ... </div>-
Use the generic close icon for dismissing content like modals and alerts.
-Use the generic close icon for dismissing content like modals and alerts.
+<button class="close">×</button>
iOS devices require an href="#" for click events if you rather use an anchor.
<a class="close" href="#">×</a>-
Simple, focused classes for small display or behavior tweaks.
+Simple, focused classes for small display or behavior tweaks.
-Float an element left
+Float an element left
class="pull-left"@@ -2173,8 +2147,8 @@ class="pull-left" } -
Float an element right
+Float an element right
class="pull-right"@@ -2184,8 +2158,8 @@ class="pull-right" } -
Change an element's color to #999
Change an element's color to #999
class="muted"@@ -2195,8 +2169,8 @@ class="muted" } -
Clear the float
on any element
Clear the float
on any element
class="clearfix"@@ -2214,7 +2188,9 @@ class="clearfix" } -
Extend Bootstrap with LESS, a CSS preprocessor, to take advantage of the variables, mixins, and more used to build Bootstrap's CSS.
-Extend Bootstrap to take advantage of included styles and components, as well as LESS variables and mixins.
Bootstrap is made with LESS at its core, a dynamic stylesheet language created by our good friend, Alexis Sellier. It makes developing systems-based CSS faster, easier, and more fun.
- -As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.
- -Visit the official website at http://lesscss.org to learn more.
- -Managing colors and pixel values in CSS can be a bit of a pain, usually full of copy and paste. Not with LESS though—assign colors or pixel values as variables and change them once.
- -Those three border-radius declarations you need to make in regular ol' CSS? Now they're down to one line with the help of mixins, snippets of code you can reuse anywhere.
- -Make your grid, leading, and more super flexible by doing the math on the fly with operations. Multiply, divide, add, and subtract your way to CSS sanity.
- +Bootstrap is made with LESS at its core, a dynamic stylesheet language created by our good friend, Alexis Sellier. It makes developing systems-based CSS faster, easier, and more fun.
-Install the LESS command line compiler, JSHint, Recess, and uglify-js globally with npm by running the following command:
-$ npm install -g less jshint recess uglify-js-
Once installed just run make
from the root of your bootstrap directory and you're all set.
Additionally, if you have watchr installed, you may run make watch
to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).
As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.
-Install the LESS command line tool via Node and run the following command:
-$ lessc ./less/bootstrap.less > bootstrap.css-
Be sure to include --compress
in that command if you're trying to save some bytes!
Visit the official website at http://lesscss.org to learn more.
+Download the latest Less.js and include the path to it (and Bootstrap) in the <head>
.
Install the LESS command line compiler, JSHint, Recess, and uglify-js globally with npm by running the following command:
+$ npm install -g less jshint recess uglify-js+
Once installed just run make
from the root of your bootstrap directory and you're all set.
Additionally, if you have watchr installed, you may run make watch
to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).
Install the LESS command line tool via Node and run the following command:
+$ lessc ./less/bootstrap.less > bootstrap.css+
Be sure to include --compress
in that command if you're trying to save some bytes!
Download the latest Less.js and include the path to it (and Bootstrap) in the <head>
.
<link rel="stylesheet/less" href="/path/to/bootstrap.less"> <script src="/path/to/less.js"></script>-
To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.
+To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.
-The unofficial Mac app watches directories of .less files and compiles the code to local files after every save of a watched .less file.
-If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.
+The unofficial Mac app watches directories of .less files and compiles the code to local files after every save of a watched .less file.
+If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.
-Crunch is a great looking LESS editor and compiler built on Adobe Air.
-Created by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.
-Mac, Linux, and PC app for drag and drop compiling of LESS files. Plus, the source code is on GitHub.
+Crunch is a great looking LESS editor and compiler built on Adobe Air.
+Created by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.
+Mac, Linux, and PC app for drag and drop compiling of LESS files. Plus, the source code is on GitHub.
-...
+Bring Bootstrap's components to life—now with 12 custom jQuery plugins. -
If you have downloaded the latest version of Bootstrap, both bootstrap.js and bootstrap.min.js contain all of these plugins.
- -...
- -...
- - - -For simple transition effects, include bootstrap-transition.js once alongside the other JS files. If you're using the compiled (or minified) bootstrap.js, there is no need to include this—it's already there.
-A few examples of the transition plugin:
-Modals are streamlined, but flexible, dialog prompts with the minimum required functionality and smart defaults.
- -A rendered modal with header, body, and set of actions in the footer.
-One fine body…
+ +If you have downloaded the latest version of Bootstrap, both bootstrap.js and bootstrap.min.js contain all of these plugins.
+ +...
+ +...
+ + + + + + + + +For simple transition effects, include bootstrap-transition.js once alongside the other JS files. If you're using the compiled (or minified) bootstrap.js, there is no need to include this—it's already there.
+A few examples of the transition plugin:
+Modals are streamlined, but flexible, dialog prompts with the minimum required functionality and smart defaults.
+ +A rendered modal with header, body, and set of actions in the footer.
+<div class="modal hide fade"> <div class="modal-header"> @@ -205,43 +188,43 @@ </div>-
Toggle a modal via javascript by clicking the button below. It will slide down and fade in from the top of the page.
- -Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem.
+Toggle a modal via javascript by clicking the button below. It will slide down and fade in from the top of the page.
+ +Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem.
-This button should trigger a popover on hover.
+This button should trigger a popover on hover.
-This link and that link should have tooltips on hover.
+This link and that link should have tooltips on hover.
-We set a fixed max-height
on the .modal-body
. Watch it overflow with all this extra lorem ipsum text we've included.
Cras mattis consectetur purus sit amet fermentum. Cras justo odio, dapibus ac facilisis in, egestas eget quam. Morbi leo risus, porta ac consectetur ac, vestibulum at eros.
-Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor.
-Aenean lacinia bibendum nulla sed consectetur. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Donec sed odio dui. Donec ullamcorper nulla non metus auctor fringilla.
-Cras mattis consectetur purus sit amet fermentum. Cras justo odio, dapibus ac facilisis in, egestas eget quam. Morbi leo risus, porta ac consectetur ac, vestibulum at eros.
-Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor.
-Aenean lacinia bibendum nulla sed consectetur. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Donec sed odio dui. Donec ullamcorper nulla non metus auctor fringilla.
-We set a fixed max-height
on the .modal-body
. Watch it overflow with all this extra lorem ipsum text we've included.
Cras mattis consectetur purus sit amet fermentum. Cras justo odio, dapibus ac facilisis in, egestas eget quam. Morbi leo risus, porta ac consectetur ac, vestibulum at eros.
+Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor.
+Aenean lacinia bibendum nulla sed consectetur. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Donec sed odio dui. Donec ullamcorper nulla non metus auctor fringilla.
+Cras mattis consectetur purus sit amet fermentum. Cras justo odio, dapibus ac facilisis in, egestas eget quam. Morbi leo risus, porta ac consectetur ac, vestibulum at eros.
+Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor.
+Aenean lacinia bibendum nulla sed consectetur. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Donec sed odio dui. Donec ullamcorper nulla non metus auctor fringilla.
+<-- Button to trigger modal --> <a href="#myModal" role="button" class="btn" data-toggle="modal">Launch demo modal</a> @@ -263,214 +246,214 @@-
Activate a modal without writing javascript. Set data-toggle="modal"
on a controller element, like a button, along with a data-target="#foo"
or href="#foo"
to target a specific modal to toggle.
Activate a modal without writing javascript. Set data-toggle="modal"
on a controller element, like a button, along with a data-target="#foo"
or href="#foo"
to target a specific modal to toggle.
<button type="button" data-toggle="modal" data-target="#myModal">Launch modal</button>-
Call a modal with id myModal
with a single line of javascript:
$('#myModal').modal(options)+
Call a modal with id myModal
with a single line of javascript:
$('#myModal').modal(options)-
Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-backdrop=""
.
Name | -type | -default | -description | -
---|---|---|---|
backdrop | -boolean | -true | -Includes a modal-backdrop element. Alternatively, specify static for a backdrop which doesn't close the modal on click. |
-
keyboard | -boolean | -true | -Closes the modal when escape key is pressed | -
show | -boolean | -true | -Shows the modal when initialized. | -
remote | -path | -false | -If a remote url is provided, content will be loaded via jQuery's
|
-
Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-backdrop=""
.
Name | +type | +default | +description | +
---|---|---|---|
backdrop | +boolean | +true | +Includes a modal-backdrop element. Alternatively, specify static for a backdrop which doesn't close the modal on click. |
+
keyboard | +boolean | +true | +Closes the modal when escape key is pressed | +
show | +boolean | +true | +Shows the modal when initialized. | +
remote | +path | +false | +If a remote url is provided, content will be loaded via jQuery's
|
+
Activates your content as a modal. Accepts an optional options object
.
Activates your content as a modal. Accepts an optional options object
.
$('#myModal').modal({ keyboard: false })-
Manually toggles a modal.
-$('#myModal').modal('toggle')-
Manually opens a modal.
-$('#myModal').modal('show')-
Manually hides a modal.
-$('#myModal').modal('hide')-
Bootstrap's modal class exposes a few events for hooking into modal functionality.
-Event | -Description | -
---|---|
show | -This event fires immediately when the show instance method is called. |
-
shown | -This event is fired when the modal has been made visible to the user (will wait for css transitions to complete). | -
hide | -This event is fired immediately when the hide instance method has been called. |
-
hidden | -This event is fired when the modal has finished being hidden from the user (will wait for css transitions to complete). | -
Manually toggles a modal.
+$('#myModal').modal('toggle')+
Manually opens a modal.
+$('#myModal').modal('show')+
Manually hides a modal.
+$('#myModal').modal('hide')+
Bootstrap's modal class exposes a few events for hooking into modal functionality.
+Event | +Description | +
---|---|
show | +This event fires immediately when the show instance method is called. |
+
shown | +This event is fired when the modal has been made visible to the user (will wait for css transitions to complete). | +
hide | +This event is fired immediately when the hide instance method has been called. |
+
hidden | +This event is fired when the modal has finished being hidden from the user (will wait for css transitions to complete). | +
$('#myModal').on('hidden', function () { // do something… })-
Add dropdown menus to nearly anything with this simple plugin, including the navbar, tabs, and pills.
- -Add dropdown menus to nearly anything with this simple plugin, including the navbar, tabs, and pills.
+ +Add data-toggle="dropdown"
to a link or button to toggle a dropdown.
Add data-toggle="dropdown"
to a link or button to toggle a dropdown.
<div class="dropdown"> <a class="dropdown-toggle" href="#">Dropdown trigger</a> @@ -479,7 +462,7 @@ $('#myModal').on('hidden', function () { </ul> </div>-
To keep URLs intact, use the data-target
attribute instead of href="#"
.
To keep URLs intact, use the data-target
attribute instead of href="#"
.
<div class="dropdown"> <a class="dropdown-toggle" id="dLabel" role="button" data-toggle="dropdown" data-target="#" href="/page.html"> @@ -492,179 +475,179 @@ $('#myModal').on('hidden', function () { </div>-
Call the dropdowns via javascript:
-$('.dropdown-toggle').dropdown()+
Call the dropdowns via javascript:
+$('.dropdown-toggle').dropdown()-
None
+None
-A programatic api for activating menus for a given navbar or tabbed navigation.
- +A programatic api for activating menus for a given navbar or tabbed navigation.
+ - -The ScrollSpy plugin is for automatically updating nav targets based on scroll position. Scroll the area below the navbar and watch the active class change. The dropdown sub items will be highlighted as well.
-The ScrollSpy plugin is for automatically updating nav targets based on scroll position. Scroll the area below the navbar and watch the active class change. The dropdown sub items will be highlighted as well.
+Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
+Veniam marfa mustache skateboard, adipisicing fugiat velit pitchfork beard. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. Tattooed cosby sweater food truck, mcsweeney's quis non freegan vinyl. Lo-fi wes anderson +1 sartorial. Carles non aesthetic exercitation quis gentrify. Brooklyn adipisicing craft beer vice keytar deserunt.
+Occaecat commodo aliqua delectus. Fap craft beer deserunt skateboard ea. Lomo bicycle rights adipisicing banh mi, velit ea sunt next level locavore single-origin coffee in magna veniam. High life id vinyl, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi DIY minim messenger bag. Cred ex in, sustainable delectus consectetur fanny pack iphone.
+In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.
+Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
+Keytar twee blog, culpa messenger bag marfa whatever delectus food truck. Sapiente synth id assumenda. Locavore sed helvetica cliche irony, thundercats you probably haven't heard of them consequat hoodie gluten-free lo-fi fap aliquip. Labore elit placeat before they sold out, terry richardson proident brunch nesciunt quis cosby sweater pariatur keffiyeh ut helvetica artisan. Cardigan craft beer seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats. +
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
-Veniam marfa mustache skateboard, adipisicing fugiat velit pitchfork beard. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. Tattooed cosby sweater food truck, mcsweeney's quis non freegan vinyl. Lo-fi wes anderson +1 sartorial. Carles non aesthetic exercitation quis gentrify. Brooklyn adipisicing craft beer vice keytar deserunt.
-Occaecat commodo aliqua delectus. Fap craft beer deserunt skateboard ea. Lomo bicycle rights adipisicing banh mi, velit ea sunt next level locavore single-origin coffee in magna veniam. High life id vinyl, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi DIY minim messenger bag. Cred ex in, sustainable delectus consectetur fanny pack iphone.
-In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.
-Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
-Keytar twee blog, culpa messenger bag marfa whatever delectus food truck. Sapiente synth id assumenda. Locavore sed helvetica cliche irony, thundercats you probably haven't heard of them consequat hoodie gluten-free lo-fi fap aliquip. Labore elit placeat before they sold out, terry richardson proident brunch nesciunt quis cosby sweater pariatur keffiyeh ut helvetica artisan. Cardigan craft beer seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats. -
-To easily add scrollspy behavior to your topbar navigation, just add data-spy="scroll"
to the element you want to spy on (most typically this would be the body) and data-target=".navbar"
to select which nav to use.
<body data-spy="scroll" data-target=".navbar">...</body>+
To easily add scrollspy behavior to your topbar navigation, just add data-spy="scroll"
to the element you want to spy on (most typically this would be the body) and data-target=".navbar"
to select which nav to use.
<body data-spy="scroll" data-target=".navbar">...</body>-
Call the scrollspy via javascript:
-$('#navbar').scrollspy()+
Call the scrollspy via javascript:
+$('#navbar').scrollspy()-
<a href="#home">home</a>
must correspond to something in the dom like <div id="home"></div>
.
- <a href="#home">home</a>
must correspond to something in the dom like <div id="home"></div>
.
+ When using scrollspy in conjunction with adding or removing of elements from the DOM, you'll need to call the refresh method like so:
+When using scrollspy in conjunction with adding or removing of elements from the DOM, you'll need to call the refresh method like so:
$('[data-spy="scroll"]').each(function () { var $spy = $(this).scrollspy('refresh') });-
Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-offset=""
.
Name | -type | -default | -description | -
---|---|---|---|
offset | -number | -10 | -Pixels to offset from top when calculating position of scroll. | -
Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-offset=""
.
Name | +type | +default | +description | +
---|---|---|---|
offset | +number | +10 | +Pixels to offset from top when calculating position of scroll. | +
Event | -Description | -
---|---|
activate | -This event fires whenever a new item becomes activated by the scrollspy. | -
Event | +Description | +
---|---|
activate | +This event fires whenever a new item becomes activated by the scrollspy. | +
Add quick, dynamic tab functionality to transiton through panes of local content, even via dropdown menus.
-Add quick, dynamic tab functionality to transiton through panes of local content, even via dropdown menus.
+Raw denim you probably haven't heard of them jean shorts Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Mustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Cosby sweater eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan american apparel, butcher voluptate nisi qui.
+Raw denim you probably haven't heard of them jean shorts Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Mustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Cosby sweater eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan american apparel, butcher voluptate nisi qui.
+Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.
+Etsy mixtape wayfarers, ethical wes anderson tofu before they sold out mcsweeney's organic lomo retro fanny pack lo-fi farm-to-table readymade. Messenger bag gentrify pitchfork tattooed craft beer, iphone skateboard locavore carles etsy salvia banksy hoodie helvetica. DIY synth PBR banksy irony. Leggings gentrify squid 8-bit cred pitchfork. Williamsburg banh mi whatever gluten-free, carles pitchfork biodiesel fixie etsy retro mlkshk vice blog. Scenester cred you probably haven't heard of them, vinyl craft beer blog stumptown. Pitchfork sustainable tofu synth chambray yr.
+Trust fund seitan letterpress, keytar raw denim keffiyeh etsy art party before they sold out master cleanse gluten-free squid scenester freegan cosby sweater. Fanny pack portland seitan DIY, art party locavore wolf cliche high life echo park Austin. Cred vinyl keffiyeh DIY salvia PBR, banh mi before they sold out farm-to-table VHS viral locavore cosby sweater. Lomo wolf viral, mustache readymade thundercats keffiyeh craft beer marfa ethical. Wolf salvia freegan, sartorial keffiyeh echo park vegan.
+Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.
-Etsy mixtape wayfarers, ethical wes anderson tofu before they sold out mcsweeney's organic lomo retro fanny pack lo-fi farm-to-table readymade. Messenger bag gentrify pitchfork tattooed craft beer, iphone skateboard locavore carles etsy salvia banksy hoodie helvetica. DIY synth PBR banksy irony. Leggings gentrify squid 8-bit cred pitchfork. Williamsburg banh mi whatever gluten-free, carles pitchfork biodiesel fixie etsy retro mlkshk vice blog. Scenester cred you probably haven't heard of them, vinyl craft beer blog stumptown. Pitchfork sustainable tofu synth chambray yr.
-Trust fund seitan letterpress, keytar raw denim keffiyeh etsy art party before they sold out master cleanse gluten-free squid scenester freegan cosby sweater. Fanny pack portland seitan DIY, art party locavore wolf cliche high life echo park Austin. Cred vinyl keffiyeh DIY salvia PBR, banh mi before they sold out farm-to-table VHS viral locavore cosby sweater. Lomo wolf viral, mustache readymade thundercats keffiyeh craft beer marfa ethical. Wolf salvia freegan, sartorial keffiyeh echo park vegan.
-Enable tabbable tabs via javascript (each tab needs to be activated individually):
+Enable tabbable tabs via javascript (each tab needs to be activated individually):
$('#myTab a').click(function (e) { e.preventDefault(); @@ -678,8 +661,8 @@ $('#myTab a:last').tab('show'); // Select last tab $('#myTab li:eq(2) a').tab('show'); // Select third tab (0-indexed)-
You can activate a tab or pill navigation without writing any javascript by simply specifying data-toggle="tab"
or data-toggle="pill"
on an element. Adding the nav
and nav-tabs
classes to the tab ul
will apply the bootstrap tab styling.
You can activate a tab or pill navigation without writing any javascript by simply specifying data-toggle="tab"
or data-toggle="pill"
on an element. Adding the nav
and nav-tabs
classes to the tab ul
will apply the bootstrap tab styling.
<ul class="nav nav-tabs"> <li><a href="#home" data-toggle="tab">Home</a></li> @@ -688,11 +671,11 @@ $('#myTab li:eq(2) a').tab('show'); // Select third tab (0-indexed) <li><a href="#settings" data-toggle="tab">Settings</a></li> </ul>-
- Activates a tab element and content container. Tab should have either a data-target
or an href
targeting a container node in the DOM.
-
+ Activates a tab element and content container. Tab should have either a data-target
or an href
targeting a container node in the DOM.
+
<ul class="nav nav-tabs" id="myTab"> <li class="active"><a href="#home">Home</a></li> @@ -714,418 +697,427 @@ $('#myTab li:eq(2) a').tab('show'); // Select third tab (0-indexed) }) </script>-
Event | -Description | -
---|---|
show | -This event fires on tab show, but before the new tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively. |
-
shown | -This event fires on tab show after a tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively. |
-
Event | +Description | +
---|---|
show | +This event fires on tab show, but before the new tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively. |
+
shown | +This event fires on tab show after a tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively. |
+
$('a[data-toggle="tab"]').on('shown', function (e) { e.target // activated tab e.relatedTarget // previous tab })- + - -
Inspired by the excellent jQuery.tipsy plugin written by Jason Frame; Tooltips are an updated version, which don't rely on images, use CSS3 for animations, and data-attributes for local title storage.
-Hover over the links below to see tooltips:
-Tight pants next level keffiyeh you probably haven't heard of them. Photo booth beard raw denim letterpress vegan messenger bag stumptown. Farm-to-table seitan, mcsweeney's fixie sustainable quinoa 8-bit american apparel have a terry richardson vinyl chambray. Beard stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, four loko mcsweeney's cleanse vegan chambray. A really ironic artisan whatever keytar, scenester farm-to-table banksy Austin twitter handle freegan cred raw denim single-origin coffee viral. -
-Trigger the tooltip via javascript:
-$('#example').tooltip(options)- -
Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-animation=""
.
Name | -type | -default | -description | -
---|---|---|---|
animation | -boolean | -true | -apply a css fade transition to the tooltip | -
html | -boolean | -true | -Insert html into the tooltip. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks. |
-
placement | -string|function | -'top' | -how to position the tooltip - top | bottom | left | right | -
selector | -string | -false | -If a selector is provided, tooltip objects will be delegated to the specified targets. | -
title | -string | function | -'' | -default title value if `title` tag isn't present | -
trigger | -string | -'hover' | -how tooltip is triggered - hover | focus | manual | -
delay | -number | object | -0 | -
- delay showing and hiding the tooltip (ms) - does not apply to manual trigger type -If a number is supplied, delay is applied to both hide/show -Object structure is: |
-
For performance reasons, the Tooltip and Popover data-apis are opt in. If you would like to use them just specify a selector option.
--<a href="#" rel="tooltip" title="first tooltip">hover over me</a> -- -
Attaches a tooltip handler to an element collection.
-Reveals an element's tooltip.
-$('#element').tooltip('show')-
Hides an element's tooltip.
-$('#element').tooltip('hide')-
Toggles an element's tooltip.
-$('#element').tooltip('toggle')-
Destroys an element's tooltip.
-$('#element').tooltip('destroy')-
Add small overlays of content, like those on the iPad, to any element for housing secondary information. Hover over the button to trigger the popover.
-* Requires Tooltip to be included
- -Four options are available: top, right, bottom, and left aligned.
-Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+ +Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+ +Inspired by the excellent jQuery.tipsy plugin written by Jason Frame; Tooltips are an updated version, which don't rely on images, use CSS3 for animations, and data-attributes for local title storage.
+Hover over the links below to see tooltips:
+Tight pants next level keffiyeh you probably haven't heard of them. Photo booth beard raw denim letterpress vegan messenger bag stumptown. Farm-to-table seitan, mcsweeney's fixie sustainable quinoa 8-bit american apparel have a terry richardson vinyl chambray. Beard stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, four loko mcsweeney's cleanse vegan chambray. A really ironic artisan whatever keytar, scenester farm-to-table banksy Austin twitter handle freegan cred raw denim single-origin coffee viral. +
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+ +Trigger the tooltip via javascript:
+$('#example').tooltip(options)+ +
Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-animation=""
.
Name | +type | +default | +description | +
---|---|---|---|
animation | +boolean | +true | +apply a css fade transition to the tooltip | +
html | +boolean | +true | +Insert html into the tooltip. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks. |
+
placement | +string|function | +'top' | +how to position the tooltip - top | bottom | left | right | +
selector | +string | +false | +If a selector is provided, tooltip objects will be delegated to the specified targets. | +
title | +string | function | +'' | +default title value if `title` tag isn't present | +
trigger | +string | +'hover' | +how tooltip is triggered - hover | focus | manual | +
delay | +number | object | +0 | +
+ delay showing and hiding the tooltip (ms) - does not apply to manual trigger type +If a number is supplied, delay is applied to both hide/show +Object structure is: |
+
No markup shown as popovers are generated from javascript and content within a data
attribute.
For performance reasons, the Tooltip and Popover data-apis are opt in. If you would like to use them just specify a selector option.
++ <a href="#" rel="tooltip" title="first tooltip">hover over me</a> +-
Enable popovers via javascript:
-$('#example').popover(options)- -
Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-animation=""
.
Name | -type | -default | -description | -
---|---|---|---|
animation | -boolean | -true | -apply a css fade transition to the tooltip | -
html | -boolean | -true | -Insert html into the popover. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks. |
-
placement | -string|function | -'right' | -how to position the popover - top | bottom | left | right | -
selector | -string | -false | -if a selector is provided, tooltip objects will be delegated to the specified targets | -
trigger | -string | -'hover' | -how popover is triggered - hover | focus | manual | -
title | -string | function | -'' | -default title value if `title` attribute isn't present | -
content | -string | function | -'' | -default content value if `data-content` attribute isn't present | -
delay | -number | object | -0 | -
- delay showing and hiding the popover (ms) - does not apply to manual trigger type -If a number is supplied, delay is applied to both hide/show -Object structure is: |
-
For performance reasons, the Tooltip and Popover data-apis are opt in. If you would like to use them just specify a selector option.
- -Initializes popovers for an element collection.
-Reveals an elements popover.
-$('#element').popover('show')-
Hides an elements popover.
-$('#element').popover('hide')-
Toggles an elements popover.
-$('#element').popover('toggle')-
Destroys an element's popover.
-$('#element').popover('destroy')- +
Attaches a tooltip handler to an element collection.
+Reveals an element's tooltip.
+$('#element').tooltip('show')+
Hides an element's tooltip.
+$('#element').tooltip('hide')+
Toggles an element's tooltip.
+$('#element').tooltip('toggle')+
Destroys an element's tooltip.
+$('#element').tooltip('destroy')+ - -
Add small overlays of content, like those on the iPad, to any element for housing secondary information. Hover over the button to trigger the popover. Requires Tooltip to be included.
+ +Four options are available: top, right, bottom, and left aligned.
+Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+No markup shown as popovers are generated from javascript and content within a data
attribute.
Add dismiss functionality to all alerge messages with this plugin.
-Change this and that and try again. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
- -Enable popovers via javascript:
+$('#example').popover(options)+ +
Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-animation=""
.
Name | +type | +default | +description | +
---|---|---|---|
animation | +boolean | +true | +apply a css fade transition to the tooltip | +
html | +boolean | +true | +Insert html into the popover. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks. |
+
placement | +string|function | +'right' | +how to position the popover - top | bottom | left | right | +
selector | +string | +false | +if a selector is provided, tooltip objects will be delegated to the specified targets | +
trigger | +string | +'hover' | +how popover is triggered - hover | focus | manual | +
title | +string | function | +'' | +default title value if `title` attribute isn't present | +
content | +string | function | +'' | +default content value if `data-content` attribute isn't present | +
delay | +number | object | +0 | +
+ delay showing and hiding the popover (ms) - does not apply to manual trigger type +If a number is supplied, delay is applied to both hide/show +Object structure is: |
+
For performance reasons, the Tooltip and Popover data-apis are opt in. If you would like to use them just specify a selector option.
+ +Initializes popovers for an element collection.
+Reveals an elements popover.
+$('#element').popover('show')+
Hides an elements popover.
+$('#element').popover('hide')+
Toggles an elements popover.
+$('#element').popover('toggle')+
Destroys an element's popover.
+$('#element').popover('destroy')+
Enable dismissal of an alert via javascript:
-$(".alert").alert()-
Just add data-dismiss="alert"
to your close button to automatically give an alert close functionality.
<a class="close" data-dismiss="alert" href="#">×</a>- -
Wraps all alerts with close functionality. To have your alerts animate out when closed, make sure they have the .fade
and .in
class already applied to them.
Closes an alert.
-$(".alert").alert('close')+ +
Bootstrap's alert class exposes a few events for hooking into alert functionality.
-Event | -Description | -
---|---|
close | -This event fires immediately when the close instance method is called. |
-
closed | -This event is fired when the alert has been closed (will wait for css transitions to complete). | -
Add dismiss functionality to all alerge messages with this plugin.
+Change this and that and try again. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
+ +Enable dismissal of an alert via javascript:
+$(".alert").alert()+ +
Just add data-dismiss="alert"
to your close button to automatically give an alert close functionality.
<a class="close" data-dismiss="alert" href="#">×</a>+ +
Wraps all alerts with close functionality. To have your alerts animate out when closed, make sure they have the .fade
and .in
class already applied to them.
Closes an alert.
+$(".alert").alert('close')+ + +
Bootstrap's alert class exposes a few events for hooking into alert functionality.
+Event | +Description | +
---|---|
close | +This event fires immediately when the close instance method is called. |
+
closed | +This event is fired when the alert has been closed (will wait for css transitions to complete). | +
$('#my-alert').bind('closed', function () { // do something… })-
Do more with buttons. Control button states or create groups of buttons for more components like toolbars.
+Do more with buttons. Control button states or create groups of buttons for more components like toolbars.
-Add data-loading-text="Loading..." to use a loading state on a button.
-Add data-loading-text="Loading..." to use a loading state on a button.
+<button type="button" class="btn btn-primary" data-loading-text="Loading...">Loading state</button>-
Add data-toggle="button" to activate toggling on a single button.
-Add data-toggle="button" to activate toggling on a single button.
+<button type="button" class="btn" data-toggle="button">Single Toggle</button>-
Add data-toggle="buttons-checkbox" for checkbox style toggling on btn-group.
-Add data-toggle="buttons-checkbox" for checkbox style toggling on btn-group.
+<div class="btn-group" data-toggle="buttons-checkbox"> <button type="button" class="btn">Left</button> @@ -1134,15 +1126,15 @@ $('#my-alert').bind('closed', function () { </div>-
Add data-toggle="buttons-radio" for radio style toggling on btn-group.
-Add data-toggle="buttons-radio" for radio style toggling on btn-group.
+<div class="btn-group" data-toggle="buttons-radio"> <button type="button" class="btn">Left</button> @@ -1152,101 +1144,101 @@ $('#my-alert').bind('closed', function () {-
Enable buttons via javascript:
-$('.nav-tabs').button()+
Enable buttons via javascript:
+$('.nav-tabs').button()-
Data attributes are integral to the button plugin. Check out the example code below for the various markup types.
+Data attributes are integral to the button plugin. Check out the example code below for the various markup types.
-None
+None
-Toggles push state. Gives the button the appearance that it has been activated.
-data-toggle
attribute.
- <button type="button" class="btn" data-toggle="button" >…</button>-
Sets button state to loading - disables button and swaps text to loading text. Loading text should be defined on the button element using the data attribute data-loading-text
.
-
<button type="button" class="btn" data-loading-text="loading stuff..." >...</button>-
autocomplete="off"
.
- Resets button state - swaps text to original text.
-Resets button state - swaps text to any data defined text state.
+Toggles push state. Gives the button the appearance that it has been activated.
+data-toggle
attribute.
+ <button type="button" class="btn" data-toggle="button" >…</button>+
Sets button state to loading - disables button and swaps text to loading text. Loading text should be defined on the button element using the data attribute data-loading-text
.
+
<button type="button" class="btn" data-loading-text="loading stuff..." >...</button>+
autocomplete="off"
.
+ Resets button state - swaps text to original text.
+Resets button state - swaps text to any data defined text state.
<button type="button" class="btn" data-complete-text="finished!" >...</button> <script> $('.btn').button('complete') </script>-
Get base styles and flexible support for collapsible components like accordions and navigation.
-* Requires the Transitions plugin to be included.
+Get base styles and flexible support for collapsible components like accordions and navigation.
+* Requires the Transitions plugin to be included.
-Using the collapse plugin, we built a simple accordion style widget:
+Using the collapse plugin, we built a simple accordion style widget:
-<button type="button" class="btn btn-danger" data-toggle="collapse" data-target="#demo"> simple collapsible @@ -1256,137 +1248,137 @@ $('#my-alert').bind('closed', function () {-
Just add data-toggle="collapse"
and a data-target
to element to automatically assign control of a collapsible element. The data-target
attribute accepts a css selector to apply the collapse to. Be sure to add the class collapse
to the collapsible element. If you'd like it to default open, add the additional class in
.
To add accordion-like group management to a collapsible control, add the data attribute data-parent="#selector"
. Refer to the demo to see this in action.
Just add data-toggle="collapse"
and a data-target
to element to automatically assign control of a collapsible element. The data-target
attribute accepts a css selector to apply the collapse to. Be sure to add the class collapse
to the collapsible element. If you'd like it to default open, add the additional class in
.
To add accordion-like group management to a collapsible control, add the data attribute data-parent="#selector"
. Refer to the demo to see this in action.
Enable manually with:
-$(".collapse").collapse()+
Enable manually with:
+$(".collapse").collapse()-
Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-parent=""
.
Name | -type | -default | -description | -
---|---|---|---|
parent | -selector | -false | -If selector then all collapsible elements under the specified parent will be closed when this collapsible item is shown. (similar to traditional accordion behavior) | -
toggle | -boolean | -true | -Toggles the collapsible element on invocation | -
Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-parent=""
.
Name | +type | +default | +description | +
---|---|---|---|
parent | +selector | +false | +If selector then all collapsible elements under the specified parent will be closed when this collapsible item is shown. (similar to traditional accordion behavior) | +
toggle | +boolean | +true | +Toggles the collapsible element on invocation | +
Activates your content as a collapsible element. Accepts an optional options object
.
+
Activates your content as a collapsible element. Accepts an optional options object
.
$('#myCollapsible').collapse({ toggle: false })-
Toggles a collapsible element to shown or hidden.
-Shows a collapsible element.
-Hides a collapsible element.
+Toggles a collapsible element to shown or hidden.
+Shows a collapsible element.
+Hides a collapsible element.
-Bootstrap's collapse class exposes a few events for hooking into collapse functionality.
-Event | -Description | -
---|---|
show | -This event fires immediately when the show instance method is called. |
-
shown | -This event is fired when a collapse element has been made visible to the user (will wait for css transitions to complete). | -
hide | -
- This event is fired immediately when the hide method has been called.
- |
-
hidden | -This event is fired when a collapse element has been hidden from the user (will wait for css transitions to complete). | -
Bootstrap's collapse class exposes a few events for hooking into collapse functionality.
+Event | +Description | +
---|---|
show | +This event fires immediately when the show instance method is called. |
+
shown | +This event is fired when a collapse element has been made visible to the user (will wait for css transitions to complete). | +
hide | +
+ This event is fired immediately when the hide method has been called.
+ |
+
hidden | +This event is fired when a collapse element has been hidden from the user (will wait for css transitions to complete). | +
$('#myCollapsible').on('hidden', function () { // do something… })- + - -
The slideshow below shows a generic plugin and component for cycling through elements like a carousel.
-<div id="myCarousel" class="carousel slide"> <!-- Carousel items --> @@ -1401,198 +1393,201 @@ $('#myCollapsible').on('hidden', function () { </div>-
...
+...
-Call carousel manually with:
-$('.carousel').carousel()+
Call carousel manually with:
+$('.carousel').carousel()-
Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-interval=""
.
Name | -type | -default | -description | -
---|---|---|---|
interval | -number | -5000 | -The amount of time to delay between automatically cycling an item. If false, carousel will not automatically cycle. | -
pause | -string | -"hover" | -Pauses the cycling of the carousel on mouseenter and resumes the cycling of the carousel on mouseleave. | -
Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-interval=""
.
Name | +type | +default | +description | +
---|---|---|---|
interval | +number | +5000 | +The amount of time to delay between automatically cycling an item. If false, carousel will not automatically cycle. | +
pause | +string | +"hover" | +Pauses the cycling of the carousel on mouseenter and resumes the cycling of the carousel on mouseleave. | +
Initializes the carousel with an optional options object
and starts cycling through items.
Initializes the carousel with an optional options object
and starts cycling through items.
$('.carousel').carousel({ interval: 2000 })-
Cycles through the carousel items from left to right.
-Stops the carousel from cycling through items.
-Cycles the carousel to a particular frame (0 based, similar to an array).
-Cycles to the previous item.
-Cycles to the next item.
+Cycles through the carousel items from left to right.
+Stops the carousel from cycling through items.
+Cycles the carousel to a particular frame (0 based, similar to an array).
+Cycles to the previous item.
+Cycles to the next item.
-Bootstrap's carousel class exposes two events for hooking into carousel functionality.
-Event | -Description | -
---|---|
slide | -This event fires immediately when the slide instance method is invoked. |
-
slid | -This event is fired when the carousel has completed its slide transition. | -
Bootstrap's carousel class exposes two events for hooking into carousel functionality.
+Event | +Description | +
---|---|
slide | +This event fires immediately when the slide instance method is invoked. |
+
slid | +This event is fired when the carousel has completed its slide transition. | +
A basic, easily extended plugin for quickly creating elegant typeaheads with any form text input.
-A basic, easily extended plugin for quickly creating elegant typeaheads with any form text input.
+<input type="text" data-provide="typeahead">-
Add data attributes to register an element with typeahead functionality as shown in the example above.
+Add data attributes to register an element with typeahead functionality as shown in the example above.
-Call the typeahead manually with:
-$('.typeahead').typeahead()+
Call the typeahead manually with:
+$('.typeahead').typeahead()-
Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-source=""
.
Name | -type | -default | -description | -
---|---|---|---|
source | -array, function | -[ ] | -The data source to query against. May be an array of strings or a function. The function is passed two arguments, the query value in the input field and the process callback. The function may be used synchronously by returning the data source directly or asynchronously via the process callback's single argument. |
-
items | -number | -8 | -The max number of items to display in the dropdown. | -
matcher | -function | -case insensitive | -The method used to determine if a query matches an item. Accepts a single argument, the item against which to test the query. Access the current query with this.query . Return a boolean true if query is a match. |
-
sorter | -function | -exact match, case sensitive, case insensitive |
- Method used to sort autocomplete results. Accepts a single argument items and has the scope of the typeahead instance. Reference the current query with this.query . |
-
highlighter | -function | -highlights all default matches | -Method used to highlight autocomplete results. Accepts a single argument item and has the scope of the typeahead instance. Should return html. |
-
Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-source=""
.
Name | +type | +default | +description | +
---|---|---|---|
source | +array, function | +[ ] | +The data source to query against. May be an array of strings or a function. The function is passed two arguments, the query value in the input field and the process callback. The function may be used synchronously by returning the data source directly or asynchronously via the process callback's single argument. |
+
items | +number | +8 | +The max number of items to display in the dropdown. | +
matcher | +function | +case insensitive | +The method used to determine if a query matches an item. Accepts a single argument, the item against which to test the query. Access the current query with this.query . Return a boolean true if query is a match. |
+
sorter | +function | +exact match, case sensitive, case insensitive |
+ Method used to sort autocomplete results. Accepts a single argument items and has the scope of the typeahead instance. Reference the current query with this.query . |
+
highlighter | +function | +highlights all default matches | +Method used to highlight autocomplete results. Accepts a single argument item and has the scope of the typeahead instance. Should return html. |
+
Initializes an input with a typeahead.
-Initializes an input with a typeahead.
+...
-...
+...-
Bootstrap is built on a responsive 12-column grid. We've also included fixed- and fluid-width layouts based on that system.
-Bootstrap makes use of certain HTML elements and CSS properties that require the use of the HTML5 doctype. Include it at the beginning of all your projects.
+Bootstrap makes use of certain HTML elements and CSS properties that require the use of the HTML5 doctype. Include it at the beginning of all your projects.
<!DOCTYPE html> <html lang="en"> @@ -119,89 +110,89 @@ </html>-
Bootstrap sets basic global display, typography, and link styles. Specifically, we:
-margin
on the bodybackground-color: white;
on the body
@baseFontFamily
, @baseFontSize
, and @baseLineHeight
attributes as our typographyic base@linkColor
and apply link underlines only on :hover
These styles can be found within scaffolding.less.
+Bootstrap sets basic global display, typography, and link styles. Specifically, we:
+margin
on the bodybackground-color: white;
on the body
@baseFontFamily
, @baseFontSize
, and @baseLineHeight
attributes as our typographyic base@linkColor
and apply link underlines only on :hover
These styles can be found within scaffolding.less.
-With Bootstrap 2, the old reset block has been dropped in favor of Normalize.css, a project by Nicolas Gallagher that also powers the HTML5 Boilerplate. While we use much of Normalize within our reset.less, we have removed some elements specifically for Bootstrap.
+With Bootstrap 2, the old reset block has been dropped in favor of Normalize.css, a project by Nicolas Gallagher that also powers the HTML5 Boilerplate. While we use much of Normalize within our reset.less, we have removed some elements specifically for Bootstrap.
-The default Bootstrap grid system utilizes 12 columns, making for a 940px wide container without responsive features enabled. With the responsive CSS file added, the grid adapts to be 724px and 1170px wide depending on your viewport. Below 767px viewports, the columns become fluid and stack vertically.
-The default Bootstrap grid system utilizes 12 columns, making for a 940px wide container without responsive features enabled. With the responsive CSS file added, the grid adapts to be 724px and 1170px wide depending on your viewport. Below 767px viewports, the columns become fluid and stack vertically.
+For a simple two column layout, create a .row
and add the appropriate number of .span*
columns. As this is a 12-column grid, each .span*
spans a number of those 12 columns, and should always add up to 12 for each row.
For a simple two column layout, create a .row
and add the appropriate number of .span*
columns. As this is a 12-column grid, each .span*
spans a number of those 12 columns, and should always add up to 12 for each row.
<div class="row"> <div class="span4">...</div> <div class="span8">...</div> </div>-
Given this example, we have .span4
and .span8
, making for 12 total columns and a complete row.
Given this example, we have .span4
and .span8
, making for 12 total columns and a complete row.
Move columns to the left using .offset*
classes. Each class increases the left margin of a column by a whole column. For example, .offset4
moves .span4
over four columns.
Move columns to the left using .offset*
classes. Each class increases the left margin of a column by a whole column. For example, .offset4
moves .span4
over four columns.
<div class="row"> <div class="span4">...</div> @@ -209,23 +200,23 @@ </div>-
To nest your content with the default grid, add a new .row
and set of .span*
columns within an existing .span*
column. Nested rows should include a set of columns that add up to the number of columns of its parent.
Here two nested .span4
columns are placed within a .span8
.
To nest your content with the default grid, add a new .row
and set of .span*
columns within an existing .span*
column. Nested rows should include a set of columns that add up to the number of columns of its parent.
Here two nested .span4
columns are placed within a .span8
.
<div class="row"> <div class="span10"> @@ -237,54 +228,54 @@ </div> </div>- + - -
The fluid grid system uses percents instead of pixels for column widths. It has the same responsive capabilities as our fixed grid system, ensuring proper proportions for key screen resolutions and devices.
-The fluid grid system uses percents instead of pixels for column widths. It has the same responsive capabilities as our fixed grid system, ensuring proper proportions for key screen resolutions and devices.
+Make any row "fluid" by changing .row
to .row-fluid
. The column classes stay the exact same, making it easy to flip between fixed and fluid grids.
Make any row "fluid" by changing .row
to .row-fluid
. The column classes stay the exact same, making it easy to flip between fixed and fluid grids.
<div class="row-fluid"> <div class="span4">...</div> @@ -292,21 +283,21 @@ </div>-
Operates the same way as the fixed grid system offsetting: add .offset*
to any column to offset by that many columns.
Operates the same way as the fixed grid system offsetting: add .offset*
to any column to offset by that many columns.
<div class="row-fluid"> <div class="span4">...</div> @@ -314,21 +305,21 @@ </div>-
Nesting with fluid grids is a bit different: the number of nested columns should not match the parent's number of columns. Instead, each level of nested columns are reset because each row takes up 100% of the parent column.
-Nesting with fluid grids is a bit different: the number of nested columns should not match the parent's number of columns. Instead, each level of nested columns are reset because each row takes up 100% of the parent column.
<div class="row-fluid"> <div class="span12"> @@ -341,78 +332,78 @@ </div>- + - -
The default grid is built on a few variables for easy customization via LESS. All variables can be found in variables.less.
-Variable | -Default value | -Description | -
---|---|---|
@gridColumns |
- 12 | -Number of columns | -
@gridColumnWidth |
- 60px | -Width of each column | -
@gridGutterWidth |
- 20px | -Negative space between columns | -
@fluidGridColumnWidth |
- 6.382978723% | -Width of each fluid column | -
@fluidGridGutterWidth |
- 2.127659574% | -Negative space between fluid columns | -
The default grid is built on a few variables for easy customization via LESS. All variables can be found in variables.less.
+Variable | +Default value | +Description | +
---|---|---|
@gridColumns |
+ 12 | +Number of columns | +
@gridColumnWidth |
+ 60px | +Width of each column | +
@gridGutterWidth |
+ 20px | +Negative space between columns | +
@fluidGridColumnWidth |
+ 6.382978723% | +Width of each fluid column | +
@fluidGridGutterWidth |
+ 2.127659574% | +Negative space between fluid columns | +
Modifying the grid means changing the three @grid*
variables and recompiling Bootstrap. Change the grid variables in variables.less and use one of the four ways documented to recompile. If you're adding more columns, be sure to add the CSS for those in grid.less.
Modifying the grid means changing the three @grid*
variables and recompiling Bootstrap. Change the grid variables in variables.less and use one of the four ways documented to recompile. If you're adding more columns, be sure to add the CSS for those in grid.less.
Customization of the grid only works at the default level, the 940px grid. To maintain the responsive aspects of Bootstrap, you'll also have to manually customize the grids in responsive.less until a future update improves this.
+Customization of the grid only works at the default level, the 940px grid. To maintain the responsive aspects of Bootstrap, you'll also have to manually customize the grids in responsive.less until a future update improves this.
-Provides a common fixed-width (and optionally responsive) layout with only <div class="container">
required.
Provides a common fixed-width (and optionally responsive) layout with only <div class="container">
required.
<body> <div class="container"> @@ -421,12 +412,12 @@ </body>-
Create a fluid, two-column page with <div class="container-fluid">
—great for applications and docs.
Create a fluid, two-column page with <div class="container-fluid">
—great for applications and docs.
<div class="container-fluid"> <div class="row-fluid"> @@ -439,78 +430,78 @@ </div> </div>-
Turn on responsive CSS in your project by including the proper meta tag and additional stylesheet within the <head>
of your document. If you've compiled Bootstrap from the Customize page, you need only include the meta tag.
Turn on responsive CSS in your project by including the proper meta tag and additional stylesheet within the <head>
of your document. If you've compiled Bootstrap from the Customize page, you need only include the meta tag.
<meta name="viewport" content="width=device-width, initial-scale=1.0"> <link href="assets/css/bootstrap-responsive.css" rel="stylesheet">-
Heads up! Bootstrap doesn't include responsive features by default at this time as not everything needs to be responsive. Instead of encouraging developers to remove this feature, we figure it best to enable it as needed.
+Heads up! Bootstrap doesn't include responsive features by default at this time as not everything needs to be responsive. Instead of encouraging developers to remove this feature, we figure it best to enable it as needed.
-Media queries allow for custom CSS based on a number of conditions—ratios, widths, display type, etc—but usually focuses around min-width
and max-width
.
Use media queries responsibly and only as a start to your mobile audiences. For larger projects, do consider dedicated code bases and not layers of media queries.
+Media queries allow for custom CSS based on a number of conditions—ratios, widths, display type, etc—but usually focuses around min-width
and max-width
.
Use media queries responsibly and only as a start to your mobile audiences. For larger projects, do consider dedicated code bases and not layers of media queries.
-Bootstrap supports a handful of media queries in a single file to help make your projects more appropriate on different devices and screen resolutions. Here's what's included:
-Label | -Layout width | -Column width | -Gutter width | -
---|---|---|---|
Phones | -480px and below | -Fluid columns, no fixed widths | -|
Phones to tablets | -767px and below | -Fluid columns, no fixed widths | -|
Portrait tablets | -768px and above | -42px | -20px | -
Default | -980px and up | -60px | -20px | -
Large display | -1200px and up | -70px | -30px | -
Bootstrap supports a handful of media queries in a single file to help make your projects more appropriate on different devices and screen resolutions. Here's what's included:
+Label | +Layout width | +Column width | +Gutter width | +
---|---|---|---|
Phones | +480px and below | +Fluid columns, no fixed widths | +|
Phones to tablets | +767px and below | +Fluid columns, no fixed widths | +|
Portrait tablets | +768px and above | +42px | +20px | +
Default | +980px and up | +60px | +20px | +
Large display | +1200px and up | +70px | +30px | +
/* Landscape phones and down */ @media (max-width: 480px) { ... } @@ -526,81 +517,84 @@-
For faster mobile-friendly development, use these utility classes for showing and hiding content by device. Below is a table of the available classes and their effect on a given media query layout (labeled by device). They can be found in responsive.less
.
Class | -Phones 480px and below | -Tablets 767px and below | -Desktops 768px and above | -
---|---|---|---|
.visible-phone |
- Visible | -Hidden | -Hidden | -
.visible-tablet |
- Hidden | -Visible | -Hidden | -
.visible-desktop |
- Hidden | -Hidden | -Visible | -
.hidden-phone |
- Hidden | -Visible | -Visible | -
.hidden-tablet |
- Visible | -Hidden | -Visible | -
.hidden-desktop |
- Visible | -Visible | -Hidden | -
For faster mobile-friendly development, use these utility classes for showing and hiding content by device. Below is a table of the available classes and their effect on a given media query layout (labeled by device). They can be found in responsive.less
.
Class | +Phones 767px and below | +Tablets 979px to 768px | +Desktops Default | +
---|---|---|---|
.visible-phone |
+ Visible | +Hidden | +Hidden | +
.visible-tablet |
+ Hidden | +Visible | +Hidden | +
.visible-desktop |
+ Hidden | +Hidden | +Visible | +
.hidden-phone |
+ Hidden | +Visible | +Visible | +
.hidden-tablet |
+ Visible | +Hidden | +Visible | +
.hidden-desktop |
+ Visible | +Visible | +Hidden | +
Use on a limited basis and avoid creating entirely different versions of the same site. Instead, use them to complement each device's presentation.
+Use on a limited basis and avoid creating entirely different versions of the same site. Instead, use them to complement each device's presentation.
-Resize your browser or load on different devices to test the above classes.
-Green checkmarks indicate that class is visible in your current viewport.
-Here, green checkmarks indicate that class is hidden in your current viewport.
-Resize your browser or load on different devices to test the above classes.
+Green checkmarks indicate that class is visible in your current viewport.
+Here, green checkmarks indicate that class is hidden in your current viewport.
+{{_i}}On top of the scaffolding, basic HTML elements are styled and enhanced with extensible classes to provide a fresh, consistent look and feel.{{/i}}
-{{_i}}All HTML headings, <h1>
through <h6>
are available.{{/i}}
{{_i}}All HTML headings, <h1>
through <h6>
are available.{{/i}}
{{_i}}Bootstrap's global default font-size
is 14px, with a line-height
of 20px. This is applied to the <body>
and all paragraphs. In addition, <p>
(paragraphs) receive a bottom margin of half their line-height (9px by default).{{/i}}
Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Nullam id dolor id nibh ultricies vehicula.
-Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec ullamcorper nulla non metus auctor fringilla. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Donec ullamcorper nulla non metus auctor fringilla.
-Maecenas sed diam eget risus varius blandit sit amet non magna. Donec id elit non mi porta gravida at eget metus. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit.
-{{_i}}Bootstrap's global default font-size
is 14px, with a line-height
of 20px. This is applied to the <body>
and all paragraphs. In addition, <p>
(paragraphs) receive a bottom margin of half their line-height (9px by default).{{/i}}
Nullam quis risus eget urna mollis ornare vel eu leo. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Nullam id dolor id nibh ultricies vehicula.
+Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec ullamcorper nulla non metus auctor fringilla. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Donec ullamcorper nulla non metus auctor fringilla.
+Maecenas sed diam eget risus varius blandit sit amet non magna. Donec id elit non mi porta gravida at eget metus. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit.
+{{_i}}Make a paragraph stand out by adding .lead
.{{/i}}
Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus.
-{{_i}}Make a paragraph stand out by adding .lead
.{{/i}}
Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus.
+{{_i}}The typographic scale is based on two LESS variables in variables.less: @baseFontSize
and @baseLineHeight
. The first is the base font-size used throughout and the second is the base line-height. We use those variables and some simple math to create the margins, paddings, and line-heights of all our type and more. Customize them and Bootstrap adapts.{{/i}}
{{_i}}The typographic scale is based on two LESS variables in variables.less: @baseFontSize
and @baseLineHeight
. The first is the base font-size used throughout and the second is the base line-height. We use those variables and some simple math to create the margins, paddings, and line-heights of all our type and more. Customize them and Bootstrap adapts.{{/i}}
{{_i}}Make use of HTML's default emphasis tags, <strong>
and <em>
.{{/i}}
{{_i}}Make use of HTML's default emphasis tags, <strong>
and <em>
.{{/i}}
<strong>
{{_i}}For emphasizing a snippet of text with important{{/i}}
-The following snippet of text is rendered as bold text.
-<strong>
{{_i}}For emphasizing a snippet of text with important{{/i}}
+The following snippet of text is rendered as bold text.
+<strong>rendered as bold text</strong>-
<em>
{{_i}}For emphasizing a snippet of text with stress{{/i}}
-The following snippet of text is rendered as italicized text.
--<em>rendered as italicized text</em> -+
<em>
{{_i}}For emphasizing a snippet of text with stress{{/i}}
+The following snippet of text is rendered as italicized text.
++ <em>rendered as italicized text</em> +-
{{_i}}Heads up!{{/i}} {{_i}}Feel free to use <b>
and <i>
in HTML5. <b>
is meant to highlight words or phrases without conveying additional importance while <i>
is mostly for voice, technical terms, etc.{{/i}}
{{_i}}Heads up!{{/i}} {{_i}}Feel free to use <b>
and <i>
in HTML5. <b>
is meant to highlight words or phrases without conveying additional importance while <i>
is mostly for voice, technical terms, etc.{{/i}}
{{_i}}Stylized implemenation of HTML's <abbr>
element for abbreviations and acronyms to show the expanded version on hover. Abbreviations with a title
attribute have a light dotted bottom border and a help cursor on hover, providing additional context on hover.{{/i}}
{{_i}}Stylized implemenation of HTML's <abbr>
element for abbreviations and acronyms to show the expanded version on hover. Abbreviations with a title
attribute have a light dotted bottom border and a help cursor on hover, providing additional context on hover.{{/i}}
<abbr>
{{_i}}For expanded text on long hover of an abbreviation, include the title
attribute.{{/i}}
{{_i}}An abbreviation of the word attribute is attr.{{/i}}
-<abbr>
{{_i}}For expanded text on long hover of an abbreviation, include the title
attribute.{{/i}}
{{_i}}An abbreviation of the word attribute is attr.{{/i}}
+<abbr title="attribute">attr</abbr>-
<abbr class="initialism">
{{_i}}Add .initialism
to an abbreviation for a slightly smaller font-size.{{/i}}
{{_i}}HTML is the best thing since sliced bread.{{/i}}
-<abbr class="initialism">
{{_i}}Add .initialism
to an abbreviation for a slightly smaller font-size.{{/i}}
{{_i}}HTML is the best thing since sliced bread.{{/i}}
+<abbr title="attribute" class="initialism">attr</abbr>-
{{_i}}Present contact information for the nearest ancestor or the entire body of work.{{/i}}
+ {{! Addresses }} +{{_i}}Present contact information for the nearest ancestor or the entire body of work.{{/i}}
-<address>
{{_i}}Preserve formatting by ending all lines with <br>
.{{/i}}
<address>
{{_i}}Preserve formatting by ending all lines with <br>
.{{/i}}
<address> <strong>Twitter, Inc.</strong><br> @@ -163,37 +154,37 @@-
{{_i}}For quoting blocks of content from another source within your document.{{/i}}
+ {{! Blockquotes }} +{{_i}}For quoting blocks of content from another source within your document.{{/i}}
-{{_i}}Wrap <blockquote>
around any HTML as the quote. For straight quotes we recommend a <p>
.{{/i}}
--Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
-
{{_i}}Wrap <blockquote>
around any HTML as the quote. For straight quotes we recommend a <p>
.{{/i}}
++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
+
<blockquote> <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p> </blockquote>-
{{_i}}Style and content changes for simple variations on a standard blockquote.{{/i}}
+{{_i}}Style and content changes for simple variations on a standard blockquote.{{/i}}
-{{_i}}Add <small>
tag for identifying the source. Wrap the name of the source work in <cite>
.{{/i}}
--Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
- {{_i}}Someone famous in Source Title{{/i}} -
{{_i}}Add <small>
tag for identifying the source. Wrap the name of the source work in <cite>
.{{/i}}
++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
+ {{_i}}Someone famous in Source Title{{/i}} +
<blockquote> <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p> @@ -201,14 +192,14 @@ </blockquote>-
{{_i}}Use .pull-left
and .pull-right
classes for floated, right-aligned blockquote content.{{/i}}
--Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
- {{_i}}Someone famous in Source Title{{/i}} -
{{_i}}Use .pull-left
and .pull-right
classes for floated, right-aligned blockquote content.{{/i}}
++Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.
+ {{_i}}Someone famous in Source Title{{/i}} +
<blockquote class="pull-right"> <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Integer posuere erat a ante.</p> @@ -217,99 +208,99 @@-
{{_i}}A list of items in which the order does not explicitly matter.{{/i}}
-{{_i}}A list of items in which the order does not explicitly matter.{{/i}}
+<ul> <li>...</li> </ul>-
{{_i}}A list of items in which the order does explicitly matter.{{/i}}
-{{_i}}A list of items in which the order does explicitly matter.{{/i}}
+<ol> <li>...</li> </ol>-
{{_i}}A list of items with no list-style
or additional left padding.{{/i}}
{{_i}}A list of items with no list-style
or additional left padding.{{/i}}
<ul class="unstyled"> <li>...</li> </ul>-
{{_i}}A list of terms with their associated descriptions.{{/i}}
-{{_i}}A list of terms with their associated descriptions.{{/i}}
+<dl> <dt>...</dt> @@ -317,21 +308,21 @@ </dl>-
{{_i}}Make terms and descriptions in <dl>
line up side-by-side.{{/i}}
{{_i}}Make terms and descriptions in <dl>
line up side-by-side.{{/i}}
<dl class="dl-horizontal"> <dt>...</dt> @@ -339,28 +330,28 @@ </dl>
- {{_i}}Heads up!{{/i}}
- {{_i}}Horizontal description lists will truncate terms that are too long to fit in the left column fix text-overflow
. In narrower viewports, they will change to the default stacked layout.{{/i}}
-
text-overflow
. In narrower viewports, they will change to the default stacked layout.{{/i}}
+
+ Wrap inline snippets of code with <code>
.
Wrap inline snippets of code with <code>
.
{{_i}}For example, <code>section</code> should be wrapped as inline.{{/i}}-
{{_i}}Use <pre>
for multiple lines of code. Be sure to escape any angle brackets in the code for proper rendering.{{/i}}
{{_i}}Use <pre>
for multiple lines of code. Be sure to escape any angle brackets in the code for proper rendering.{{/i}}
<p>{{_i}}Sample text here...{{/i}}</p>@@ -369,53 +360,53 @@ <p>{{_i}}Sample text here...{{/i}}</p> </pre> -
{{_i}}Note: Be sure to keep code within <pre>
tags as close to the left as possible; it will render all tabs.{{/i}}
{{_i}}You may optionally add the .pre-scrollable
class which will set a max-height of 350px and provide a y-axis scrollbar.{{/i}}
{{_i}}Note: Be sure to keep code within <pre>
tags as close to the left as possible; it will render all tabs.{{/i}}
{{_i}}You may optionally add the .pre-scrollable
class which will set a max-height of 350px and provide a y-axis scrollbar.{{/i}}
{{_i}}For basic styling—light padding and only horizontal dividers—add the base class .table
to any <table>
.{{/i}}
# | -{{_i}}First Name{{/i}} | -{{_i}}Last Name{{/i}} | -{{_i}}Username{{/i}} | -
---|---|---|---|
1 | -Mark | -Otto | -@mdo | -
2 | -Jacob | -Thornton | -@fat | -
3 | -Larry | -the Bird | -
{{_i}}For basic styling—light padding and only horizontal dividers—add the base class .table
to any <table>
.{{/i}}
# | +{{_i}}First Name{{/i}} | +{{_i}}Last Name{{/i}} | +{{_i}}Username{{/i}} | +
---|---|---|---|
1 | +Mark | +Otto | +@mdo | +
2 | +Jacob | +Thornton | +@fat | +
3 | +Larry | +the Bird | +
<table class="table"> … @@ -423,168 +414,168 @@-
{{_i}}Add any of the follow classes to the .table
base class.{{/i}}
{{_i}}Add any of the follow classes to the .table
base class.{{/i}}
{{_i}}.table-striped{{/i}}
{{_i}}Adds zebra-striping to any table row within the <tbody>
via the :nth-child
CSS selector (not available in IE7-IE8).{{/i}}
# | -{{_i}}First Name{{/i}} | -{{_i}}Last Name{{/i}} | -{{_i}}Username{{/i}} | -
---|---|---|---|
1 | -Mark | -Otto | -@mdo | -
2 | -Jacob | -Thornton | -@fat | -
3 | -Larry | -the Bird | -
{{_i}}.table-striped{{/i}}
{{_i}}Adds zebra-striping to any table row within the <tbody>
via the :nth-child
CSS selector (not available in IE7-IE8).{{/i}}
# | +{{_i}}First Name{{/i}} | +{{_i}}Last Name{{/i}} | +{{_i}}Username{{/i}} | +
---|---|---|---|
1 | +Mark | +Otto | +@mdo | +
2 | +Jacob | +Thornton | +@fat | +
3 | +Larry | +the Bird | +
<table class="table table-striped"> … </table>-
{{_i}}.table-bordered{{/i}}
{{_i}}Add borders and rounded corners to the table.{{/i}}
-# | -{{_i}}First Name{{/i}} | -{{_i}}Last Name{{/i}} | -{{_i}}Username{{/i}} | -
---|---|---|---|
1 | -Mark | -Otto | -@mdo | -
Mark | -Otto | -@TwBootstrap | -|
2 | -Jacob | -Thornton | -@fat | -
3 | -Larry the Bird | -
{{_i}}.table-bordered{{/i}}
{{_i}}Add borders and rounded corners to the table.{{/i}}
+# | +{{_i}}First Name{{/i}} | +{{_i}}Last Name{{/i}} | +{{_i}}Username{{/i}} | +
---|---|---|---|
1 | +Mark | +Otto | +@mdo | +
Mark | +Otto | +@TwBootstrap | +|
2 | +Jacob | +Thornton | +@fat | +
3 | +Larry the Bird | +
<table class="table table-bordered"> … </table>-
{{_i}}.table-hover{{/i}}
{{_i}}Enable a hover state on table rows within a <tbody>
.{{/i}}
# | -{{_i}}First Name{{/i}} | -{{_i}}Last Name{{/i}} | -{{_i}}Username{{/i}} | -
---|---|---|---|
1 | -Mark | -Otto | -@mdo | -
2 | -Jacob | -Thornton | -@fat | -
3 | -Larry the Bird | -
{{_i}}.table-hover{{/i}}
{{_i}}Enable a hover state on table rows within a <tbody>
.{{/i}}
# | +{{_i}}First Name{{/i}} | +{{_i}}Last Name{{/i}} | +{{_i}}Username{{/i}} | +
---|---|---|---|
1 | +Mark | +Otto | +@mdo | +
2 | +Jacob | +Thornton | +@fat | +
3 | +Larry the Bird | +
<table class="table table-hover"> … </table>-
{{_i}}.table-condensed{{/i}}
{{_i}}Makes tables more compact by cutting cell padding in half.{{/i}}
-# | -{{_i}}First Name{{/i}} | -{{_i}}Last Name{{/i}} | -{{_i}}Username{{/i}} | -
---|---|---|---|
1 | -Mark | -Otto | -@mdo | -
2 | -Jacob | -Thornton | -@fat | -
3 | -Larry the Bird | -
{{_i}}.table-condensed{{/i}}
{{_i}}Makes tables more compact by cutting cell padding in half.{{/i}}
+# | +{{_i}}First Name{{/i}} | +{{_i}}Last Name{{/i}} | +{{_i}}Username{{/i}} | +
---|---|---|---|
1 | +Mark | +Otto | +@mdo | +
2 | +Jacob | +Thornton | +@fat | +
3 | +Larry the Bird | +
<table class="table table-condensed"> … @@ -592,82 +583,82 @@-
{{_i}}List of supported table HTML elements and how they should be used.{{/i}}
-{{_i}}Tag{{/i}} | -{{_i}}Description{{/i}} | -
---|---|
- <table>
- |
- - {{_i}}Wrapping element for displaying data in a tabular format{{/i}} - | -
- <thead>
- |
-
- {{_i}}Container element for table header rows (<tr> ) to label table columns{{/i}}
- |
-
- <tbody>
- |
-
- {{_i}}Container element for table rows (<tr> ) in the body of the table{{/i}}
- |
-
- <tr>
- |
-
- {{_i}}Container element for a set of table cells (<td> or <th> ) that appears on a single row{{/i}}
- |
-
- <td>
- |
- - {{_i}}Default table cell{{/i}} - | -
- <th>
- |
-
- {{_i}}Special table cell for column (or row, depending on scope and placement) labels{{/i}} - {{_i}}Must be used within a <thead> {{/i}}
- |
-
- <caption>
- |
- - {{_i}}Description or summary of what the table holds, especially useful for screen readers{{/i}} - | -
{{_i}}List of supported table HTML elements and how they should be used.{{/i}}
+{{_i}}Tag{{/i}} | +{{_i}}Description{{/i}} | +
---|---|
+ <table>
+ |
+ + {{_i}}Wrapping element for displaying data in a tabular format{{/i}} + | +
+ <thead>
+ |
+
+ {{_i}}Container element for table header rows (<tr> ) to label table columns{{/i}}
+ |
+
+ <tbody>
+ |
+
+ {{_i}}Container element for table rows (<tr> ) in the body of the table{{/i}}
+ |
+
+ <tr>
+ |
+
+ {{_i}}Container element for a set of table cells (<td> or <th> ) that appears on a single row{{/i}}
+ |
+
+ <td>
+ |
+ + {{_i}}Default table cell{{/i}} + | +
+ <th>
+ |
+
+ {{_i}}Special table cell for column (or row, depending on scope and placement) labels{{/i}} + {{_i}}Must be used within a <thead> {{/i}}
+ |
+
+ <caption>
+ |
+ + {{_i}}Description or summary of what the table holds, especially useful for screen readers{{/i}} + | +
<table> <thead> @@ -685,28 +676,29 @@ </table>-
{{_i}}Individual form controls receive styling, but without any required base class on the <form>
or large changes in markup. Results in stacked, left-aligned labels on top of form controls.{{/i}}
{{_i}}Example block-level help text here.{{/i}}
- - -{{_i}}Individual form controls receive styling, but without any required base class on the <form>
or large changes in markup. Results in stacked, left-aligned labels on top of form controls.{{/i}}
{{_i}}Example block-level help text here.{{/i}}
+ + +<form class="well"> <label>{{_i}}Label name{{/i}}</label> @@ -720,18 +712,18 @@-
{{_i}}Included with Bootstrap are three optional form layouts for common use cases.{{/i}}
+{{_i}}Included with Bootstrap are three optional form layouts for common use cases.{{/i}}
-{{_i}}Add .form-search
to the form and .search-query
to the <input>
for an extra-rounded text input.{{/i}}
{{_i}}Add .form-search
to the form and .search-query
to the <input>
for an extra-rounded text input.{{/i}}
<form class="form-search"> <input type="text" class="input-medium search-query"> @@ -739,16 +731,16 @@ </form>-
{{_i}}Add .form-inline
for left-aligned labels and inline-block controls for a compact layout.{{/i}}
{{_i}}Add .form-inline
for left-aligned labels and inline-block controls for a compact layout.{{/i}}
<form class="form-inline"> <input type="text" class="input-small" placeholder="{{_i}}Email{{/i}}"> @@ -760,36 +752,37 @@ </form>-
{{_i}}Right align labels and float them to the left to make them appear on the same line as controls. Requires the most markup changes from a default form:{{/i}}
-.form-horizontal
to the form{{/i}}.control-group
{{/i}}.control-label
to the label{{/i}}.controls
for proper alignment{{/i}}{{_i}}Right align labels and float them to the left to make them appear on the same line as controls. Requires the most markup changes from a default form:{{/i}}
+.form-horizontal
to the form{{/i}}.control-group
{{/i}}.control-label
to the label{{/i}}.controls
for proper alignment{{/i}}<form class="form-horizontal"> <div class="control-group"> @@ -816,49 +809,49 @@-
{{_i}}Examples of standard form controls supported in an example form layout.{{/i}}
+{{_i}}Examples of standard form controls supported in an example form layout.{{/i}}
-{{_i}}Most common form control, text-based input fields. Includes support for all HTML5 types: text, password, datetime, datetime-local, date, month, time, week, number, email, url, search, tel, and color.{{/i}}
-{{_i}}Requires the use of a specified type
at all times.{{/i}}
{{_i}}Most common form control, text-based input fields. Includes support for all HTML5 types: text, password, datetime, datetime-local, date, month, time, week, number, email, url, search, tel, and color.{{/i}}
+{{_i}}Requires the use of a specified type
at all times.{{/i}}
<input type="text" placeholder="Text input">-
{{_i}}Form control which supports multiple lines of text. Change row
attribute as necessary.{{/i}}
{{_i}}Form control which supports multiple lines of text. Change row
attribute as necessary.{{/i}}
<textarea id="textarea" rows="3"></textarea>-
{{_i}}Checkboxes are for selecting one or several options in a list while radios are for selecting one option from many.{{/i}}
-{{_i}}Checkboxes are for selecting one or several options in a list while radios are for selecting one option from many.{{/i}}
+<label class="checkbox"> <input type="checkbox" value=""> @@ -875,19 +868,19 @@ </label>-
{{_i}}Add the .inline
class to a series of checkboxes or radios for controls appear on the same line.{{/i}}
{{_i}}Add the .inline
class to a series of checkboxes or radios for controls appear on the same line.{{/i}}
<label class="checkbox inline"> <input type="checkbox" id="inlineCheckbox1" value="option1"> 1 @@ -900,25 +893,25 @@ </label>-
{{_i}}Use the default option or specify a multiple="multiple"
to show multiple options at once.{{/i}}
{{_i}}Use the default option or specify a multiple="multiple"
to show multiple options at once.{{/i}}
<select> <option>something</option> @@ -938,28 +931,28 @@-
{{_i}}Adding on top of existing browser controls, Bootstrap includes other useful form components.{{/i}}
+{{_i}}Adding on top of existing browser controls, Bootstrap includes other useful form components.{{/i}}
-{{_i}}Add text or buttons before or after any text-based input. Do note that select
elements are not supported here.{{/i}}
{{_i}}Add text or buttons before or after any text-based input. Do note that select
elements are not supported here.{{/i}}
{{_i}}Wrap a .add-on
and an input
with one of two classes to prepend or append text to an input.{{/i}}
{{_i}}Wrap a .add-on
and an input
with one of two classes to prepend or append text to an input.{{/i}}
<div class="input-prepend"> <span class="add-on">@</span><input class="span2" id="prependedInput" size="16" type="text" placeholder="{{_i}}Username{{/i}}"> @@ -969,35 +962,35 @@ </div>-
{{_i}}Use both classes and two instances of .add-on
to prepend and append an input.{{/i}}
{{_i}}Use both classes and two instances of .add-on
to prepend and append an input.{{/i}}
<div class="input-prepend input-append"> <span class="add-on">$</span><input class="span2" id="appendedPrependedInput" size="16" type="text"><span class="add-on">.00</span> </div>-
{{_i}}Instead of a <span>
with text, use a .btn
to attach a button (or two) to an input.{{/i}}
{{_i}}Instead of a <span>
with text, use a .btn
to attach a button (or two) to an input.{{/i}}
<div class="input-append"> <input class="span2" id="appendedInputButton" size="16" type="text"><button class="btn" type="button">Go!</button> @@ -1008,20 +1001,38 @@ </div>-
{{_i}}Use relative sizing classes like .input-large
or match your inputs to the grid column sizes using .span*
classes.{{/i}}
+<form class="form-search"> + <input type="text" class="span2 search-query"> + <button type="submit" class="btn">{{_i}}Search{{/i}}</button> +</form> +-
{{_i}}Use relative sizing classes like .input-large
or match your inputs to the grid column sizes using .span*
classes.{{/i}}
<input class="input-mini" type="text"> <input class="input-small" type="text"> @@ -1030,60 +1041,92 @@ <input class="input-xlarge" type="text"> <input class="input-xxlarge" type="text">+
+ {{_i}}Heads up!{{/i}} In future versions, we'll be altering the use of these relative input classes to match our button sizes. For example, .input-large
will increase the padding and font-size of an input.
+
{{_i}}Use .span1
to .span12
for inputs that match the same sizes of the grid columns.{{/i}}
{{_i}}Use .span1
to .span12
for inputs that match the same sizes of the grid columns.{{/i}}
<input class="span1" type="text"> <input class="span2" type="text"> <input class="span3" type="text">-
{{_i}}Present data in a form that's not editable without using actual form markup.{{/i}}
-{{_i}}For multiple grid inputs per line, use the .controls-row
modifier class for proper spacing. It floats the inputs to collapse white-space, sets the proper margins, and the clears the float.{{/i}}
+<div class="controls controls-row"> + <input class="span4" type="text" placeholder=".span4"> + <input class="span1" type="text" placeholder=".span1"> +</div> ++ +
{{_i}}Present data in a form that's not editable without using actual form markup.{{/i}}
+<span class="input-xlarge uneditable-input">Some value here</span>-
{{_i}}End a form with a group of actions (buttons). When placed within a .form-horizontal
, the buttons will automatically indent to line up with the form controls.{{/i}}
{{_i}}End a form with a group of actions (buttons). When placed within a .form-horizontal
, the buttons will automatically indent to line up with the form controls.{{/i}}
<div class="form-actions"> <button type="submit" class="btn btn-primary">{{_i}}Save changes{{/i}}</button> @@ -1091,76 +1134,76 @@ </div>-
{{_i}}Inline and block level support for help text that appears around form controls.{{/i}}
-{{_i}}Inline and block level support for help text that appears around form controls.{{/i}}
+<span class="help-inline">Inline help text</span>-
<span class="help-block">A longer block of help text that breaks onto a new line and may extend beyond one line.</span>-
{{_i}}Provide feedback to users or visitors with basic feedback states on form controls and labels.{{/i}}
+{{_i}}Provide feedback to users or visitors with basic feedback states on form controls and labels.{{/i}}
-{{_i}}We remove the default outline
styles on some form controls and apply a box-shadow
in its place for :focus
.{{/i}}
{{_i}}We remove the default outline
styles on some form controls and apply a box-shadow
in its place for :focus
.{{/i}}
<input class="input-xlarge" id="focusedInput" type="text" value="{{_i}}This is focused...{{/i}}">-
{{_i}}Add the disabled
attribute on an input to prevent user input and trigger a slightly different look.{{/i}}
{{_i}}Add the disabled
attribute on an input to prevent user input and trigger a slightly different look.{{/i}}
<input class="input-xlarge" id="disabledInput" type="text" placeholder="{{_i}}Disabled input here...{{/i}}" disabled>-
{{_i}}Bootstrap includes validation styles for error, warning, and success messages. To use, add the appropriate class to the surrounding .control-group
.{{/i}}
{{_i}}Bootstrap includes validation styles for error, warning, and success messages. To use, add the appropriate class to the surrounding .control-group
.{{/i}}
<div class="control-group warning"> <label class="control-label" for="inputWarning">{{_i}}Input with warning{{/i}}</label> @@ -1185,133 +1228,133 @@ </div>-
{{_i}}Button styles can be applied to anything with the .btn
class applied. However, typically you'll want to apply these to only <a>
and <button>
elements for the best rendering.{{/i}}
{{_i}}Button{{/i}} | -{{_i}}class=""{{/i}} | -{{_i}}Description{{/i}} | -
---|---|---|
- | btn |
- {{_i}}Standard gray button with gradient{{/i}} | -
- | btn btn-primary |
- {{_i}}Provides extra visual weight and identifies the primary action in a set of buttons{{/i}} | -
- | btn btn-info |
- {{_i}}Used as an alternative to the default styles{{/i}} | -
- | btn btn-success |
- {{_i}}Indicates a successful or positive action{{/i}} | -
- | btn btn-warning |
- {{_i}}Indicates caution should be taken with this action{{/i}} | -
- | btn btn-danger |
- {{_i}}Indicates a dangerous or potentially negative action{{/i}} | -
- | btn btn-inverse |
- {{_i}}Alternate dark gray button, not tied to a semantic action or use{{/i}} | -
{{_i}}Button styles can be applied to anything with the .btn
class applied. However, typically you'll want to apply these to only <a>
and <button>
elements for the best rendering.{{/i}}
{{_i}}Button{{/i}} | +{{_i}}class=""{{/i}} | +{{_i}}Description{{/i}} | +
---|---|---|
+ | btn |
+ {{_i}}Standard gray button with gradient{{/i}} | +
+ | btn btn-primary |
+ {{_i}}Provides extra visual weight and identifies the primary action in a set of buttons{{/i}} | +
+ | btn btn-info |
+ {{_i}}Used as an alternative to the default styles{{/i}} | +
+ | btn btn-success |
+ {{_i}}Indicates a successful or positive action{{/i}} | +
+ | btn btn-warning |
+ {{_i}}Indicates caution should be taken with this action{{/i}} | +
+ | btn btn-danger |
+ {{_i}}Indicates a dangerous or potentially negative action{{/i}} | +
+ | btn btn-inverse |
+ {{_i}}Alternate dark gray button, not tied to a semantic action or use{{/i}} | +
{{_i}}IE9 doesn't crop background gradients on rounded corners, so we remove it. Related, IE9 jankifies disabled button
elements, rendering text gray with a nasty text-shadow that we cannot fix.{{/i}}
{{_i}}IE9 doesn't crop background gradients on rounded corners, so we remove it. Related, IE9 jankifies disabled button
elements, rendering text gray with a nasty text-shadow that we cannot fix.{{/i}}
{{_i}}Fancy larger or smaller buttons? Add .btn-large
, .btn-small
, or .btn-mini
for two additional sizes.{{/i}}
- - -
-- - -
-- - -
+{{_i}}Fancy larger or smaller buttons? Add .btn-large
, .btn-small
, or .btn-mini
for two additional sizes.{{/i}}
+ + +
++ + +
++ + +
-{{_i}}Make buttons look unclickable by fading them back 50%.{{/i}}
+{{_i}}Make buttons look unclickable by fading them back 50%.{{/i}}
-{{_i}}Add the .disabled
class to <a>
buttons.{{/i}}
- {{_i}}Primary link{{/i}} - {{_i}}Link{{/i}} -
+{{_i}}Add the .disabled
class to <a>
buttons.{{/i}}
+ {{_i}}Primary link{{/i}} + {{_i}}Link{{/i}} +
<a href="#" class="btn btn-large btn-primary disabled">{{_i}}Primary link{{/i}}</a> <a href="#" class="btn btn-large disabled">{{_i}}Link{{/i}}</a>-
- {{_i}}Heads up!{{/i}}
- {{_i}}We use .disabled
as a utility class here, similar to the common .active
class, so no prefix is required.{{/i}}
-
+ {{_i}}Heads up!{{/i}}
+ {{_i}}We use .disabled
as a utility class here, similar to the common .active
class, so no prefix is required.{{/i}}
+
{{_i}}Add the disabled
attribute to <button>
buttons.{{/i}}
- - -
+{{_i}}Add the disabled
attribute to <button>
buttons.{{/i}}
+ + +
<button type="button" class="btn btn-large btn-primary disabled" disabled="disabled">{{_i}}Primary button{{/i}}</button> <button type="button" class="btn btn-large" disabled>{{_i}}Button{{/i}}</button>-
{{_i}}Use the .btn
class on an <a>
, <button>
, or <input>
element.{{/i}}
{{_i}}Use the .btn
class on an <a>
, <button>
, or <input>
element.{{/i}}
<a class="btn" href="">{{_i}}Link{{/i}}</a> <button class="btn" type="submit"> @@ -1322,244 +1365,246 @@ <input class="btn" type="submit" value="{{_i}}Submit{{/i}}">-
{{_i}}As a best practice, try to match the element for you context to ensure matching cross-browser rendering. If you have an input
, use an <input type="submit">
for your button.{{/i}}
{{_i}}As a best practice, try to match the element for you context to ensure matching cross-browser rendering. If you have an input
, use an <input type="submit">
for your button.{{/i}}
{{_i}}140 icons in sprite form, available in dark gray (default) and white, provided by Glyphicons.{{/i}}
-{{_i}}140 icons in sprite form, available in dark gray (default) and white, provided by Glyphicons.{{/i}}
+{{_i}}Glyphicons Halflings are normally not available for free, but an arrangement between Bootstrap and the Glyphicons creators have made this possible at not cost to you as developers. As a thank you, we ask you to include an optional link back to Glyphicons whenever practical.{{/i}}
+{{_i}}Glyphicons Halflings are normally not available for free, but an arrangement between Bootstrap and the Glyphicons creators have made this possible at not cost to you as developers. As a thank you, we ask you to include an optional link back to Glyphicons whenever practical.{{/i}}
-{{_i}}All icons require an <i>
tag with a unique class, prefixed with icon-
. To use, place the following code just about anywhere:{{/i}}
{{_i}}All icons require an <i>
tag with a unique class, prefixed with icon-
. To use, place the following code just about anywhere:{{/i}}
<i class="icon-search"></i>-
{{_i}}There are also styles available for inverted (white) icons, made ready with one extra class:{{/i}}
+{{_i}}There are also styles available for inverted (white) icons, made ready with one extra class:{{/i}}
<i class="icon-search icon-white"></i>-
- {{_i}}Heads up!{{/i}}
- {{_i}}When using beside strings of text, as in buttons or nav links, be sure to leave a space after the <i>
tag for proper spacing.{{/i}}
-
+ {{_i}}Heads up!{{/i}}
+ {{_i}}When using beside strings of text, as in buttons or nav links, be sure to leave a space after the <i>
tag for proper spacing.{{/i}}
+
{{_i}}Use them in buttons, button groups for a toolbar, navigation, or prepended form inputs.{{/i}}
+{{_i}}Use them in buttons, button groups for a toolbar, navigation, or prepended form inputs.{{/i}}
-{{_i}}Dozens of reusable components are built into Bootstrap to provide navigation, alerts, popovers, and much more.{{/i}}
-{{_i}}An isolated (without dropdown toggle) dropdown menu example, designed to be used with the dropdown javascript plugin.{{/i}}
-{{_i}}An isolated (without dropdown toggle) dropdown menu example, designed to be used with the dropdown javascript plugin.{{/i}}
+<ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu"> <li><a tabindex="-1" href="#">{{_i}}Action{{/i}}</a></li> @@ -89,11 +63,11 @@-
{{_i}}Dropdowns require...{{/i}}
+{{_i}}Dropdowns require...{{/i}}
<ul class="nav nav-pills"> @@ -115,50 +89,50 @@ </ul>-
{{_i}}...{{/i}}
+{{_i}}...{{/i}}
-{{_i}}...{{/i}}
+{{_i}}...{{/i}}
-{{_i}}...{{/i}}
+{{_i}}...{{/i}}
-{{_i}}...{{/i}}
+{{_i}}...{{/i}}
-{{_i}}Two basic options, along with two more specific variations.{{/i}}
+{{_i}}Two basic options, along with two more specific variations.{{/i}}
-{{_i}}Wrap a series of buttons with .btn
in .btn-group
.{{/i}}
{{_i}}Wrap a series of buttons with .btn
in .btn-group
.{{/i}}
<div class="btn-group"> <button class="btn">1</button> @@ -167,26 +141,26 @@ </div>-
{{_i}}Combine sets of <div class="btn-group">
into a <div class="btn-toolbar">
for more complex components.{{/i}}
{{_i}}Combine sets of <div class="btn-group">
into a <div class="btn-toolbar">
for more complex components.{{/i}}
<div class="btn-toolbar"> <div class="btn-group"> @@ -195,16 +169,16 @@ </div>-
{{_i}}Make a set of buttons appear vertically stacked rather than horizontally.{{/i}}
-{{_i}}Make a set of buttons appear vertically stacked rather than horizontally.{{/i}}
+<div class="btn-group btn-group-vertical"> ... @@ -212,102 +186,102 @@-
{{_i}}Button groups can also function as radios, where only one button may be active, or checkboxes, where any number of buttons may be active. View the Javascript docs for that.{{/i}}
+{{_i}}Button groups can also function as radios, where only one button may be active, or checkboxes, where any number of buttons may be active. View the Javascript docs for that.{{/i}}
-{{_i}}Heads up!{{/i}} {{_i}}Buttons with dropdowns must be individually wrapped in their own .btn-group
within a .btn-toolbar
for proper rendering.{{/i}}
{{_i}}Heads up!{{/i}} {{_i}}Buttons with dropdowns must be individually wrapped in their own .btn-group
within a .btn-toolbar
for proper rendering.{{/i}}
{{_i}}Use any button to trigger a dropdown menu by placing it within a .btn-group
and providing the proper menu markup.{{/i}}
{{_i}}Use any button to trigger a dropdown menu by placing it within a .btn-group
and providing the proper menu markup.{{/i}}
<div class="btn-group"> <a class="btn dropdown-toggle" data-toggle="dropdown" href="#"> @@ -320,134 +294,134 @@ </div>-
{{_i}}Button dropdowns work at any size. your button sizes to .btn-large
, .btn-small
, or .btn-mini
.{{/i}}
{{_i}}Button dropdowns work at any size. your button sizes to .btn-large
, .btn-small
, or .btn-mini
.{{/i}}
{{_i}}Button dropdowns require the Bootstrap dropdown plugin to function.{{/i}}
-{{_i}}In some cases—like mobile—dropdown menus will extend outside the viewport. You need to resolve the alignment manually or with custom javascript.{{/i}}
+{{_i}}Button dropdowns require the Bootstrap dropdown plugin to function.{{/i}}
+{{_i}}In some cases—like mobile—dropdown menus will extend outside the viewport. You need to resolve the alignment manually or with custom javascript.{{/i}}
-{{_i}}Building on the button group styles and markup, we can easily create a split button. Split buttons feature a standard action on the left and a dropdown toggle on the right with contextual links.{{/i}}
-{{_i}}Building on the button group styles and markup, we can easily create a split button. Split buttons feature a standard action on the left and a dropdown toggle on the right with contextual links.{{/i}}
+<div class="btn-group"> <button class="btn">{{_i}}Action{{/i}}</button> @@ -460,49 +434,49 @@ </div>-
{{_i}}Utilize the extra button classes .btn-mini
, .btn-small
, or .btn-large
for sizing.{{/i}}
{{_i}}Utilize the extra button classes .btn-mini
, .btn-small
, or .btn-large
for sizing.{{/i}}
<div class="btn-group"> <button class="btn btn-mini">{{_i}}Action{{/i}}</button> @@ -515,34 +489,34 @@ </div>-
{{_i}}Dropdown menus can also be toggled from the bottom up by adding a single class to the immediate parent of .dropdown-menu
. It will flip the direction of the .caret
and reposition the menu itself to move from the bottom up instead of top down.{{/i}}
{{_i}}Dropdown menus can also be toggled from the bottom up by adding a single class to the immediate parent of .dropdown-menu
. It will flip the direction of the .caret
and reposition the menu itself to move from the bottom up instead of top down.{{/i}}
<div class="btn-group dropup"> <button class="btn">{{_i}}Dropup{{/i}}</button> @@ -555,29 +529,29 @@ </div>-
{{_i}}All nav components here—tabs, pills, and lists—share the same base markup and styles through the .nav
class.{{/i}}
{{_i}}All nav components here—tabs, pills, and lists—share the same base markup and styles through the .nav
class.{{/i}}
{{_i}}Take a regular <ul>
of links and add .nav-tabs
:{{/i}}
{{_i}}Take a regular <ul>
of links and add .nav-tabs
:{{/i}}
<ul class="nav nav-tabs"> <li class="active"> @@ -588,15 +562,15 @@ </ul>-
{{_i}}Take that same HTML, but use .nav-pills
instead:{{/i}}
{{_i}}Take that same HTML, but use .nav-pills
instead:{{/i}}
<ul class="nav nav-pills"> <li class="active"> @@ -607,15 +581,15 @@ </ul>-
{{_i}}For any nav component (tabs, pills, or list), add .disabled
for gray links and no hover effects. Links will remain clickable, however, unless custom javascript is implemented to prevent those clicks.{{/i}}
{{_i}}For any nav component (tabs, pills, or list), add .disabled
for gray links and no hover effects. Links will remain clickable, however, unless custom javascript is implemented to prevent those clicks.{{/i}}
<ul class="nav nav-pills"> ... @@ -624,38 +598,38 @@ </ul>-
{{_i}}To align nav links, use the .pull-left
or .pull-right
utility classes. Both classes will add a CSS float in the specified direction.{{/i}}
{{_i}}To align nav links, use the .pull-left
or .pull-right
utility classes. Both classes will add a CSS float in the specified direction.{{/i}}
{{_i}}As tabs and pills are horizontal by default, just add a second class, .nav-stacked
, to make them appear vertically stacked.{{/i}}
{{_i}}As tabs and pills are horizontal by default, just add a second class, .nav-stacked
, to make them appear vertically stacked.{{/i}}
<ul class="nav nav-tabs nav-stacked"> ... </ul>-
<ul class="nav nav-pills nav-stacked"> ... @@ -663,29 +637,29 @@-
{{_i}}Add dropdown menus with a little extra HTML and the dropdowns javascript plugin.{{/i}}
+{{_i}}Add dropdown menus with a little extra HTML and the dropdowns javascript plugin.{{/i}}
-<ul class="nav nav-tabs"> <li class="dropdown"> @@ -702,23 +676,23 @@ </ul>-
<ul class="nav nav-pills"> <li class="dropdown"> @@ -736,29 +710,29 @@-
{{_i}}A simple and easy way to build groups of nav links with optional headers. They're best used in sidebars like the Finder in OS X.{{/i}}
+{{_i}}A simple and easy way to build groups of nav links with optional headers. They're best used in sidebars like the Finder in OS X.{{/i}}
-{{_i}}Take a list of links and add class="nav nav-list"
:{{/i}}
{{_i}}Take a list of links and add class="nav nav-list"
:{{/i}}
<ul class="nav nav-list"> <li class="nav-header">{{_i}}List header{{/i}}</li> @@ -767,50 +741,50 @@ ... </ul>-
- {{_i}}Note{{/i}}
- {{_i}}For nesting within a nav list, include class="nav nav-list"
on any nested <ul>
.{{/i}}
-
+ {{_i}}Note{{/i}}
+ {{_i}}For nesting within a nav list, include class="nav nav-list"
on any nested <ul>
.{{/i}}
+
{{_i}}Add a horizontal divider by creating an empty list item with the class .divider
, like so:{{/i}}
{{_i}}Add a horizontal divider by creating an empty list item with the class .divider
, like so:{{/i}}
<ul class="nav nav-list"> ... <li class="divider"></li> ... </ul> -+ -
{{_i}}Bring your tabs to life with a simple plugin to toggle between content via tabs. Bootstrap integrates tabbable tabs in four styles: top (default), right, bottom, and left.{{/i}}
+{{_i}}Bring your tabs to life with a simple plugin to toggle between content via tabs. Bootstrap integrates tabbable tabs in four styles: top (default), right, bottom, and left.{{/i}}
-{{_i}}To make tabs tabbable, create a .tab-pane
with unique ID for every tab and wrap them in .tab-content
.{{/i}}
{{_i}}I'm in Section 1.{{/i}}
-{{_i}}Howdy, I'm in Section 2.{{/i}}
-{{_i}}What up girl, this is Section 3.{{/i}}
-{{_i}}To make tabs tabbable, create a .tab-pane
with unique ID for every tab and wrap them in .tab-content
.{{/i}}
{{_i}}I'm in Section 1.{{/i}}
+{{_i}}Howdy, I'm in Section 2.{{/i}}
+{{_i}}What up girl, this is Section 3.{{/i}}
+<div class="tabbable"> <!-- Only required for left/right tabs --> <ul class="nav nav-tabs"> @@ -828,36 +802,36 @@ </div>-
{{_i}}To make tabs fade in, add .fade
to each .tab-pane
.{{/i}}
{{_i}}To make tabs fade in, add .fade
to each .tab-pane
.{{/i}}
{{_i}}All tabbable tabs are powered by our lightweight jQuery plugin. Read more about how to bring tabbable tabs to life on the javascript docs page.{{/i}}
+{{_i}}All tabbable tabs are powered by our lightweight jQuery plugin. Read more about how to bring tabbable tabs to life on the javascript docs page.{{/i}}
-{{_i}}Flip the order of the HTML and add a class to put tabs on the bottom.{{/i}}
-{{_i}}I'm in Section A.{{/i}}
-{{_i}}Howdy, I'm in Section B.{{/i}}
-{{_i}}What up girl, this is Section C.{{/i}}
-{{_i}}Flip the order of the HTML and add a class to put tabs on the bottom.{{/i}}
+{{_i}}I'm in Section A.{{/i}}
+{{_i}}Howdy, I'm in Section B.{{/i}}
+{{_i}}What up girl, this is Section C.{{/i}}
+<div class="tabbable tabs-below"> <div class="tab-content"> @@ -869,28 +843,28 @@ </div>-
{{_i}}Swap the class to put tabs on the left.{{/i}}
-{{_i}}I'm in Section A.{{/i}}
-{{_i}}Howdy, I'm in Section B.{{/i}}
-{{_i}}What up girl, this is Section C.{{/i}}
-{{_i}}Swap the class to put tabs on the left.{{/i}}
+{{_i}}I'm in Section A.{{/i}}
+{{_i}}Howdy, I'm in Section B.{{/i}}
+{{_i}}What up girl, this is Section C.{{/i}}
+<div class="tabbable tabs-left"> <ul class="nav nav-tabs"> @@ -902,28 +876,28 @@ </div>-
{{_i}}Swap the class to put tabs on the right.{{/i}}
-{{_i}}I'm in Section A.{{/i}}
-{{_i}}Howdy, I'm in Section B.{{/i}}
-{{_i}}What up girl, this is Section C.{{/i}}
-{{_i}}Swap the class to put tabs on the right.{{/i}}
+{{_i}}I'm in Section A.{{/i}}
+{{_i}}Howdy, I'm in Section B.{{/i}}
+{{_i}}What up girl, this is Section C.{{/i}}
+<div class="tabbable tabs-right"> <ul class="nav nav-tabs"> @@ -935,32 +909,32 @@ </div>-
{{_i}}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 .container
, which sets the width of your site and content.{{/i}}
{{_i}}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 .container
, which sets the width of your site and content.{{/i}}
<div class="navbar"> <div class="navbar-inner"> @@ -975,19 +949,19 @@-
{{_i}}A simple link to show your brand or project name only requires an anchor tag.{{/i}}
+{{_i}}A simple link to show your brand or project name only requires an anchor tag.{{/i}}
<a class="brand" href="#">{{_i}}Project name{{/i}}</a>-
{{_i}}Nav items are simple to add via unordered lists.{{/i}}
+{{_i}}Nav items are simple to add via unordered lists.{{/i}}
<ul class="nav"> <li class="active"> @@ -997,7 +971,7 @@ <li><a href="#">{{_i}}Link{{/i}}</a></li> </ul>-
{{_i}}You can easily add dividers to your nav links with an empty list item and a simple class. Just add this between links:{{/i}}
+{{_i}}You can easily add dividers to your nav links with an empty list item and a simple class. Just add this between links:{{/i}}
<ul class="nav"> ... @@ -1006,27 +980,27 @@ </ul>-
{{_i}}To properly style and position a form within the navbar, add the appropriate classes as shown below. For a default form, include .navbar-form
and either .pull-left
or .pull-right
to properly align it.{{/i}}
{{_i}}To properly style and position a form within the navbar, add the appropriate classes as shown below. For a default form, include .navbar-form
and either .pull-left
or .pull-right
to properly align it.{{/i}}
<form class="navbar-form pull-left"> <input type="text" class="span2"> </form>-
{{_i}}For a more customized search form, add .navbar-search
to the form
and .search-query
to the input for specialized styles in the navbar.{{/i}}
{{_i}}For a more customized search form, add .navbar-search
to the form
and .search-query
to the input for specialized styles in the navbar.{{/i}}
<form class="navbar-search pull-left"> <input type="text" class="search-query" placeholder="{{_i}}Search{{/i}}"> </form>-
{{_i}}Align nav links, search form, or text, use the .pull-left
or .pull-right
utility classes. Both classes will add a CSS float in the specified direction.{{/i}}
{{_i}}Align nav links, search form, or text, use the .pull-left
or .pull-right
utility classes. Both classes will add a CSS float in the specified direction.{{/i}}
{{_i}}Add dropdowns and dropups to the nav with a bit of markup and the dropdowns javascript plugin.{{/i}}
+{{_i}}Add dropdowns and dropups to the nav with a bit of markup and the dropdowns javascript plugin.{{/i}}
<ul class="nav"> <li class="dropdown"> @@ -1040,56 +1014,56 @@ </li> </ul>-
{{_i}}Visit the javascript dropdowns documentation for more markup and information on calling dropdowns.{{/i}}
+{{_i}}Visit the javascript dropdowns documentation for more markup and information on calling dropdowns.{{/i}}
-{{_i}}Wrap strings of text in an element with .navbar-text
, usually on a <p>
tag for proper leading and color.{{/i}}
{{_i}}Wrap strings of text in an element with .navbar-text
, usually on a <p>
tag for proper leading and color.{{/i}}
{{_i}}Fix the navbar to the top or bottom of the viewport with an additional class on the outermost div, .navbar
.{{/i}}
{{_i}}Fix the navbar to the top or bottom of the viewport with an additional class on the outermost div, .navbar
.{{/i}}
{{_i}}Add .navbar-fixed-top
and remember to account for the hidden area underneath it by adding at least 40px padding
to the <body>
. Be sure to add this after the core Bootstrap CSS and before the optional responsive CSS.{{/i}}
{{_i}}Add .navbar-fixed-top
and remember to account for the hidden area underneath it by adding at least 40px padding
to the <body>
. Be sure to add this after the core Bootstrap CSS and before the optional responsive CSS.{{/i}}
<div class="navbar navbar-fixed-top"> ... </div>-
{{_i}}Add .navbar-fixed-bottom
instead.{{/i}}
{{_i}}Add .navbar-fixed-bottom
instead.{{/i}}
<div class="navbar navbar-fixed-bottom"> ... @@ -1097,61 +1071,61 @@-
{{_i}}To implement a collapsing responsive navbar, wrap your navbar content in a containing div, .nav-collapse.collapse
, and add the navbar toggle button, .btn-navbar
.{{/i}}
{{_i}}To implement a collapsing responsive navbar, wrap your navbar content in a containing div, .nav-collapse.collapse
, and add the navbar toggle button, .btn-navbar
.{{/i}}
<div class="navbar"> <div class="navbar-inner"> @@ -1176,94 +1150,94 @@ </div> </div>-
{{_i}}To implement a collapsing responsive navbar, wrap your navbar content in a containing div, .nav-collapse.collapse
, and add the navbar toggle button, .btn-navbar
.{{/i}}
{{_i}}To implement a collapsing responsive navbar, wrap your navbar content in a containing div, .nav-collapse.collapse
, and add the navbar toggle button, .btn-navbar
.{{/i}}
{{_i}}A single example shown as it might be displayed across multiple pages.{{/i}}
-{{_i}}A single example shown as it might be displayed across multiple pages.{{/i}}
+<ul class="breadcrumb"> <li><a href="#">{{_i}}Home{{/i}}</a> <span class="divider">/</span></li> @@ -1272,32 +1246,32 @@ </ul>-
{{_i}}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.{{/i}}
- +{{_i}}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.{{/i}}
+<div class="pagination"> <ul> @@ -1312,26 +1286,26 @@-
{{_i}}Links are customizable for different circumstances. Use .disabled
for unclickable links and .active
to indicate the current page.{{/i}}
{{_i}}Links are customizable for different circumstances. Use .disabled
for unclickable links and .active
to indicate the current page.{{/i}}
<div class="pagination "> <ul> @@ -1342,39 +1316,39 @@ </div>-
{{_i}}Add one of two optional classes to change the alignment of pagination links: .pagination-centered
and .pagination-right
.{{/i}}
{{_i}}Add one of two optional classes to change the alignment of pagination links: .pagination-centered
and .pagination-right
.{{/i}}
<div class="pagination pagination-centered"> ... </div>- +
<div class="pagination pagination-right"> ... @@ -1382,20 +1356,20 @@-
{{_i}}Quick previous and next links for simple pagination implementations with light markup and styles. It's great for simple sites like blogs or magazines.{{/i}}
+{{_i}}Quick previous and next links for simple pagination implementations with light markup and styles. It's great for simple sites like blogs or magazines.{{/i}}
-{{_i}}By default, the pager centers links.{{/i}}
-{{_i}}By default, the pager centers links.{{/i}}
+<ul class="pager"> <li> @@ -1407,14 +1381,14 @@ </ul>-
{{_i}}Alternatively, you can align each link to the sides:{{/i}}
-{{_i}}Alternatively, you can align each link to the sides:{{/i}}
+<ul class="pager"> <li class="previous"> @@ -1426,14 +1400,14 @@ </ul>-
{{_i}}Pager links also use the general .disabled
utility class from the pagination.{{/i}}
{{_i}}Pager links also use the general .disabled
utility class from the pagination.{{/i}}
<ul class="pager"> <li class="previous disabled"> @@ -1443,187 +1417,187 @@ </ul>-
{{_i}}Labels{{/i}} | -{{_i}}Markup{{/i}} | -
---|---|
- {{_i}}Default{{/i}} - | -
- <span class="label">{{_i}}Default{{/i}}</span>
- |
-
- {{_i}}Success{{/i}} - | -
- <span class="label label-success">{{_i}}Success{{/i}}</span>
- |
-
- {{_i}}Warning{{/i}} - | -
- <span class="label label-warning">{{_i}}Warning{{/i}}</span>
- |
-
- {{_i}}Important{{/i}} - | -
- <span class="label label-important">{{_i}}Important{{/i}}</span>
- |
-
- {{_i}}Info{{/i}} - | -
- <span class="label label-info">{{_i}}Info{{/i}}</span>
- |
-
- {{_i}}Inverse{{/i}} - | -
- <span class="label label-inverse">{{_i}}Inverse{{/i}}</span>
- |
-
{{_i}}Labels{{/i}} | +{{_i}}Markup{{/i}} | +
---|---|
+ {{_i}}Default{{/i}} + | +
+ <span class="label">{{_i}}Default{{/i}}</span>
+ |
+
+ {{_i}}Success{{/i}} + | +
+ <span class="label label-success">{{_i}}Success{{/i}}</span>
+ |
+
+ {{_i}}Warning{{/i}} + | +
+ <span class="label label-warning">{{_i}}Warning{{/i}}</span>
+ |
+
+ {{_i}}Important{{/i}} + | +
+ <span class="label label-important">{{_i}}Important{{/i}}</span>
+ |
+
+ {{_i}}Info{{/i}} + | +
+ <span class="label label-info">{{_i}}Info{{/i}}</span>
+ |
+
+ {{_i}}Inverse{{/i}} + | +
+ <span class="label label-inverse">{{_i}}Inverse{{/i}}</span>
+ |
+
{{_i}}Badges are small, simple components for displaying an indicator or count of some sort. They're commonly found in email clients like Mail.app or on mobile apps for push notifications.{{/i}}
+{{_i}}Badges are small, simple components for displaying an indicator or count of some sort. They're commonly found in email clients like Mail.app or on mobile apps for push notifications.{{/i}}
-{{_i}}Name{{/i}} | -{{_i}}Example{{/i}} | -{{_i}}Markup{{/i}} | -
---|---|---|
- {{_i}}Default{{/i}} - | -- 1 - | -
- <span class="badge">1</span>
- |
-
- {{_i}}Success{{/i}} - | -- 2 - | -
- <span class="badge badge-success">2</span>
- |
-
- {{_i}}Warning{{/i}} - | -- 4 - | -
- <span class="badge badge-warning">4</span>
- |
-
- {{_i}}Important{{/i}} - | -- 6 - | -
- <span class="badge badge-important">6</span>
- |
-
- {{_i}}Info{{/i}} - | -- 8 - | -
- <span class="badge badge-info">8</span>
- |
-
- {{_i}}Inverse{{/i}} - | -- 10 - | -
- <span class="badge badge-inverse">10</span>
- |
-
{{_i}}Name{{/i}} | +{{_i}}Example{{/i}} | +{{_i}}Markup{{/i}} | +
---|---|---|
+ {{_i}}Default{{/i}} + | ++ 1 + | +
+ <span class="badge">1</span>
+ |
+
+ {{_i}}Success{{/i}} + | ++ 2 + | +
+ <span class="badge badge-success">2</span>
+ |
+
+ {{_i}}Warning{{/i}} + | ++ 4 + | +
+ <span class="badge badge-warning">4</span>
+ |
+
+ {{_i}}Important{{/i}} + | ++ 6 + | +
+ <span class="badge badge-important">6</span>
+ |
+
+ {{_i}}Info{{/i}} + | ++ 8 + | +
+ <span class="badge badge-info">8</span>
+ |
+
+ {{_i}}Inverse{{/i}} + | ++ 10 + | +
+ <span class="badge badge-inverse">10</span>
+ |
+
{{_i}}A lightweight, flexible component called a hero unit to showcase content on your site. It works well on marketing and content-heavy sites.{{/i}}
-{{_i}}This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.{{/i}}
- -{{_i}}A lightweight, flexible component called a hero unit to showcase content on your site. It works well on marketing and content-heavy sites.{{/i}}
+{{_i}}This is a simple hero unit, a simple jumbotron-style component for calling extra attention to featured content or information.{{/i}}
+ +<div class="hero-unit"> <h1>{{_i}}Heading{{/i}}</h1> @@ -1636,105 +1610,105 @@ </div>-
{{_i}}A simple shell for an h1
to appropriately space out and segment sections of content on a page. It can utilize the h1
's default small
, element as well most other components (with additional styles).{{/i}}
{{_i}}A simple shell for an h1
to appropriately space out and segment sections of content on a page. It can utilize the h1
's default small
, element as well most other components (with additional styles).{{/i}}
<div class="page-header"> <h1>{{_i}}Example page header{{/i}}</h1> </div>-
{{_i}}By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.{{/i}}
- +{{_i}}By default, Bootstrap's thumbnails are designed to showcase linked images with minimal required markup.{{/i}}
+ -{{_i}}With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.{{/i}}
-{{_i}}With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.{{/i}}
+{{_i}}Thumbnails (previously .media-grid
up until v1.4) are great for grids of photos or videos, image search results, retail products, portfolios, and much more. They can be links or static content.{{/i}}
{{_i}}Thumbnails (previously .media-grid
up until v1.4) are great for grids of photos or videos, image search results, retail products, portfolios, and much more. They can be links or static content.{{/i}}
{{_i}}Thumbnail markup is simple—a ul
with any number of li
elements is all that is required. It's also super flexible, allowing for any type of content with just a bit more markup to wrap your contents.{{/i}}
{{_i}}Thumbnail markup is simple—a ul
with any number of li
elements is all that is required. It's also super flexible, allowing for any type of content with just a bit more markup to wrap your contents.{{/i}}
{{_i}}Lastly, the thumbnails component uses existing grid system classes—like .span2
or .span3
—for control of thumbnail dimensions.{{/i}}
{{_i}}Lastly, the thumbnails component uses existing grid system classes—like .span2
or .span3
—for control of thumbnail dimensions.{{/i}}
{{_i}}As mentioned previously, the required markup for thumbnails is light and straightforward. Here's a look at the default setup for linked images:{{/i}}
+{{_i}}As mentioned previously, the required markup for thumbnails is light and straightforward. Here's a look at the default setup for linked images:{{/i}}
<ul class="thumbnails"> <li class="span4"> @@ -1745,7 +1719,7 @@ ... </ul>-
{{_i}}For custom HTML content in thumbnails, the markup changes slightly. To allow block level content anywhere, we swap the <a>
for a <div>
like so:{{/i}}
{{_i}}For custom HTML content in thumbnails, the markup changes slightly. To allow block level content anywhere, we swap the <a>
for a <div>
like so:{{/i}}
<ul class="thumbnails"> <li class="span4"> @@ -1759,65 +1733,65 @@ </ul>-
{{_i}}Explore all your options with the various grid classes available to you. You can also mix and match different sizes.{{/i}}
- +{{_i}}Explore all your options with the various grid classes available to you. You can also mix and match different sizes.{{/i}}
+ -{{_i}}Wrap any text and an optional dismiss button in .alert
for a basic warning alert message.{{/i}}
{{_i}}Wrap any text and an optional dismiss button in .alert
for a basic warning alert message.{{/i}}
<div class="alert"> <button type="button" class="close" data-dismiss="alert">×</button> @@ -1825,32 +1799,32 @@ </div>-
{{_i}}Mobile Safari and Mobile Opera browsers, in addition to the data-dismiss="alert"
attribute, require an href="#"
for the dismissal of alerts when using an <a>
tag.{{/i}}
{{_i}}Mobile Safari and Mobile Opera browsers, in addition to the data-dismiss="alert"
attribute, require an href="#"
for the dismissal of alerts when using an <a>
tag.{{/i}}
<a href="#" class="close" data-dismiss="alert">×</button>-
{{_i}}Alternatively, you may use a <button>
element with the data attribute, which we have opted to do for our docs. When using <button>
, you must include type="button"
or your forms may not submit.{{/i}}
{{_i}}Alternatively, you may use a <button>
element with the data attribute, which we have opted to do for our docs. When using <button>
, you must include type="button"
or your forms may not submit.{{/i}}
<button type="button" class="close" data-dismiss="alert">×</button>-
{{_i}}Use the alerts jQuery plugin for quick and easy dismissal of alerts.{{/i}}
+{{_i}}Use the alerts jQuery plugin for quick and easy dismissal of alerts.{{/i}}
-{{_i}}For longer messages, increase the padding on the top and bottom of the alert wrapper by adding .alert-block
.{{/i}}
{{_i}}Best check yo self, you're not looking too good.{{/i}} Nulla vitae elit libero, a pharetra augue. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.
-{{_i}}For longer messages, increase the padding on the top and bottom of the alert wrapper by adding .alert-block
.{{/i}}
{{_i}}Best check yo self, you're not looking too good.{{/i}} Nulla vitae elit libero, a pharetra augue. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.
+<div class="alert alert-block"> <a class="close" data-dismiss="alert" href="#">×</a> @@ -1860,97 +1834,97 @@-
{{_i}}Add optional classes to change an alert's connotation.{{/i}}
+{{_i}}Add optional classes to change an alert's connotation.{{/i}}
-<div class="alert alert-error"> ... </div>-
<div class="alert alert-success"> ... </div>-
<div class="alert alert-info"> ... </div>-
{{_i}}Default progress bar with a vertical gradient.{{/i}}
-{{_i}}Default progress bar with a vertical gradient.{{/i}}
+<div class="progress"> <div class="bar" style="width: 60%;"></div> </div>-
{{_i}}Uses a gradient to create a striped effect. Not available in IE7-8.{{/i}}
-{{_i}}Uses a gradient to create a striped effect. Not available in IE7-8.{{/i}}
+<div class="progress progress-striped"> <div class="bar" style="width: 20%;"></div> </div>-
{{_i}}Add .active
to .progress-striped
to animate the stripes right to left. Not available in all versions of IE.{{/i}}
{{_i}}Add .active
to .progress-striped
to animate the stripes right to left. Not available in all versions of IE.{{/i}}
<div class="progress progress-striped active"> <div class="bar" style="width: 40%;"></div> @@ -1958,27 +1932,27 @@-
{{_i}}Progress bars use some of the same button and alert classes for consistent styles.{{/i}}
-{{_i}}Progress bars use some of the same button and alert classes for consistent styles.{{/i}}
+<div class="progress progress-info"> <div class="bar" style="width: 20%"></div> @@ -1994,22 +1968,22 @@ </div>-
{{_i}}Similar to the solid colors, we have varied striped progress bars.{{/i}}
-{{_i}}Similar to the solid colors, we have varied striped progress bars.{{/i}}
+<div class="progress progress-info progress-striped"> <div class="bar" style="width: 20%"></div> @@ -2026,74 +2000,74 @@-
{{_i}}Progress bars use CSS3 gradients, transitions, and animations to achieve all their effects. These features are not supported in IE7-9 or older versions of Firefox.{{/i}}
-{{_i}}Opera and IE do not support animations at this time.{{/i}}
+{{_i}}Progress bars use CSS3 gradients, transitions, and animations to achieve all their effects. These features are not supported in IE7-9 or older versions of Firefox.{{/i}}
+{{_i}}Opera and IE do not support animations at this time.{{/i}}
-{{_i}}Use the well as a simple effect on an element to give it an inset effect.{{/i}}
-{{_i}}Use the well as a simple effect on an element to give it an inset effect.{{/i}}
+<div class="well"> ... </div>-
{{_i}}Control padding and rounded corners with two optional modifier classes.{{/i}}
-{{_i}}Control padding and rounded corners with two optional modifier classes.{{/i}}
+<div class="well well-large"> ... </div>-
<div class="well well-small"> ... </div>-
{{_i}}Use the generic close icon for dismissing content like modals and alerts.{{/i}}
-{{_i}}Use the generic close icon for dismissing content like modals and alerts.{{/i}}
+<button class="close">×</button>
{{_i}}iOS devices require an href="#" for click events if you rather use an anchor.{{/i}}
<a class="close" href="#">×</a>-
{{_i}}Simple, focused classes for small display or behavior tweaks.{{/i}}
+{{_i}}Simple, focused classes for small display or behavior tweaks.{{/i}}
-{{_i}}Float an element left{{/i}}
+{{_i}}Float an element left{{/i}}
class="pull-left"@@ -2103,8 +2077,8 @@ class="pull-left" } -
{{_i}}Float an element right{{/i}}
+{{_i}}Float an element right{{/i}}
class="pull-right"@@ -2114,8 +2088,8 @@ class="pull-right" } -
{{_i}}Change an element's color to #999
{{/i}}
{{_i}}Change an element's color to #999
{{/i}}
class="muted"@@ -2125,8 +2099,8 @@ class="muted" } -
{{_i}}Clear the float
on any element{{/i}}
{{_i}}Clear the float
on any element{{/i}}
class="clearfix"@@ -2144,7 +2118,9 @@ class="clearfix" } -
{{_i}}Extend Bootstrap with LESS, a CSS preprocessor, to take advantage of the variables, mixins, and more used to build Bootstrap's CSS.{{/i}}
-{{_i}}Extend Bootstrap to take advantage of included styles and components, as well as LESS variables and mixins.{{/i}}
{{_i}}Bootstrap is made with LESS at its core, a dynamic stylesheet language created by our good friend, Alexis Sellier. It makes developing systems-based CSS faster, easier, and more fun.{{/i}}
- -{{_i}}As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.{{/i}}
- -{{_i}}Visit the official website at http://lesscss.org to learn more.{{/i}}
- -{{_i}}Managing colors and pixel values in CSS can be a bit of a pain, usually full of copy and paste. Not with LESS though—assign colors or pixel values as variables and change them once.{{/i}}
- -{{_i}}Those three border-radius declarations you need to make in regular ol' CSS? Now they're down to one line with the help of mixins, snippets of code you can reuse anywhere.{{/i}}
- -{{_i}}Make your grid, leading, and more super flexible by doing the math on the fly with operations. Multiply, divide, add, and subtract your way to CSS sanity.{{/i}}
- +{{_i}}Bootstrap is made with LESS at its core, a dynamic stylesheet language created by our good friend, Alexis Sellier. It makes developing systems-based CSS faster, easier, and more fun.{{/i}}
-{{_i}}Install the LESS command line compiler, JSHint, Recess, and uglify-js globally with npm by running the following command:{{/i}}
-$ npm install -g less jshint recess uglify-js-
{{_i}}Once installed just run make
from the root of your bootstrap directory and you're all set.{{/i}}
{{_i}}Additionally, if you have watchr installed, you may run make watch
to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).{{/i}}
{{_i}}As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.{{/i}}
-{{_i}}Install the LESS command line tool via Node and run the following command:{{/i}}
-$ lessc ./less/bootstrap.less > bootstrap.css-
{{_i}}Be sure to include --compress
in that command if you're trying to save some bytes!{{/i}}
{{_i}}Visit the official website at http://lesscss.org to learn more.{{/i}}
+{{_i}}Download the latest Less.js and include the path to it (and Bootstrap) in the <head>
.{{/i}}
{{_i}}Install the LESS command line compiler, JSHint, Recess, and uglify-js globally with npm by running the following command:{{/i}}
+$ npm install -g less jshint recess uglify-js+
{{_i}}Once installed just run make
from the root of your bootstrap directory and you're all set.{{/i}}
{{_i}}Additionally, if you have watchr installed, you may run make watch
to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).{{/i}}
{{_i}}Install the LESS command line tool via Node and run the following command:{{/i}}
+$ lessc ./less/bootstrap.less > bootstrap.css+
{{_i}}Be sure to include --compress
in that command if you're trying to save some bytes!{{/i}}
{{_i}}Download the latest Less.js and include the path to it (and Bootstrap) in the <head>
.{{/i}}
<link rel="stylesheet/less" href="/path/to/bootstrap.less"> <script src="/path/to/less.js"></script>-
{{_i}}To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.{{/i}}
+{{_i}}To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.{{/i}}
-{{_i}}The unofficial Mac app watches directories of .less files and compiles the code to local files after every save of a watched .less file.{{/i}}
-{{_i}}If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.{{/i}}
+{{_i}}The unofficial Mac app watches directories of .less files and compiles the code to local files after every save of a watched .less file.{{/i}}
+{{_i}}If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.{{/i}}
-{{_i}}Crunch is a great looking LESS editor and compiler built on Adobe Air.{{/i}}
-{{_i}}Created by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.{{/i}}
-{{_i}}Mac, Linux, and PC app for drag and drop compiling of LESS files. Plus, the source code is on GitHub.{{/i}}
+{{_i}}Crunch is a great looking LESS editor and compiler built on Adobe Air.{{/i}}
+{{_i}}Created by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.{{/i}}
+{{_i}}Mac, Linux, and PC app for drag and drop compiling of LESS files. Plus, the source code is on GitHub.{{/i}}
-...
+{{_i}}Bring Bootstrap's components to life—now with 12 custom jQuery plugins.{{/i}} -
{{_i}}If you have downloaded the latest version of Bootstrap, both bootstrap.js and bootstrap.min.js contain all of these plugins.{{/i}}
- -{{_i}}...{{/i}}
- -{{_i}}...{{/i}}
- - - {{! Thought: consider porting much of the JS readme here? }} - -{{_i}}For simple transition effects, include bootstrap-transition.js once alongside the other JS files. If you're using the compiled (or minified) bootstrap.js, there is no need to include this—it's already there.{{/i}}
-{{_i}}A few examples of the transition plugin:{{/i}}
-{{_i}}Modals are streamlined, but flexible, dialog prompts with the minimum required functionality and smart defaults.{{/i}}
- -{{_i}}A rendered modal with header, body, and set of actions in the footer.{{/i}}
-{{_i}}One fine body…{{/i}}
+ +{{_i}}If you have downloaded the latest version of Bootstrap, both bootstrap.js and bootstrap.min.js contain all of these plugins.{{/i}}
+ +{{_i}}...{{/i}}
+ +{{_i}}...{{/i}}
+ + + {{! Thought: consider porting much of the JS readme here? }} + + + + + + +{{_i}}For simple transition effects, include bootstrap-transition.js once alongside the other JS files. If you're using the compiled (or minified) bootstrap.js, there is no need to include this—it's already there.{{/i}}
+{{_i}}A few examples of the transition plugin:{{/i}}
+{{_i}}Modals are streamlined, but flexible, dialog prompts with the minimum required functionality and smart defaults.{{/i}}
+ +{{_i}}A rendered modal with header, body, and set of actions in the footer.{{/i}}
+{{_i}}One fine body…{{/i}}
+<div class="modal hide fade"> <div class="modal-header"> @@ -137,43 +120,43 @@ </div>-
{{_i}}Toggle a modal via javascript by clicking the button below. It will slide down and fade in from the top of the page.{{/i}}
- -Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem.
+{{_i}}Toggle a modal via javascript by clicking the button below. It will slide down and fade in from the top of the page.{{/i}}
+ +Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem.
-{{_i}}This button should trigger a popover on hover.{{/i}}
+{{_i}}This button should trigger a popover on hover.{{/i}}
-{{_i}}This link and that link should have tooltips on hover.{{/i}}
+{{_i}}This link and that link should have tooltips on hover.{{/i}}
-{{_i}}We set a fixed max-height
on the .modal-body
. Watch it overflow with all this extra lorem ipsum text we've included.{{/i}}
Cras mattis consectetur purus sit amet fermentum. Cras justo odio, dapibus ac facilisis in, egestas eget quam. Morbi leo risus, porta ac consectetur ac, vestibulum at eros.
-Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor.
-Aenean lacinia bibendum nulla sed consectetur. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Donec sed odio dui. Donec ullamcorper nulla non metus auctor fringilla.
-Cras mattis consectetur purus sit amet fermentum. Cras justo odio, dapibus ac facilisis in, egestas eget quam. Morbi leo risus, porta ac consectetur ac, vestibulum at eros.
-Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor.
-Aenean lacinia bibendum nulla sed consectetur. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Donec sed odio dui. Donec ullamcorper nulla non metus auctor fringilla.
-{{_i}}We set a fixed max-height
on the .modal-body
. Watch it overflow with all this extra lorem ipsum text we've included.{{/i}}
Cras mattis consectetur purus sit amet fermentum. Cras justo odio, dapibus ac facilisis in, egestas eget quam. Morbi leo risus, porta ac consectetur ac, vestibulum at eros.
+Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor.
+Aenean lacinia bibendum nulla sed consectetur. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Donec sed odio dui. Donec ullamcorper nulla non metus auctor fringilla.
+Cras mattis consectetur purus sit amet fermentum. Cras justo odio, dapibus ac facilisis in, egestas eget quam. Morbi leo risus, porta ac consectetur ac, vestibulum at eros.
+Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Vivamus sagittis lacus vel augue laoreet rutrum faucibus dolor auctor.
+Aenean lacinia bibendum nulla sed consectetur. Praesent commodo cursus magna, vel scelerisque nisl consectetur et. Donec sed odio dui. Donec ullamcorper nulla non metus auctor fringilla.
+<-- Button to trigger modal --> <a href="#myModal" role="button" class="btn" data-toggle="modal">{{_i}}Launch demo modal{{/i}}</a> @@ -195,214 +178,214 @@-
{{_i}}Activate a modal without writing javascript. Set data-toggle="modal"
on a controller element, like a button, along with a data-target="#foo"
or href="#foo"
to target a specific modal to toggle.{{/i}}
{{_i}}Activate a modal without writing javascript. Set data-toggle="modal"
on a controller element, like a button, along with a data-target="#foo"
or href="#foo"
to target a specific modal to toggle.{{/i}}
<button type="button" data-toggle="modal" data-target="#myModal">Launch modal</button>-
{{_i}}Call a modal with id myModal
with a single line of javascript:{{/i}}
$('#myModal').modal(options)+
{{_i}}Call a modal with id myModal
with a single line of javascript:{{/i}}
$('#myModal').modal(options)-
{{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-backdrop=""
.{{/i}}
{{_i}}Name{{/i}} | -{{_i}}type{{/i}} | -{{_i}}default{{/i}} | -{{_i}}description{{/i}} | -
---|---|---|---|
{{_i}}backdrop{{/i}} | -{{_i}}boolean{{/i}} | -{{_i}}true{{/i}} | -{{_i}}Includes a modal-backdrop element. Alternatively, specify static for a backdrop which doesn't close the modal on click.{{/i}} |
-
{{_i}}keyboard{{/i}} | -{{_i}}boolean{{/i}} | -{{_i}}true{{/i}} | -{{_i}}Closes the modal when escape key is pressed{{/i}} | -
{{_i}}show{{/i}} | -{{_i}}boolean{{/i}} | -{{_i}}true{{/i}} | -{{_i}}Shows the modal when initialized.{{/i}} | -
{{_i}}remote{{/i}} | -{{_i}}path{{/i}} | -{{_i}}false{{/i}} | -{{_i}}If a remote url is provided, content will be loaded via jQuery's
|
-
{{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-backdrop=""
.{{/i}}
{{_i}}Name{{/i}} | +{{_i}}type{{/i}} | +{{_i}}default{{/i}} | +{{_i}}description{{/i}} | +
---|---|---|---|
{{_i}}backdrop{{/i}} | +{{_i}}boolean{{/i}} | +{{_i}}true{{/i}} | +{{_i}}Includes a modal-backdrop element. Alternatively, specify static for a backdrop which doesn't close the modal on click.{{/i}} |
+
{{_i}}keyboard{{/i}} | +{{_i}}boolean{{/i}} | +{{_i}}true{{/i}} | +{{_i}}Closes the modal when escape key is pressed{{/i}} | +
{{_i}}show{{/i}} | +{{_i}}boolean{{/i}} | +{{_i}}true{{/i}} | +{{_i}}Shows the modal when initialized.{{/i}} | +
{{_i}}remote{{/i}} | +{{_i}}path{{/i}} | +{{_i}}false{{/i}} | +{{_i}}If a remote url is provided, content will be loaded via jQuery's
|
+
{{_i}}Activates your content as a modal. Accepts an optional options object
.{{/i}}
{{_i}}Activates your content as a modal. Accepts an optional options object
.{{/i}}
$('#myModal').modal({ keyboard: false })-
{{_i}}Manually toggles a modal.{{/i}}
-$('#myModal').modal('toggle')-
{{_i}}Manually opens a modal.{{/i}}
-$('#myModal').modal('show')-
{{_i}}Manually hides a modal.{{/i}}
-$('#myModal').modal('hide')-
{{_i}}Bootstrap's modal class exposes a few events for hooking into modal functionality.{{/i}}
-{{_i}}Event{{/i}} | -{{_i}}Description{{/i}} | -
---|---|
{{_i}}show{{/i}} | -{{_i}}This event fires immediately when the show instance method is called.{{/i}} |
-
{{_i}}shown{{/i}} | -{{_i}}This event is fired when the modal has been made visible to the user (will wait for css transitions to complete).{{/i}} | -
{{_i}}hide{{/i}} | -{{_i}}This event is fired immediately when the hide instance method has been called.{{/i}} |
-
{{_i}}hidden{{/i}} | -{{_i}}This event is fired when the modal has finished being hidden from the user (will wait for css transitions to complete).{{/i}} | -
{{_i}}Manually toggles a modal.{{/i}}
+$('#myModal').modal('toggle')+
{{_i}}Manually opens a modal.{{/i}}
+$('#myModal').modal('show')+
{{_i}}Manually hides a modal.{{/i}}
+$('#myModal').modal('hide')+
{{_i}}Bootstrap's modal class exposes a few events for hooking into modal functionality.{{/i}}
+{{_i}}Event{{/i}} | +{{_i}}Description{{/i}} | +
---|---|
{{_i}}show{{/i}} | +{{_i}}This event fires immediately when the show instance method is called.{{/i}} |
+
{{_i}}shown{{/i}} | +{{_i}}This event is fired when the modal has been made visible to the user (will wait for css transitions to complete).{{/i}} | +
{{_i}}hide{{/i}} | +{{_i}}This event is fired immediately when the hide instance method has been called.{{/i}} |
+
{{_i}}hidden{{/i}} | +{{_i}}This event is fired when the modal has finished being hidden from the user (will wait for css transitions to complete).{{/i}} | +
$('#myModal').on('hidden', function () { // {{_i}}do something…{{/i}} })-
{{_i}}Add dropdown menus to nearly anything with this simple plugin, including the navbar, tabs, and pills.{{/i}}
- -{{_i}}Add dropdown menus to nearly anything with this simple plugin, including the navbar, tabs, and pills.{{/i}}
+ +{{_i}}Add data-toggle="dropdown"
to a link or button to toggle a dropdown.{{/i}}
{{_i}}Add data-toggle="dropdown"
to a link or button to toggle a dropdown.{{/i}}
<div class="dropdown"> <a class="dropdown-toggle" href="#">Dropdown trigger</a> @@ -411,7 +394,7 @@ $('#myModal').on('hidden', function () { </ul> </div>-
{{_i}}To keep URLs intact, use the data-target
attribute instead of href="#"
.{{/i}}
{{_i}}To keep URLs intact, use the data-target
attribute instead of href="#"
.{{/i}}
<div class="dropdown"> <a class="dropdown-toggle" id="dLabel" role="button" data-toggle="dropdown" data-target="#" href="/page.html"> @@ -424,179 +407,179 @@ $('#myModal').on('hidden', function () { </div>-
{{_i}}Call the dropdowns via javascript:{{/i}}
-$('.dropdown-toggle').dropdown()+
{{_i}}Call the dropdowns via javascript:{{/i}}
+$('.dropdown-toggle').dropdown()-
{{_i}}None{{/i}}
+{{_i}}None{{/i}}
-{{_i}}A programatic api for activating menus for a given navbar or tabbed navigation.{{/i}}
- +{{_i}}A programatic api for activating menus for a given navbar or tabbed navigation.{{/i}}
+ - -{{_i}}The ScrollSpy plugin is for automatically updating nav targets based on scroll position. Scroll the area below the navbar and watch the active class change. The dropdown sub items will be highlighted as well.{{/i}}
-Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
-Veniam marfa mustache skateboard, adipisicing fugiat velit pitchfork beard. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. Tattooed cosby sweater food truck, mcsweeney's quis non freegan vinyl. Lo-fi wes anderson +1 sartorial. Carles non aesthetic exercitation quis gentrify. Brooklyn adipisicing craft beer vice keytar deserunt.
-Occaecat commodo aliqua delectus. Fap craft beer deserunt skateboard ea. Lomo bicycle rights adipisicing banh mi, velit ea sunt next level locavore single-origin coffee in magna veniam. High life id vinyl, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi DIY minim messenger bag. Cred ex in, sustainable delectus consectetur fanny pack iphone.
-In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.
-Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
-Keytar twee blog, culpa messenger bag marfa whatever delectus food truck. Sapiente synth id assumenda. Locavore sed helvetica cliche irony, thundercats you probably haven't heard of them consequat hoodie gluten-free lo-fi fap aliquip. Labore elit placeat before they sold out, terry richardson proident brunch nesciunt quis cosby sweater pariatur keffiyeh ut helvetica artisan. Cardigan craft beer seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats. -
-{{_i}}The ScrollSpy plugin is for automatically updating nav targets based on scroll position. Scroll the area below the navbar and watch the active class change. The dropdown sub items will be highlighted as well.{{/i}}
+Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
+Veniam marfa mustache skateboard, adipisicing fugiat velit pitchfork beard. Freegan beard aliqua cupidatat mcsweeney's vero. Cupidatat four loko nisi, ea helvetica nulla carles. Tattooed cosby sweater food truck, mcsweeney's quis non freegan vinyl. Lo-fi wes anderson +1 sartorial. Carles non aesthetic exercitation quis gentrify. Brooklyn adipisicing craft beer vice keytar deserunt.
+Occaecat commodo aliqua delectus. Fap craft beer deserunt skateboard ea. Lomo bicycle rights adipisicing banh mi, velit ea sunt next level locavore single-origin coffee in magna veniam. High life id vinyl, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi DIY minim messenger bag. Cred ex in, sustainable delectus consectetur fanny pack iphone.
+In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.
+Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
+Keytar twee blog, culpa messenger bag marfa whatever delectus food truck. Sapiente synth id assumenda. Locavore sed helvetica cliche irony, thundercats you probably haven't heard of them consequat hoodie gluten-free lo-fi fap aliquip. Labore elit placeat before they sold out, terry richardson proident brunch nesciunt quis cosby sweater pariatur keffiyeh ut helvetica artisan. Cardigan craft beer seitan readymade velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco thundercats. +
+{{_i}}To easily add scrollspy behavior to your topbar navigation, just add data-spy="scroll"
to the element you want to spy on (most typically this would be the body) and data-target=".navbar"
to select which nav to use.{{/i}}
<body data-spy="scroll" data-target=".navbar">...</body>-
{{_i}}Call the scrollspy via javascript:{{/i}}
-$('#navbar').scrollspy()+
<a href="#home">home</a>
must correspond to something in the dom like <div id="home"></div>
.{{/i}}
- {{_i}}To easily add scrollspy behavior to your topbar navigation, just add data-spy="scroll"
to the element you want to spy on (most typically this would be the body) and data-target=".navbar"
to select which nav to use.{{/i}}
<body data-spy="scroll" data-target=".navbar">...</body>-
{{_i}}When using scrollspy in conjunction with adding or removing of elements from the DOM, you'll need to call the refresh method like so:{{/i}}
+{{_i}}Call the scrollspy via javascript:{{/i}}
+$('#navbar').scrollspy()+ +
<a href="#home">home</a>
must correspond to something in the dom like <div id="home"></div>
.{{/i}}
+ {{_i}}When using scrollspy in conjunction with adding or removing of elements from the DOM, you'll need to call the refresh method like so:{{/i}}
$('[data-spy="scroll"]').each(function () { var $spy = $(this).scrollspy('refresh') });-
{{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-offset=""
.{{/i}}
{{_i}}Name{{/i}} | -{{_i}}type{{/i}} | -{{_i}}default{{/i}} | -{{_i}}description{{/i}} | -
---|---|---|---|
{{_i}}offset{{/i}} | -{{_i}}number{{/i}} | -{{_i}}10{{/i}} | -{{_i}}Pixels to offset from top when calculating position of scroll.{{/i}} | -
{{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-offset=""
.{{/i}}
{{_i}}Name{{/i}} | +{{_i}}type{{/i}} | +{{_i}}default{{/i}} | +{{_i}}description{{/i}} | +
---|---|---|---|
{{_i}}offset{{/i}} | +{{_i}}number{{/i}} | +{{_i}}10{{/i}} | +{{_i}}Pixels to offset from top when calculating position of scroll.{{/i}} | +
{{_i}}Event{{/i}} | -{{_i}}Description{{/i}} | -
---|---|
{{_i}}activate{{/i}} | -{{_i}}This event fires whenever a new item becomes activated by the scrollspy.{{/i}} | -
{{_i}}Event{{/i}} | +{{_i}}Description{{/i}} | +
---|---|
{{_i}}activate{{/i}} | +{{_i}}This event fires whenever a new item becomes activated by the scrollspy.{{/i}} | +
{{_i}}Add quick, dynamic tab functionality to transiton through panes of local content, even via dropdown menus.{{/i}}
-{{_i}}Add quick, dynamic tab functionality to transiton through panes of local content, even via dropdown menus.{{/i}}
+Raw denim you probably haven't heard of them jean shorts Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Mustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Cosby sweater eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan american apparel, butcher voluptate nisi qui.
-Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.
-Etsy mixtape wayfarers, ethical wes anderson tofu before they sold out mcsweeney's organic lomo retro fanny pack lo-fi farm-to-table readymade. Messenger bag gentrify pitchfork tattooed craft beer, iphone skateboard locavore carles etsy salvia banksy hoodie helvetica. DIY synth PBR banksy irony. Leggings gentrify squid 8-bit cred pitchfork. Williamsburg banh mi whatever gluten-free, carles pitchfork biodiesel fixie etsy retro mlkshk vice blog. Scenester cred you probably haven't heard of them, vinyl craft beer blog stumptown. Pitchfork sustainable tofu synth chambray yr.
-Trust fund seitan letterpress, keytar raw denim keffiyeh etsy art party before they sold out master cleanse gluten-free squid scenester freegan cosby sweater. Fanny pack portland seitan DIY, art party locavore wolf cliche high life echo park Austin. Cred vinyl keffiyeh DIY salvia PBR, banh mi before they sold out farm-to-table VHS viral locavore cosby sweater. Lomo wolf viral, mustache readymade thundercats keffiyeh craft beer marfa ethical. Wolf salvia freegan, sartorial keffiyeh echo park vegan.
-Raw denim you probably haven't heard of them jean shorts Austin. Nesciunt tofu stumptown aliqua, retro synth master cleanse. Mustache cliche tempor, williamsburg carles vegan helvetica. Reprehenderit butcher retro keffiyeh dreamcatcher synth. Cosby sweater eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan american apparel, butcher voluptate nisi qui.
+Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.
+Etsy mixtape wayfarers, ethical wes anderson tofu before they sold out mcsweeney's organic lomo retro fanny pack lo-fi farm-to-table readymade. Messenger bag gentrify pitchfork tattooed craft beer, iphone skateboard locavore carles etsy salvia banksy hoodie helvetica. DIY synth PBR banksy irony. Leggings gentrify squid 8-bit cred pitchfork. Williamsburg banh mi whatever gluten-free, carles pitchfork biodiesel fixie etsy retro mlkshk vice blog. Scenester cred you probably haven't heard of them, vinyl craft beer blog stumptown. Pitchfork sustainable tofu synth chambray yr.
+Trust fund seitan letterpress, keytar raw denim keffiyeh etsy art party before they sold out master cleanse gluten-free squid scenester freegan cosby sweater. Fanny pack portland seitan DIY, art party locavore wolf cliche high life echo park Austin. Cred vinyl keffiyeh DIY salvia PBR, banh mi before they sold out farm-to-table VHS viral locavore cosby sweater. Lomo wolf viral, mustache readymade thundercats keffiyeh craft beer marfa ethical. Wolf salvia freegan, sartorial keffiyeh echo park vegan.
+{{_i}}Enable tabbable tabs via javascript (each tab needs to be activated individually):{{/i}}
+{{_i}}Enable tabbable tabs via javascript (each tab needs to be activated individually):{{/i}}
$('#myTab a').click(function (e) { e.preventDefault(); @@ -610,8 +593,8 @@ $('#myTab a:last').tab('show'); // Select last tab $('#myTab li:eq(2) a').tab('show'); // Select third tab (0-indexed)-
{{_i}}You can activate a tab or pill navigation without writing any javascript by simply specifying data-toggle="tab"
or data-toggle="pill"
on an element. Adding the nav
and nav-tabs
classes to the tab ul
will apply the bootstrap tab styling.{{/i}}
{{_i}}You can activate a tab or pill navigation without writing any javascript by simply specifying data-toggle="tab"
or data-toggle="pill"
on an element. Adding the nav
and nav-tabs
classes to the tab ul
will apply the bootstrap tab styling.{{/i}}
<ul class="nav nav-tabs"> <li><a href="#home" data-toggle="tab">{{_i}}Home{{/i}}</a></li> @@ -620,11 +603,11 @@ $('#myTab li:eq(2) a').tab('show'); // Select third tab (0-indexed) <li><a href="#settings" data-toggle="tab">{{_i}}Settings{{/i}}</a></li> </ul>-
- {{_i}}Activates a tab element and content container. Tab should have either a data-target
or an href
targeting a container node in the DOM.{{/i}}
-
+ {{_i}}Activates a tab element and content container. Tab should have either a data-target
or an href
targeting a container node in the DOM.{{/i}}
+
<ul class="nav nav-tabs" id="myTab"> <li class="active"><a href="#home">{{_i}}Home{{/i}}</a></li> @@ -646,418 +629,427 @@ $('#myTab li:eq(2) a').tab('show'); // Select third tab (0-indexed) }) </script>-
{{_i}}Event{{/i}} | -{{_i}}Description{{/i}} | -
---|---|
{{_i}}show{{/i}} | -{{_i}}This event fires on tab show, but before the new tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively.{{/i}} |
-
{{_i}}shown{{/i}} | -{{_i}}This event fires on tab show after a tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively.{{/i}} |
-
{{_i}}Event{{/i}} | +{{_i}}Description{{/i}} | +
---|---|
{{_i}}show{{/i}} | +{{_i}}This event fires on tab show, but before the new tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively.{{/i}} |
+
{{_i}}shown{{/i}} | +{{_i}}This event fires on tab show after a tab has been shown. Use event.target and event.relatedTarget to target the active tab and the previous active tab (if available) respectively.{{/i}} |
+
$('a[data-toggle="tab"]').on('shown', function (e) { e.target // activated tab e.relatedTarget // previous tab })-
{{_i}}Inspired by the excellent jQuery.tipsy plugin written by Jason Frame; Tooltips are an updated version, which don't rely on images, use CSS3 for animations, and data-attributes for local title storage.{{/i}}
-{{_i}}Hover over the links below to see tooltips:{{/i}}
-{{_i}}Tight pants next level keffiyeh you probably haven't heard of them. Photo booth beard raw denim letterpress vegan messenger bag stumptown. Farm-to-table seitan, mcsweeney's fixie sustainable quinoa 8-bit american apparel have a terry richardson vinyl chambray. Beard stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, four loko mcsweeney's cleanse vegan chambray. A really ironic artisan whatever keytar, scenester farm-to-table banksy Austin twitter handle freegan cred raw denim single-origin coffee viral.{{/i}} -
-{{_i}}Trigger the tooltip via javascript:{{/i}}
-$('#example').tooltip({{_i}}options{{/i}})- -
{{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-animation=""
.{{/i}}
{{_i}}Name{{/i}} | -{{_i}}type{{/i}} | -{{_i}}default{{/i}} | -{{_i}}description{{/i}} | -
---|---|---|---|
{{_i}}animation{{/i}} | -{{_i}}boolean{{/i}} | -true | -{{_i}}apply a css fade transition to the tooltip{{/i}} | -
{{_i}}html{{/i}} | -{{_i}}boolean{{/i}} | -true | -{{_i}}Insert html into the tooltip. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks.{{/i}} |
-
{{_i}}placement{{/i}} | -{{_i}}string|function{{/i}} | -'top' | -{{_i}}how to position the tooltip{{/i}} - top | bottom | left | right | -
{{_i}}selector{{/i}} | -{{_i}}string{{/i}} | -false | -{{_i}}If a selector is provided, tooltip objects will be delegated to the specified targets.{{/i}} | -
{{_i}}title{{/i}} | -{{_i}}string | function{{/i}} | -'' | -{{_i}}default title value if `title` tag isn't present{{/i}} | -
{{_i}}trigger{{/i}} | -{{_i}}string{{/i}} | -'hover' | -{{_i}}how tooltip is triggered{{/i}} - hover | focus | manual | -
{{_i}}delay{{/i}} | -{{_i}}number | object{{/i}} | -0 | -
- {{_i}}delay showing and hiding the tooltip (ms) - does not apply to manual trigger type{{/i}} -{{_i}}If a number is supplied, delay is applied to both hide/show{{/i}} -{{_i}}Object structure is: |
-
{{_i}}For performance reasons, the Tooltip and Popover data-apis are opt in. If you would like to use them just specify a selector option.{{/i}}
--<a href="#" rel="tooltip" title="{{_i}}first tooltip{{/i}}">{{_i}}hover over me{{/i}}</a> -- -
{{_i}}Attaches a tooltip handler to an element collection.{{/i}}
-{{_i}}Reveals an element's tooltip.{{/i}}
-$('#element').tooltip('show')-
{{_i}}Hides an element's tooltip.{{/i}}
-$('#element').tooltip('hide')-
{{_i}}Toggles an element's tooltip.{{/i}}
-$('#element').tooltip('toggle')-
{{_i}}Destroys an element's tooltip.{{/i}}
-$('#element').tooltip('destroy')-
{{_i}}Add small overlays of content, like those on the iPad, to any element for housing secondary information. Hover over the button to trigger the popover.{{/i}}
-* {{_i}}Requires Tooltip to be included{{/i}}
- -{{_i}}Four options are available: top, right, bottom, and left aligned.{{/i}}
-Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+ +Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+ +{{_i}}Inspired by the excellent jQuery.tipsy plugin written by Jason Frame; Tooltips are an updated version, which don't rely on images, use CSS3 for animations, and data-attributes for local title storage.{{/i}}
+{{_i}}Hover over the links below to see tooltips:{{/i}}
+{{_i}}Tight pants next level keffiyeh you probably haven't heard of them. Photo booth beard raw denim letterpress vegan messenger bag stumptown. Farm-to-table seitan, mcsweeney's fixie sustainable quinoa 8-bit american apparel have a terry richardson vinyl chambray. Beard stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, four loko mcsweeney's cleanse vegan chambray. A really ironic artisan whatever keytar, scenester farm-to-table banksy Austin twitter handle freegan cred raw denim single-origin coffee viral.{{/i}} +
+{{_i}}Trigger the tooltip via javascript:{{/i}}
+$('#example').tooltip({{_i}}options{{/i}})+ +
{{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-animation=""
.{{/i}}
{{_i}}Name{{/i}} | +{{_i}}type{{/i}} | +{{_i}}default{{/i}} | +{{_i}}description{{/i}} | +
---|---|---|---|
{{_i}}animation{{/i}} | +{{_i}}boolean{{/i}} | +true | +{{_i}}apply a css fade transition to the tooltip{{/i}} | +
{{_i}}html{{/i}} | +{{_i}}boolean{{/i}} | +true | +{{_i}}Insert html into the tooltip. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks.{{/i}} |
+
{{_i}}placement{{/i}} | +{{_i}}string|function{{/i}} | +'top' | +{{_i}}how to position the tooltip{{/i}} - top | bottom | left | right | +
{{_i}}selector{{/i}} | +{{_i}}string{{/i}} | +false | +{{_i}}If a selector is provided, tooltip objects will be delegated to the specified targets.{{/i}} | +
{{_i}}title{{/i}} | +{{_i}}string | function{{/i}} | +'' | +{{_i}}default title value if `title` tag isn't present{{/i}} | +
{{_i}}trigger{{/i}} | +{{_i}}string{{/i}} | +'hover' | +{{_i}}how tooltip is triggered{{/i}} - hover | focus | manual | +
{{_i}}delay{{/i}} | +{{_i}}number | object{{/i}} | +0 | +
+ {{_i}}delay showing and hiding the tooltip (ms) - does not apply to manual trigger type{{/i}} +{{_i}}If a number is supplied, delay is applied to both hide/show{{/i}} +{{_i}}Object structure is: |
+
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+{{_i}}For performance reasons, the Tooltip and Popover data-apis are opt in. If you would like to use them just specify a selector option.{{/i}}
++ <a href="#" rel="tooltip" title="{{_i}}first tooltip{{/i}}">{{_i}}hover over me{{/i}}</a> ++ +
{{_i}}Attaches a tooltip handler to an element collection.{{/i}}
+{{_i}}Reveals an element's tooltip.{{/i}}
+$('#element').tooltip('show')+
{{_i}}Hides an element's tooltip.{{/i}}
+$('#element').tooltip('hide')+
{{_i}}Toggles an element's tooltip.{{/i}}
+$('#element').tooltip('toggle')+
{{_i}}Destroys an element's tooltip.{{/i}}
+$('#element').tooltip('destroy')+ + + + + +
Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+{{_i}}Add small overlays of content, like those on the iPad, to any element for housing secondary information. Hover over the button to trigger the popover. Requires Tooltip to be included.{{/i}}
+ +{{_i}}Four options are available: top, right, bottom, and left aligned.{{/i}}
+Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+Sed posuere consectetur est at lobortis. Aenean eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
+{{_i}}No markup shown as popovers are generated from javascript and content within a data
attribute.{{/i}}
{{_i}}No markup shown as popovers are generated from javascript and content within a data
attribute.{{/i}}
{{_i}}Enable popovers via javascript:{{/i}}
-$('#example').popover({{_i}}options{{/i}})+
{{_i}}Enable popovers via javascript:{{/i}}
+$('#example').popover({{_i}}options{{/i}})-
{{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-animation=""
.{{/i}}
{{_i}}Name{{/i}} | -{{_i}}type{{/i}} | -{{_i}}default{{/i}} | -{{_i}}description{{/i}} | -
---|---|---|---|
{{_i}}animation{{/i}} | -{{_i}}boolean{{/i}} | -true | -{{_i}}apply a css fade transition to the tooltip{{/i}} | -
{{_i}}html{{/i}} | -{{_i}}boolean{{/i}} | -true | -{{_i}}Insert html into the popover. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks.{{/i}} |
-
{{_i}}placement{{/i}} | -{{_i}}string|function{{/i}} | -'right' | -{{_i}}how to position the popover{{/i}} - top | bottom | left | right | -
{{_i}}selector{{/i}} | -{{_i}}string{{/i}} | -false | -{{_i}}if a selector is provided, tooltip objects will be delegated to the specified targets{{/i}} | -
{{_i}}trigger{{/i}} | -{{_i}}string{{/i}} | -'hover' | -{{_i}}how popover is triggered{{/i}} - hover | focus | manual | -
{{_i}}title{{/i}} | -{{_i}}string | function{{/i}} | -'' | -{{_i}}default title value if `title` attribute isn't present{{/i}} | -
{{_i}}content{{/i}} | -{{_i}}string | function{{/i}} | -'' | -{{_i}}default content value if `data-content` attribute isn't present{{/i}} | -
{{_i}}delay{{/i}} | -{{_i}}number | object{{/i}} | -0 | -
- {{_i}}delay showing and hiding the popover (ms) - does not apply to manual trigger type{{/i}} -{{_i}}If a number is supplied, delay is applied to both hide/show{{/i}} -{{_i}}Object structure is: |
-
{{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-animation=""
.{{/i}}
{{_i}}Name{{/i}} | +{{_i}}type{{/i}} | +{{_i}}default{{/i}} | +{{_i}}description{{/i}} | +
---|---|---|---|
{{_i}}animation{{/i}} | +{{_i}}boolean{{/i}} | +true | +{{_i}}apply a css fade transition to the tooltip{{/i}} | +
{{_i}}html{{/i}} | +{{_i}}boolean{{/i}} | +true | +{{_i}}Insert html into the popover. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks.{{/i}} |
+
{{_i}}placement{{/i}} | +{{_i}}string|function{{/i}} | +'right' | +{{_i}}how to position the popover{{/i}} - top | bottom | left | right | +
{{_i}}selector{{/i}} | +{{_i}}string{{/i}} | +false | +{{_i}}if a selector is provided, tooltip objects will be delegated to the specified targets{{/i}} | +
{{_i}}trigger{{/i}} | +{{_i}}string{{/i}} | +'hover' | +{{_i}}how popover is triggered{{/i}} - hover | focus | manual | +
{{_i}}title{{/i}} | +{{_i}}string | function{{/i}} | +'' | +{{_i}}default title value if `title` attribute isn't present{{/i}} | +
{{_i}}content{{/i}} | +{{_i}}string | function{{/i}} | +'' | +{{_i}}default content value if `data-content` attribute isn't present{{/i}} | +
{{_i}}delay{{/i}} | +{{_i}}number | object{{/i}} | +0 | +
+ {{_i}}delay showing and hiding the popover (ms) - does not apply to manual trigger type{{/i}} +{{_i}}If a number is supplied, delay is applied to both hide/show{{/i}} +{{_i}}Object structure is: |
+
{{_i}}For performance reasons, the Tooltip and Popover data-apis are opt in. If you would like to use them just specify a selector option.{{/i}}
+{{_i}}For performance reasons, the Tooltip and Popover data-apis are opt in. If you would like to use them just specify a selector option.{{/i}}
-{{_i}}Initializes popovers for an element collection.{{/i}}
-{{_i}}Reveals an elements popover.{{/i}}
-$('#element').popover('show')-
{{_i}}Hides an elements popover.{{/i}}
-$('#element').popover('hide')-
{{_i}}Toggles an elements popover.{{/i}}
-$('#element').popover('toggle')-
{{_i}}Destroys an element's popover.{{/i}}
-$('#element').popover('destroy')- +
{{_i}}Initializes popovers for an element collection.{{/i}}
+{{_i}}Reveals an elements popover.{{/i}}
+$('#element').popover('show')+
{{_i}}Hides an elements popover.{{/i}}
+$('#element').popover('hide')+
{{_i}}Toggles an elements popover.{{/i}}
+$('#element').popover('toggle')+
{{_i}}Destroys an element's popover.{{/i}}
+$('#element').popover('destroy')+ - -
{{_i}}Add dismiss functionality to all alerge messages with this plugin.{{/i}}
-{{_i}}Add dismiss functionality to all alerge messages with this plugin.{{/i}}
+{{_i}}Change this and that and try again. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.{{/i}}
- -{{_i}}Change this and that and try again. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.{{/i}}
+ +{{_i}}Enable dismissal of an alert via javascript:{{/i}}
-$(".alert").alert()+
{{_i}}Enable dismissal of an alert via javascript:{{/i}}
+$(".alert").alert()-
{{_i}}Just add data-dismiss="alert"
to your close button to automatically give an alert close functionality.{{/i}}
<a class="close" data-dismiss="alert" href="#">×</a>+
{{_i}}Just add data-dismiss="alert"
to your close button to automatically give an alert close functionality.{{/i}}
<a class="close" data-dismiss="alert" href="#">×</a>-
{{_i}}Wraps all alerts with close functionality. To have your alerts animate out when closed, make sure they have the .fade
and .in
class already applied to them.{{/i}}
{{_i}}Closes an alert.{{/i}}
-$(".alert").alert('close')+
{{_i}}Wraps all alerts with close functionality. To have your alerts animate out when closed, make sure they have the .fade
and .in
class already applied to them.{{/i}}
{{_i}}Closes an alert.{{/i}}
+$(".alert").alert('close')-
{{_i}}Bootstrap's alert class exposes a few events for hooking into alert functionality.{{/i}}
-{{_i}}Event{{/i}} | -{{_i}}Description{{/i}} | -
---|---|
{{_i}}close{{/i}} | -{{_i}}This event fires immediately when the close instance method is called.{{/i}} |
-
{{_i}}closed{{/i}} | -{{_i}}This event is fired when the alert has been closed (will wait for css transitions to complete).{{/i}} | -
{{_i}}Bootstrap's alert class exposes a few events for hooking into alert functionality.{{/i}}
+{{_i}}Event{{/i}} | +{{_i}}Description{{/i}} | +
---|---|
{{_i}}close{{/i}} | +{{_i}}This event fires immediately when the close instance method is called.{{/i}} |
+
{{_i}}closed{{/i}} | +{{_i}}This event is fired when the alert has been closed (will wait for css transitions to complete).{{/i}} | +
$('#my-alert').bind('closed', function () { // {{_i}}do something…{{/i}} })-
{{_i}}Do more with buttons. Control button states or create groups of buttons for more components like toolbars.{{/i}}
+{{_i}}Do more with buttons. Control button states or create groups of buttons for more components like toolbars.{{/i}}
-{{_i}}Add data-loading-text="Loading..." to use a loading state on a button.{{/i}}
-{{_i}}Add data-loading-text="Loading..." to use a loading state on a button.{{/i}}
+<button type="button" class="btn btn-primary" data-loading-text="Loading...">Loading state</button>-
{{_i}}Add data-toggle="button" to activate toggling on a single button.{{/i}}
-{{_i}}Add data-toggle="button" to activate toggling on a single button.{{/i}}
+<button type="button" class="btn" data-toggle="button">Single Toggle</button>-
{{_i}}Add data-toggle="buttons-checkbox" for checkbox style toggling on btn-group.{{/i}}
-{{_i}}Add data-toggle="buttons-checkbox" for checkbox style toggling on btn-group.{{/i}}
+<div class="btn-group" data-toggle="buttons-checkbox"> <button type="button" class="btn">Left</button> @@ -1066,15 +1058,15 @@ $('#my-alert').bind('closed', function () { </div>-
{{_i}}Add data-toggle="buttons-radio" for radio style toggling on btn-group.{{/i}}
-{{_i}}Add data-toggle="buttons-radio" for radio style toggling on btn-group.{{/i}}
+<div class="btn-group" data-toggle="buttons-radio"> <button type="button" class="btn">Left</button> @@ -1084,101 +1076,101 @@ $('#my-alert').bind('closed', function () {-
{{_i}}Enable buttons via javascript:{{/i}}
-$('.nav-tabs').button()+
{{_i}}Enable buttons via javascript:{{/i}}
+$('.nav-tabs').button()-
{{_i}}Data attributes are integral to the button plugin. Check out the example code below for the various markup types.{{/i}}
+{{_i}}Data attributes are integral to the button plugin. Check out the example code below for the various markup types.{{/i}}
-{{_i}}None{{/i}}
+{{_i}}None{{/i}}
-{{_i}}Toggles push state. Gives the button the appearance that it has been activated.{{/i}}
-data-toggle
attribute.{{/i}}
- <button type="button" class="btn" data-toggle="button" >…</button>-
{{_i}}Sets button state to loading - disables button and swaps text to loading text. Loading text should be defined on the button element using the data attribute data-loading-text
.{{/i}}
-
<button type="button" class="btn" data-loading-text="loading stuff..." >...</button>-
autocomplete="off"
.{{/i}}
- {{_i}}Resets button state - swaps text to original text.{{/i}}
-{{_i}}Resets button state - swaps text to any data defined text state.{{/i}}
+{{_i}}Toggles push state. Gives the button the appearance that it has been activated.{{/i}}
+data-toggle
attribute.{{/i}}
+ <button type="button" class="btn" data-toggle="button" >…</button>+
{{_i}}Sets button state to loading - disables button and swaps text to loading text. Loading text should be defined on the button element using the data attribute data-loading-text
.{{/i}}
+
<button type="button" class="btn" data-loading-text="loading stuff..." >...</button>+
autocomplete="off"
.{{/i}}
+ {{_i}}Resets button state - swaps text to original text.{{/i}}
+{{_i}}Resets button state - swaps text to any data defined text state.{{/i}}
<button type="button" class="btn" data-complete-text="finished!" >...</button> <script> $('.btn').button('complete') </script>-
{{_i}}Get base styles and flexible support for collapsible components like accordions and navigation.{{/i}}
-* {{_i}}Requires the Transitions plugin to be included.{{/i}}
+{{_i}}Get base styles and flexible support for collapsible components like accordions and navigation.{{/i}}
+* {{_i}}Requires the Transitions plugin to be included.{{/i}}
-{{_i}}Using the collapse plugin, we built a simple accordion style widget:{{/i}}
+{{_i}}Using the collapse plugin, we built a simple accordion style widget:{{/i}}
-<button type="button" class="btn btn-danger" data-toggle="collapse" data-target="#demo"> {{_i}}simple collapsible{{/i}} @@ -1188,137 +1180,137 @@ $('#my-alert').bind('closed', function () {-
{{_i}}Just add data-toggle="collapse"
and a data-target
to element to automatically assign control of a collapsible element. The data-target
attribute accepts a css selector to apply the collapse to. Be sure to add the class collapse
to the collapsible element. If you'd like it to default open, add the additional class in
.{{/i}}
{{_i}}To add accordion-like group management to a collapsible control, add the data attribute data-parent="#selector"
. Refer to the demo to see this in action.{{/i}}
{{_i}}Just add data-toggle="collapse"
and a data-target
to element to automatically assign control of a collapsible element. The data-target
attribute accepts a css selector to apply the collapse to. Be sure to add the class collapse
to the collapsible element. If you'd like it to default open, add the additional class in
.{{/i}}
{{_i}}To add accordion-like group management to a collapsible control, add the data attribute data-parent="#selector"
. Refer to the demo to see this in action.{{/i}}
{{_i}}Enable manually with:{{/i}}
-$(".collapse").collapse()+
{{_i}}Enable manually with:{{/i}}
+$(".collapse").collapse()-
{{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-parent=""
.{{/i}}
{{_i}}Name{{/i}} | -{{_i}}type{{/i}} | -{{_i}}default{{/i}} | -{{_i}}description{{/i}} | -
---|---|---|---|
{{_i}}parent{{/i}} | -{{_i}}selector{{/i}} | -false | -{{_i}}If selector then all collapsible elements under the specified parent will be closed when this collapsible item is shown. (similar to traditional accordion behavior){{/i}} | -
{{_i}}toggle{{/i}} | -{{_i}}boolean{{/i}} | -true | -{{_i}}Toggles the collapsible element on invocation{{/i}} | -
{{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-parent=""
.{{/i}}
{{_i}}Name{{/i}} | +{{_i}}type{{/i}} | +{{_i}}default{{/i}} | +{{_i}}description{{/i}} | +
---|---|---|---|
{{_i}}parent{{/i}} | +{{_i}}selector{{/i}} | +false | +{{_i}}If selector then all collapsible elements under the specified parent will be closed when this collapsible item is shown. (similar to traditional accordion behavior){{/i}} | +
{{_i}}toggle{{/i}} | +{{_i}}boolean{{/i}} | +true | +{{_i}}Toggles the collapsible element on invocation{{/i}} | +
{{_i}}Activates your content as a collapsible element. Accepts an optional options object
.{{/i}}
+
{{_i}}Activates your content as a collapsible element. Accepts an optional options object
.{{/i}}
$('#myCollapsible').collapse({ toggle: false })-
{{_i}}Toggles a collapsible element to shown or hidden.{{/i}}
-{{_i}}Shows a collapsible element.{{/i}}
-{{_i}}Hides a collapsible element.{{/i}}
+{{_i}}Toggles a collapsible element to shown or hidden.{{/i}}
+{{_i}}Shows a collapsible element.{{/i}}
+{{_i}}Hides a collapsible element.{{/i}}
-{{_i}}Bootstrap's collapse class exposes a few events for hooking into collapse functionality.{{/i}}
-{{_i}}Event{{/i}} | -{{_i}}Description{{/i}} | -
---|---|
{{_i}}show{{/i}} | -{{_i}}This event fires immediately when the show instance method is called.{{/i}} |
-
{{_i}}shown{{/i}} | -{{_i}}This event is fired when a collapse element has been made visible to the user (will wait for css transitions to complete).{{/i}} | -
{{_i}}hide{{/i}} | -
- {{_i}}This event is fired immediately when the hide method has been called.{{/i}}
- |
-
{{_i}}hidden{{/i}} | -{{_i}}This event is fired when a collapse element has been hidden from the user (will wait for css transitions to complete).{{/i}} | -
{{_i}}Bootstrap's collapse class exposes a few events for hooking into collapse functionality.{{/i}}
+{{_i}}Event{{/i}} | +{{_i}}Description{{/i}} | +
---|---|
{{_i}}show{{/i}} | +{{_i}}This event fires immediately when the show instance method is called.{{/i}} |
+
{{_i}}shown{{/i}} | +{{_i}}This event is fired when a collapse element has been made visible to the user (will wait for css transitions to complete).{{/i}} | +
{{_i}}hide{{/i}} | +
+ {{_i}}This event is fired immediately when the hide method has been called.{{/i}}
+ |
+
{{_i}}hidden{{/i}} | +{{_i}}This event is fired when a collapse element has been hidden from the user (will wait for css transitions to complete).{{/i}} | +
$('#myCollapsible').on('hidden', function () { // {{_i}}do something…{{/i}} })- + - -
{{_i}}The slideshow below shows a generic plugin and component for cycling through elements like a carousel.{{/i}}
-{{_i}}The slideshow below shows a generic plugin and component for cycling through elements like a carousel.{{/i}}
+ {{! /example }}<div id="myCarousel" class="carousel slide"> <!-- {{_i}}Carousel items{{/i}} --> @@ -1333,195 +1325,197 @@ $('#myCollapsible').on('hidden', function () { </div>-
{{_i}}...{{/i}}
+{{_i}}...{{/i}}
-{{_i}}Call carousel manually with:{{/i}}
-$('.carousel').carousel()+
{{_i}}Call carousel manually with:{{/i}}
+$('.carousel').carousel()-
{{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-interval=""
.{{/i}}
{{_i}}Name{{/i}} | -{{_i}}type{{/i}} | -{{_i}}default{{/i}} | -{{_i}}description{{/i}} | -
---|---|---|---|
{{_i}}interval{{/i}} | -{{_i}}number{{/i}} | -5000 | -{{_i}}The amount of time to delay between automatically cycling an item. If false, carousel will not automatically cycle.{{/i}} | -
{{_i}}pause{{/i}} | -{{_i}}string{{/i}} | -"hover" | -{{_i}}Pauses the cycling of the carousel on mouseenter and resumes the cycling of the carousel on mouseleave.{{/i}} | -
{{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-interval=""
.{{/i}}
{{_i}}Name{{/i}} | +{{_i}}type{{/i}} | +{{_i}}default{{/i}} | +{{_i}}description{{/i}} | +
---|---|---|---|
{{_i}}interval{{/i}} | +{{_i}}number{{/i}} | +5000 | +{{_i}}The amount of time to delay between automatically cycling an item. If false, carousel will not automatically cycle.{{/i}} | +
{{_i}}pause{{/i}} | +{{_i}}string{{/i}} | +"hover" | +{{_i}}Pauses the cycling of the carousel on mouseenter and resumes the cycling of the carousel on mouseleave.{{/i}} | +
{{_i}}Initializes the carousel with an optional options object
and starts cycling through items.{{/i}}
{{_i}}Initializes the carousel with an optional options object
and starts cycling through items.{{/i}}
$('.carousel').carousel({ interval: 2000 })-
{{_i}}Cycles through the carousel items from left to right.{{/i}}
-{{_i}}Stops the carousel from cycling through items.{{/i}}
-{{_i}}Cycles the carousel to a particular frame (0 based, similar to an array).{{/i}}
-{{_i}}Cycles to the previous item.{{/i}}
-{{_i}}Cycles to the next item.{{/i}}
+{{_i}}Cycles through the carousel items from left to right.{{/i}}
+{{_i}}Stops the carousel from cycling through items.{{/i}}
+{{_i}}Cycles the carousel to a particular frame (0 based, similar to an array).{{/i}}
+{{_i}}Cycles to the previous item.{{/i}}
+{{_i}}Cycles to the next item.{{/i}}
-{{_i}}Bootstrap's carousel class exposes two events for hooking into carousel functionality.{{/i}}
-{{_i}}Event{{/i}} | -{{_i}}Description{{/i}} | -
---|---|
{{_i}}slide{{/i}} | -{{_i}}This event fires immediately when the slide instance method is invoked.{{/i}} |
-
{{_i}}slid{{/i}} | -{{_i}}This event is fired when the carousel has completed its slide transition.{{/i}} | -
{{_i}}Bootstrap's carousel class exposes two events for hooking into carousel functionality.{{/i}}
+{{_i}}Event{{/i}} | +{{_i}}Description{{/i}} | +
---|---|
{{_i}}slide{{/i}} | +{{_i}}This event fires immediately when the slide instance method is invoked.{{/i}} |
+
{{_i}}slid{{/i}} | +{{_i}}This event is fired when the carousel has completed its slide transition.{{/i}} | +
{{_i}}A basic, easily extended plugin for quickly creating elegant typeaheads with any form text input.{{/i}}
-{{_i}}A basic, easily extended plugin for quickly creating elegant typeaheads with any form text input.{{/i}}
+<input type="text" data-provide="typeahead">-
{{_i}}Add data attributes to register an element with typeahead functionality as shown in the example above.{{/i}}
+{{_i}}Add data attributes to register an element with typeahead functionality as shown in the example above.{{/i}}
-{{_i}}Call the typeahead manually with:{{/i}}
-$('.typeahead').typeahead()+
{{_i}}Call the typeahead manually with:{{/i}}
+$('.typeahead').typeahead()-
{{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-source=""
.{{/i}}
{{_i}}Name{{/i}} | -{{_i}}type{{/i}} | -{{_i}}default{{/i}} | -{{_i}}description{{/i}} | -
---|---|---|---|
{{_i}}source{{/i}} | -{{_i}}array, function{{/i}} | -[ ] | -{{_i}}The data source to query against. May be an array of strings or a function. The function is passed two arguments, the query value in the input field and the process callback. The function may be used synchronously by returning the data source directly or asynchronously via the process callback's single argument.{{/i}} |
-
{{_i}}items{{/i}} | -{{_i}}number{{/i}} | -8 | -{{_i}}The max number of items to display in the dropdown.{{/i}} | -
{{_i}}matcher{{/i}} | -{{_i}}function{{/i}} | -{{_i}}case insensitive{{/i}} | -{{_i}}The method used to determine if a query matches an item. Accepts a single argument, the item against which to test the query. Access the current query with this.query . Return a boolean true if query is a match.{{/i}} |
-
{{_i}}sorter{{/i}} | -{{_i}}function{{/i}} | -{{_i}}exact match, case sensitive, case insensitive{{/i}} |
- {{_i}}Method used to sort autocomplete results. Accepts a single argument items and has the scope of the typeahead instance. Reference the current query with this.query .{{/i}} |
-
{{_i}}highlighter{{/i}} | -{{_i}}function{{/i}} | -{{_i}}highlights all default matches{{/i}} | -{{_i}}Method used to highlight autocomplete results. Accepts a single argument item and has the scope of the typeahead instance. Should return html.{{/i}} |
-
{{_i}}Options can be passed via data attributes or javascript. For data attributes, append the option name to data-
, as in data-source=""
.{{/i}}
{{_i}}Name{{/i}} | +{{_i}}type{{/i}} | +{{_i}}default{{/i}} | +{{_i}}description{{/i}} | +
---|---|---|---|
{{_i}}source{{/i}} | +{{_i}}array, function{{/i}} | +[ ] | +{{_i}}The data source to query against. May be an array of strings or a function. The function is passed two arguments, the query value in the input field and the process callback. The function may be used synchronously by returning the data source directly or asynchronously via the process callback's single argument.{{/i}} |
+
{{_i}}items{{/i}} | +{{_i}}number{{/i}} | +8 | +{{_i}}The max number of items to display in the dropdown.{{/i}} | +
{{_i}}matcher{{/i}} | +{{_i}}function{{/i}} | +{{_i}}case insensitive{{/i}} | +{{_i}}The method used to determine if a query matches an item. Accepts a single argument, the item against which to test the query. Access the current query with this.query . Return a boolean true if query is a match.{{/i}} |
+
{{_i}}sorter{{/i}} | +{{_i}}function{{/i}} | +{{_i}}exact match, case sensitive, case insensitive{{/i}} |
+ {{_i}}Method used to sort autocomplete results. Accepts a single argument items and has the scope of the typeahead instance. Reference the current query with this.query .{{/i}} |
+
{{_i}}highlighter{{/i}} | +{{_i}}function{{/i}} | +{{_i}}highlights all default matches{{/i}} | +{{_i}}Method used to highlight autocomplete results. Accepts a single argument item and has the scope of the typeahead instance. Should return html.{{/i}} |
+
{{_i}}Initializes an input with a typeahead.{{/i}}
-{{_i}}Initializes an input with a typeahead.{{/i}}
+{{_i}}...{{/i}}
-{{_i}}...{{/i}}
+...-
{{_i}}Bootstrap is built on a responsive 12-column grid. We've also included fixed- and fluid-width layouts based on that system.{{/i}}
-{{_i}}Bootstrap makes use of certain HTML elements and CSS properties that require the use of the HTML5 doctype. Include it at the beginning of all your projects.{{/i}}
+{{_i}}Bootstrap makes use of certain HTML elements and CSS properties that require the use of the HTML5 doctype. Include it at the beginning of all your projects.{{/i}}
<!DOCTYPE html> <html lang="en"> @@ -49,89 +40,89 @@ </html>-
{{_i}}Bootstrap sets basic global display, typography, and link styles. Specifically, we:{{/i}}
-margin
on the body{{/i}}background-color: white;
on the body
{{/i}}@baseFontFamily
, @baseFontSize
, and @baseLineHeight
attributes as our typographyic base{{/i}}@linkColor
and apply link underlines only on :hover
{{/i}}{{_i}}These styles can be found within scaffolding.less.{{/i}}
+{{_i}}Bootstrap sets basic global display, typography, and link styles. Specifically, we:{{/i}}
+margin
on the body{{/i}}background-color: white;
on the body
{{/i}}@baseFontFamily
, @baseFontSize
, and @baseLineHeight
attributes as our typographyic base{{/i}}@linkColor
and apply link underlines only on :hover
{{/i}}{{_i}}These styles can be found within scaffolding.less.{{/i}}
-{{_i}}With Bootstrap 2, the old reset block has been dropped in favor of Normalize.css, a project by Nicolas Gallagher that also powers the HTML5 Boilerplate. While we use much of Normalize within our reset.less, we have removed some elements specifically for Bootstrap.{{/i}}
+{{_i}}With Bootstrap 2, the old reset block has been dropped in favor of Normalize.css, a project by Nicolas Gallagher that also powers the HTML5 Boilerplate. While we use much of Normalize within our reset.less, we have removed some elements specifically for Bootstrap.{{/i}}
-{{_i}}The default Bootstrap grid system utilizes 12 columns, making for a 940px wide container without responsive features enabled. With the responsive CSS file added, the grid adapts to be 724px and 1170px wide depending on your viewport. Below 767px viewports, the columns become fluid and stack vertically.{{/i}}
-{{_i}}The default Bootstrap grid system utilizes 12 columns, making for a 940px wide container without responsive features enabled. With the responsive CSS file added, the grid adapts to be 724px and 1170px wide depending on your viewport. Below 767px viewports, the columns become fluid and stack vertically.{{/i}}
+{{_i}}For a simple two column layout, create a .row
and add the appropriate number of .span*
columns. As this is a 12-column grid, each .span*
spans a number of those 12 columns, and should always add up to 12 for each row.{{/i}}
{{_i}}For a simple two column layout, create a .row
and add the appropriate number of .span*
columns. As this is a 12-column grid, each .span*
spans a number of those 12 columns, and should always add up to 12 for each row.{{/i}}
<div class="row"> <div class="span4">...</div> <div class="span8">...</div> </div>-
{{_i}}Given this example, we have .span4
and .span8
, making for 12 total columns and a complete row.{{/i}}
{{_i}}Given this example, we have .span4
and .span8
, making for 12 total columns and a complete row.{{/i}}
{{_i}}Move columns to the left using .offset*
classes. Each class increases the left margin of a column by a whole column. For example, .offset4
moves .span4
over four columns.{{/i}}
{{_i}}Move columns to the left using .offset*
classes. Each class increases the left margin of a column by a whole column. For example, .offset4
moves .span4
over four columns.{{/i}}
<div class="row"> <div class="span4">...</div> @@ -139,23 +130,23 @@ </div>-
{{_i}}To nest your content with the default grid, add a new .row
and set of .span*
columns within an existing .span*
column. Nested rows should include a set of columns that add up to the number of columns of its parent.{{/i}}
{{_i}}Here two nested .span4
columns are placed within a .span8
.{{/i}}
{{_i}}To nest your content with the default grid, add a new .row
and set of .span*
columns within an existing .span*
column. Nested rows should include a set of columns that add up to the number of columns of its parent.{{/i}}
{{_i}}Here two nested .span4
columns are placed within a .span8
.{{/i}}
<div class="row"> <div class="span10"> @@ -167,54 +158,54 @@ </div> </div>- + - -
{{_i}}The fluid grid system uses percents instead of pixels for column widths. It has the same responsive capabilities as our fixed grid system, ensuring proper proportions for key screen resolutions and devices.{{/i}}
-{{_i}}The fluid grid system uses percents instead of pixels for column widths. It has the same responsive capabilities as our fixed grid system, ensuring proper proportions for key screen resolutions and devices.{{/i}}
+{{_i}}Make any row "fluid" by changing .row
to .row-fluid
. The column classes stay the exact same, making it easy to flip between fixed and fluid grids.{{/i}}
{{_i}}Make any row "fluid" by changing .row
to .row-fluid
. The column classes stay the exact same, making it easy to flip between fixed and fluid grids.{{/i}}
<div class="row-fluid"> <div class="span4">...</div> @@ -222,21 +213,21 @@ </div>-
{{_i}}Operates the same way as the fixed grid system offsetting: add .offset*
to any column to offset by that many columns.{{/i}}
{{_i}}Operates the same way as the fixed grid system offsetting: add .offset*
to any column to offset by that many columns.{{/i}}
<div class="row-fluid"> <div class="span4">...</div> @@ -244,21 +235,21 @@ </div>-
{{_i}}Nesting with fluid grids is a bit different: the number of nested columns should not match the parent's number of columns. Instead, each level of nested columns are reset because each row takes up 100% of the parent column.{{/i}}
-{{_i}}Nesting with fluid grids is a bit different: the number of nested columns should not match the parent's number of columns. Instead, each level of nested columns are reset because each row takes up 100% of the parent column.{{/i}}
<div class="row-fluid"> <div class="span12"> @@ -271,78 +262,78 @@ </div>- + - -
{{_i}}The default grid is built on a few variables for easy customization via LESS. All variables can be found in variables.less.{{/i}}
-{{_i}}Variable{{/i}} | -{{_i}}Default value{{/i}} | -{{_i}}Description{{/i}} | -
---|---|---|
@gridColumns |
- 12 | -{{_i}}Number of columns{{/i}} | -
@gridColumnWidth |
- 60px | -{{_i}}Width of each column{{/i}} | -
@gridGutterWidth |
- 20px | -{{_i}}Negative space between columns{{/i}} | -
@fluidGridColumnWidth |
- 6.382978723% | -{{_i}}Width of each fluid column{{/i}} | -
@fluidGridGutterWidth |
- 2.127659574% | -{{_i}}Negative space between fluid columns{{/i}} | -
{{_i}}The default grid is built on a few variables for easy customization via LESS. All variables can be found in variables.less.{{/i}}
+{{_i}}Variable{{/i}} | +{{_i}}Default value{{/i}} | +{{_i}}Description{{/i}} | +
---|---|---|
@gridColumns |
+ 12 | +{{_i}}Number of columns{{/i}} | +
@gridColumnWidth |
+ 60px | +{{_i}}Width of each column{{/i}} | +
@gridGutterWidth |
+ 20px | +{{_i}}Negative space between columns{{/i}} | +
@fluidGridColumnWidth |
+ 6.382978723% | +{{_i}}Width of each fluid column{{/i}} | +
@fluidGridGutterWidth |
+ 2.127659574% | +{{_i}}Negative space between fluid columns{{/i}} | +
{{_i}}Modifying the grid means changing the three @grid*
variables and recompiling Bootstrap. Change the grid variables in variables.less and use one of the four ways documented to recompile. If you're adding more columns, be sure to add the CSS for those in grid.less.{{/i}}
{{_i}}Modifying the grid means changing the three @grid*
variables and recompiling Bootstrap. Change the grid variables in variables.less and use one of the four ways documented to recompile. If you're adding more columns, be sure to add the CSS for those in grid.less.{{/i}}
{{_i}}Customization of the grid only works at the default level, the 940px grid. To maintain the responsive aspects of Bootstrap, you'll also have to manually customize the grids in responsive.less until a future update improves this.{{/i}}
+{{_i}}Customization of the grid only works at the default level, the 940px grid. To maintain the responsive aspects of Bootstrap, you'll also have to manually customize the grids in responsive.less until a future update improves this.{{/i}}
-{{_i}}Provides a common fixed-width (and optionally responsive) layout with only <div class="container">
required.{{/i}}
{{_i}}Provides a common fixed-width (and optionally responsive) layout with only <div class="container">
required.{{/i}}
<body> <div class="container"> @@ -351,12 +342,12 @@ </body>-
{{_i}}Create a fluid, two-column page with <div class="container-fluid">
—great for applications and docs.{{/i}}
{{_i}}Create a fluid, two-column page with <div class="container-fluid">
—great for applications and docs.{{/i}}
<div class="container-fluid"> <div class="row-fluid"> @@ -369,81 +360,81 @@ </div> </div>-
{{_i}}Turn on responsive CSS in your project by including the proper meta tag and additional stylesheet within the <head>
of your document. If you've compiled Bootstrap from the Customize page, you need only include the meta tag.{{/i}}
{{_i}}Turn on responsive CSS in your project by including the proper meta tag and additional stylesheet within the <head>
of your document. If you've compiled Bootstrap from the Customize page, you need only include the meta tag.{{/i}}
<meta name="viewport" content="width=device-width, initial-scale=1.0"> <link href="assets/css/bootstrap-responsive.css" rel="stylesheet">-
{{_i}}Heads up!{{/i}} {{_i}} Bootstrap doesn't include responsive features by default at this time as not everything needs to be responsive. Instead of encouraging developers to remove this feature, we figure it best to enable it as needed.{{/i}}
+{{_i}}Heads up!{{/i}} {{_i}} Bootstrap doesn't include responsive features by default at this time as not everything needs to be responsive. Instead of encouraging developers to remove this feature, we figure it best to enable it as needed.{{/i}}
- {{! About }} -{{_i}}Media queries allow for custom CSS based on a number of conditions—ratios, widths, display type, etc—but usually focuses around min-width
and max-width
.{{/i}}
{{_i}}Use media queries responsibly and only as a start to your mobile audiences. For larger projects, do consider dedicated code bases and not layers of media queries.{{/i}}
+ {{! About }} +{{_i}}Media queries allow for custom CSS based on a number of conditions—ratios, widths, display type, etc—but usually focuses around min-width
and max-width
.{{/i}}
{{_i}}Use media queries responsibly and only as a start to your mobile audiences. For larger projects, do consider dedicated code bases and not layers of media queries.{{/i}}
- {{! Supported }} -{{_i}}Bootstrap supports a handful of media queries in a single file to help make your projects more appropriate on different devices and screen resolutions. Here's what's included:{{/i}}
-{{_i}}Label{{/i}} | -{{_i}}Layout width{{/i}} | -{{_i}}Column width{{/i}} | -{{_i}}Gutter width{{/i}} | -
---|---|---|---|
{{_i}}Phones{{/i}} | -480px and below | -{{_i}}Fluid columns, no fixed widths{{/i}} | -|
{{_i}}Phones to tablets{{/i}} | -767px and below | -{{_i}}Fluid columns, no fixed widths{{/i}} | -|
{{_i}}Portrait tablets{{/i}} | -768px and above | -42px | -20px | -
{{_i}}Default{{/i}} | -980px and up | -60px | -20px | -
{{_i}}Large display{{/i}} | -1200px and up | -70px | -30px | -
{{_i}}Bootstrap supports a handful of media queries in a single file to help make your projects more appropriate on different devices and screen resolutions. Here's what's included:{{/i}}
+{{_i}}Label{{/i}} | +{{_i}}Layout width{{/i}} | +{{_i}}Column width{{/i}} | +{{_i}}Gutter width{{/i}} | +
---|---|---|---|
{{_i}}Phones{{/i}} | +480px and below | +{{_i}}Fluid columns, no fixed widths{{/i}} | +|
{{_i}}Phones to tablets{{/i}} | +767px and below | +{{_i}}Fluid columns, no fixed widths{{/i}} | +|
{{_i}}Portrait tablets{{/i}} | +768px and above | +42px | +20px | +
{{_i}}Default{{/i}} | +980px and up | +60px | +20px | +
{{_i}}Large display{{/i}} | +1200px and up | +70px | +30px | +
/* {{_i}}Landscape phones and down{{/i}} */ @media (max-width: 480px) { ... } @@ -459,79 +450,81 @@- {{! Responsive utility classes }} -
{{_i}}For faster mobile-friendly development, use these utility classes for showing and hiding content by device. Below is a table of the available classes and their effect on a given media query layout (labeled by device). They can be found in responsive.less
.{{/i}}
{{_i}}Class{{/i}} | -{{_i}}Phones 480px and below{{/i}} | -{{_i}}Tablets 767px and below{{/i}} | -{{_i}}Desktops 768px and above{{/i}} | -
---|---|---|---|
.visible-phone |
- {{_i}}Visible{{/i}} | -{{_i}}Hidden{{/i}} | -{{_i}}Hidden{{/i}} | -
.visible-tablet |
- {{_i}}Hidden{{/i}} | -{{_i}}Visible{{/i}} | -{{_i}}Hidden{{/i}} | -
.visible-desktop |
- {{_i}}Hidden{{/i}} | -{{_i}}Hidden{{/i}} | -{{_i}}Visible{{/i}} | -
.hidden-phone |
- {{_i}}Hidden{{/i}} | -{{_i}}Visible{{/i}} | -{{_i}}Visible{{/i}} | -
.hidden-tablet |
- {{_i}}Visible{{/i}} | -{{_i}}Hidden{{/i}} | -{{_i}}Visible{{/i}} | -
.hidden-desktop |
- {{_i}}Visible{{/i}} | -{{_i}}Visible{{/i}} | -{{_i}}Hidden{{/i}} | -
{{_i}}For faster mobile-friendly development, use these utility classes for showing and hiding content by device. Below is a table of the available classes and their effect on a given media query layout (labeled by device). They can be found in responsive.less
.{{/i}}
{{_i}}Class{{/i}} | +{{_i}}Phones 767px and below{{/i}} | +{{_i}}Tablets 979px to 768px{{/i}} | +{{_i}}Desktops Default{{/i}} | +
---|---|---|---|
.visible-phone |
+ {{_i}}Visible{{/i}} | +{{_i}}Hidden{{/i}} | +{{_i}}Hidden{{/i}} | +
.visible-tablet |
+ {{_i}}Hidden{{/i}} | +{{_i}}Visible{{/i}} | +{{_i}}Hidden{{/i}} | +
.visible-desktop |
+ {{_i}}Hidden{{/i}} | +{{_i}}Hidden{{/i}} | +{{_i}}Visible{{/i}} | +
.hidden-phone |
+ {{_i}}Hidden{{/i}} | +{{_i}}Visible{{/i}} | +{{_i}}Visible{{/i}} | +
.hidden-tablet |
+ {{_i}}Visible{{/i}} | +{{_i}}Hidden{{/i}} | +{{_i}}Visible{{/i}} | +
.hidden-desktop |
+ {{_i}}Visible{{/i}} | +{{_i}}Visible{{/i}} | +{{_i}}Hidden{{/i}} | +
{{_i}}Use on a limited basis and avoid creating entirely different versions of the same site. Instead, use them to complement each device's presentation.{{/i}}
+{{_i}}Use on a limited basis and avoid creating entirely different versions of the same site. Instead, use them to complement each device's presentation.{{/i}}
-{{_i}}Resize your browser or load on different devices to test the above classes.{{/i}}
-{{_i}}Green checkmarks indicate that class is visible in your current viewport.{{/i}}
-{{_i}}Here, green checkmarks indicate that class is hidden in your current viewport.{{/i}}
-{{_i}}Resize your browser or load on different devices to test the above classes.{{/i}}
+{{_i}}Green checkmarks indicate that class is visible in your current viewport.{{/i}}
+{{_i}}Here, green checkmarks indicate that class is hidden in your current viewport.{{/i}}
+