index.html 65.3 KB
Newer Older
Mark Otto's avatar
Mark Otto committed
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
      <h3>Alternate sizes</h3>
      <p>Fancy larger or smaller buttons? Have at it!</p>
      <div class="well">
        <a href="#" class="btn large primary">Primary action</a>
        <a href="#" class="btn large">Action</a>
      </div>
      <div class="well" style="padding: 16px 19px;">
        <a href="#" class="btn small primary">Primary action</a>
        <a href="#" class="btn small">Action</a>
      </div>
      <h3>Disabled state</h3>
      <p>For buttons that are not active or are disabled by the app for one reason or another, use the disabled state. That’s <code>.disabled</code> for links and <code>:disabled</code> for <code>&lt;button&gt;</code> elements.</p>
      <h4>Links</h4>
      <div class="well">
        <a href="#" class="btn large primary disabled">Primary action</a>
        <a href="#" class="btn large disabled">Action</a>
      </div>
      <h4>Buttons</h4>
      <div class="well">
1020
        <button class="btn large primary disabled" disabled="disabled">Primary action</button>&nbsp;<button class="btn large" disabled>Action</button>
Mark Otto's avatar
Mark Otto committed
1021
      </div>
1022
    </div>
1023
  </div><!-- /row -->
1024
1025
1026
1027
</section>



Mark Otto's avatar
Mark Otto committed
1028
1029
<!-- Navigation
================================================== -->
1030
<section id="navigation">
Mark Otto's avatar
Mark Otto committed
1031
1032
1033
1034
  <div class="page-header">
    <h1>Navigation</h1>
  </div>
  <h2>Fixed topbar</h2>
1035
  <div class="topbar-wrapper" style="z-index: 5;">
Mark Otto's avatar
Mark Otto committed
1036
    <div class="topbar">
1037
      <div class="topbar-inner">
1038
        <div class="container">
Jacob Thornton's avatar
Jacob Thornton committed
1039
          <h3><a href="#">Project Name</a></h3>
1040
          <ul class="nav">
Jacob Thornton's avatar
Jacob Thornton committed
1041
1042
1043
1044
            <li class="active"><a href="#">Home</a></li>
            <li><a href="#">Link</a></li>
            <li><a href="#">Link</a></li>
            <li><a href="#">Link</a></li>
Mark Otto's avatar
Mark Otto committed
1045
            <li class="dropdown">
1046
1047
              <a href="#" class="dropdown-toggle">Dropdown</a>
              <ul class="dropdown-menu">
1048
                <li><a href="#">Secondary link</a></li>
1049
1050
1051
1052
1053
                <li><a href="#">Something else here</a></li>
                <li class="divider"></li>
                <li><a href="#">Another link</a></li>
              </ul>
            </li>
Jacob Thornton's avatar
Jacob Thornton committed
1054
          </ul>
Mark Otto's avatar
Mark Otto committed
1055
          <form class="pull-left" action="">
Jacob Thornton's avatar
Jacob Thornton committed
1056
1057
1058
            <input type="text" placeholder="Search" />
          </form>
          <ul class="nav secondary-nav">
1059
1060
1061
            <li class="dropdown">
              <a href="#" class="dropdown-toggle">Dropdown</a>
              <ul class="dropdown-menu">
Jacob Thornton's avatar
Jacob Thornton committed
1062
1063
1064
1065
1066
1067
1068
1069
                <li><a href="#">Secondary link</a></li>
                <li><a href="#">Something else here</a></li>
                <li class="divider"></li>
                <li><a href="#">Another link</a></li>
              </ul>
            </li>
          </ul>
        </div>
1070
      </div><!-- /topbar-inner -->
1071
1072
    </div><!-- /topbar -->
  </div><!-- /topbar-wrapper -->
1073

Mark Otto's avatar
Mark Otto committed
1074
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1075
    <div class="span5">
1076
      <h4>What is it</h4>
1077
      <p>Our topbar is a fixed bar that houses a website’s logo or name, primary navigation, and search form.</p>
Mark Otto's avatar
Mark Otto committed
1078
    </div>
Mark Otto's avatar
Mark Otto committed
1079
    <div class="span5">
1080
1081
1082
      <h4>Customizable</h4>
      <p>All elements within, and the entire topbar as well, are optional. You can choose to include a logo/name, nav, search, and a secondary nav&mdash;or any combination of that.</p>
    </div>
Mark Otto's avatar
Mark Otto committed
1083
    <div class="span6">
1084
      <h4>Dropdowns included</h4>
1085
      <p>As part of the main navigation, we’ve included the ability for you to add dropdowns to your nav. Check out the secondary nav above (right aligned) to see how it’s done. Dropdowns <code>li</code> tags also support <code>.active</code> for showing current page selection.</p>
Mark Otto's avatar
Mark Otto committed
1086
1087
    </div>
  </div>
1088
  <p><strong>Note:</strong> When using the topbar on any page, be sure to account for the overlap it causes by adding <code>padding-top: 40px;</code> to your <code>body</code>.</p>
Mark Otto's avatar
Mark Otto committed
1089
1090

  <br />
1091

1092
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1093
    <div class="span4">
1094
1095
1096
1097
      <h2>Tabs and pills</h2>
      <p>Create simple secondary navigation with a <code>&lt;ul&gt;</code>. Swap between tabs or pills by adding the appropriate class.</p>
      <p>Great for sub-sections of content like our account settings pages and user timelines for toggling between pages of like content. Available in tabbed or pill styles.</p>
    </div>
Mark Otto's avatar
Mark Otto committed
1098
    <div class="span12">
1099
1100
1101
1102
1103
1104
      <ul class="tabs">
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
        <li><a href="#">Settings</a></li>
        <li><a href="#">Contact</a></li>
1105
1106
1107
1108
1109
1110
1111
1112
1113
        <li class="dropdown">
          <a href="#" class="dropdown-toggle">Dropdown</a>
          <ul class="dropdown-menu">
            <li><a href="#">Secondary link</a></li>
            <li><a href="#">Something else here</a></li>
            <li class="divider"></li>
            <li><a href="#">Another link</a></li>
          </ul>
        </li>
1114
      </ul>
1115
<pre class="prettyprint linenums">
1116
&lt;ul class="tabs"&gt;
Mark Otto's avatar
Mark Otto committed
1117
1118
1119
1120
1121
  &lt;li class="active"&gt;&lt;a href="#"&gt;Home&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Profile&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Messages&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Settings&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Contact&lt;/a&gt;&lt;/li&gt;
1122
1123
&lt;/ul&gt;
</pre>
1124
1125
1126
1127
1128
1129
1130
      <ul class="pills">
        <li class="active"><a href="#">Home</a></li>
        <li><a href="#">Profile</a></li>
        <li><a href="#">Messages</a></li>
        <li><a href="#">Settings</a></li>
        <li><a href="#">Contact</a></li>
      </ul>
1131
<pre class="prettyprint linenums">
1132
&lt;ul class="pills"&gt;
Mark Otto's avatar
Mark Otto committed
1133
1134
1135
1136
1137
  &lt;li class="active"&gt;&lt;a href="#"&gt;Home&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Profile&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Messages&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Settings&lt;/a&gt;&lt;/li&gt;
  &lt;li&gt;&lt;a href="#"&gt;Contact&lt;/a&gt;&lt;/li&gt;
1138
1139
1140
&lt;/ul&gt;
</pre>
    </div>
1141
  </div><!-- /row -->
1142

Mark Otto's avatar
Mark Otto committed
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
  <!-- Breadcrumbs -->
  <div class="row">
    <div class="span4">
      <h2>Breadcrumbs</h2>
      <p>Breadcrumb navigation is used as a way to show users where they are within an app or a site, but not for primary navigation.</p>
    </div>
    <div class="span12">
      <ul class="breadcrumb">
        <li class="active">Home</li>
      </ul>
      <ul class="breadcrumb">
        <li><a href="#">Home</a> <span class="divider">/</span></li>
        <li class="active">Middle page</li>
      </ul>
      <ul class="breadcrumb">
        <li><a href="#">Home</a> <span class="divider">/</span></li>
        <li><a href="#">Middle page</a> <span class="divider">/</span></li>
        <li class="active">Another one</li>
      </ul>
      <ul class="breadcrumb">
        <li><a href="#">Home</a> <span class="divider">/</span></li>
        <li><a href="#">Middle page</a> <span class="divider">/</span></li>
        <li><a href="#">Another one</a> <span class="divider">/</span></li>
        <li class="active">You are here</li>
      </ul>
    </div>
  </div>

1171
1172
  <!-- Pagination -->
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1173
    <div class="span4">
1174
1175
      <h2>Pagination</h2>
      <p>Ultra simplistic and minimally styled pagination inspired by Rdio. The large block is hard to miss, easily scalable, and provides large click areas.</p>
1176
    </div>
Mark Otto's avatar
Mark Otto committed
1177
    <div class="span12">
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
      <div class="pagination">
        <ul>
          <li class="prev disabled"><a href="#">&larr; Previous</a></li>
          <li class="active"><a href="#">1</a></li>
          <li><a href="#">2</a></li>
          <li><a href="#">3</a></li>
          <li><a href="#">4</a></li>
          <li><a href="#">5</a></li>
          <li class="next"><a href="#">Next &rarr;</a></li>
        </ul>
      </div>
      <div class="pagination">
        <ul>
          <li class="prev"><a href="#">&larr; Previous</a></li>
          <li class="active"><a href="#">10</a></li>
          <li><a href="#">11</a></li>
          <li><a href="#">12</a></li>
          <li class="disabled"><a href="#"></a></li>
          <li><a href="#">19</a></li>
          <li><a href="#">20</a></li>
          <li><a href="#">21</a></li>
          <li class="next"><a href="#">Next &rarr;</a></li>
        </ul>
      </div>
      <div class="pagination">
        <ul>
          <li class="prev"><a href="#">&larr; Previous</a></li>
          <li><a href="#">10</a></li>
          <li><a href="#">11</a></li>
          <li><a href="#">12</a></li>
          <li><a href="#">13</a></li>
          <li><a href="#">14</a></li>
          <li class="active"><a href="#">15</a></li>
          <li><a href="#">16</a></li>
          <li><a href="#">17</a></li>
          <li><a href="#">18</a></li>
          <li><a href="#">19</a></li>
          <li><a href="#">20</a></li>
          <li class="next"><a href="#">Next &rarr;</a></li>
        </ul>
      </div>
1219
<pre class="prettyprint linenums">
1220
1221
&lt;div class="pagination"&gt;
  &lt;ul&gt;
Mark Otto's avatar
Mark Otto committed
1222
1223
1224
1225
1226
1227
1228
    &lt;li class="prev disabled"&gt;&lt;a href="#"&gt;&amp;larr; Previous&lt;/a&gt;&lt;/li>
    &lt;li class="active"&gt;&lt;a href="#"&gt;1&lt;/a&gt;&lt;/li&gt;
    &lt;li&gt;&lt;a href="#"&gt;2&lt;/a&gt;&lt;/li&gt;
    &lt;li&gt;&lt;a href="#"&gt;3&lt;/a&gt;&lt;/li&gt;
    &lt;li&gt;&lt;a href="#"&gt;4&lt;/a&gt;&lt;/li&gt;
    &lt;li&gt;&lt;a href="#"&gt;5&lt;/a&gt;&lt;/li&gt;
    &lt;li class="next"&gt;&lt;a href="#"&gt;Next &amp;rarr;&lt;/a&gt;&lt;/li>
1229
1230
1231
  &lt;/ul&gt;
&lt;/div&gt;
</pre>
1232
    </div>
1233
  </div><!-- /row -->
1234
1235
1236
1237
1238

</section>



Mark Otto's avatar
Mark Otto committed
1239
1240
<!-- Alerts & Messages
================================================== -->
1241
1242
<section id="alerts">
  <div class="page-header">
1243
1244
    <h1>Alerts &amp; Errors <small>Styles for success, warning, and error messages or alerts</small></h1>
  </div>
1245
  <!-- Basic alert messages -->
1246
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1247
    <div class="span4">
1248
      <h2>Basic alerts</h2>
1249
      <p><code>div.alert-message</code></p>
1250
1251
      <p>One-line messages for highlighting the failure, possible failure, or success of an action. Particularly useful for forms.</p>
    </div>
Mark Otto's avatar
Mark Otto committed
1252
    <div class="span12">
1253
1254
      <div class="alert-message warning">
        <a class="close" href="#">&times;</a>
1255
        <p><strong>Holy guacamole!</strong> Best check yo self, you’re not looking too good.</p>
1256
      </div>
1257
      <div class="alert-message error">
1258
        <a class="close" href="#">&times;</a>
1259
        <p><strong>Oh snap!</strong> Change this and that and try again.</p>
1260
1261
1262
1263
1264
1265
1266
      </div>
      <div class="alert-message success">
        <a class="close" href="#">&times;</a>
        <p><strong>Well done!</strong> You successfully read this alert message.</p>
      </div>
      <div class="alert-message info">
        <a class="close" href="#">&times;</a>
1267
        <p><strong>Heads up!</strong> This is an alert that needs your attention, but it’s not a huge priority just yet.</p>
1268
1269
      </div>
    </div>
1270
  </div><!-- /row -->
1271
  <!-- Block messages -->
1272
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1273
    <div class="span4">
1274
      <h2>Block messages</h2>
1275
      <p><code>div.alert-message.block-message</code></p>
1276
1277
      <p>For messages that require a bit of explanation, we have paragraph style alerts. These are perfect for bubbling up longer error messages, warning a user of a pending action, or just presenting information for more emphasis on the page.</p>
    </div>
Mark Otto's avatar
Mark Otto committed
1278
    <div class="span12">
1279
1280
      <div class="alert-message block-message warning">
        <a class="close" href="#">&times;</a>
1281
        <p><strong>Holy guacamole! This is a warning!</strong> 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.</p>
1282
1283
1284
        <div class="alert-actions">
          <a class="btn small" href="#">Take this action</a> <a class="btn small" href="#">Or do this</a>
        </div>
1285
      </div>
1286
      <div class="alert-message block-message error">
1287
        <a class="close" href="#">&times;</a>
1288
1289
1290
1291
1292
1293
        <p><strong>Oh snap! You got an error!</strong> Change this and that and try again.</p>
        <ul>
          <li>Duis mollis est non commodo luctus</li>
          <li>Nisi erat porttitor ligula</li>
          <li>Eget lacinia odio sem nec elit</li>
        </ul>
1294
1295
1296
        <div class="alert-actions">
          <a class="btn small" href="#">Take this action</a> <a class="btn small" href="#">Or do this</a>
        </div>
1297
1298
1299
1300
      </div>
      <div class="alert-message block-message success">
        <a class="close" href="#">&times;</a>
        <p><strong>Well done!</strong> You successfully read this alert message. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Maecenas faucibus mollis interdum.</p>
1301
1302
1303
        <div class="alert-actions">
          <a class="btn small" href="#">Take this action</a> <a class="btn small" href="#">Or do this</a>
        </div>
1304
1305
1306
      </div>
      <div class="alert-message block-message info">
        <a class="close" href="#">&times;</a>
1307
        <p><strong>Heads up!</strong> This is an alert that needs your attention, but it’s not a huge priority just yet.</p>
1308
1309
1310
        <div class="alert-actions">
          <a class="btn small" href="#">Take this action</a> <a class="btn small" href="#">Or do this</a>
        </div>
1311
1312
      </div>
    </div>
1313
  </div><!-- /row -->
1314
1315
1316
</section>


Mark Otto's avatar
Mark Otto committed
1317
1318
<!-- Popovers
================================================== -->
Mark Otto's avatar
Mark Otto committed
1319
<section id="popovers">
Jacob Thornton's avatar
Jacob Thornton committed
1320
  <div class="page-header">
Mark Otto's avatar
Mark Otto committed
1321
    <h1>Popovers <small>Components for displaying content in modals, tooltips, and popovers</small></h1>
Jacob Thornton's avatar
Jacob Thornton committed
1322
1323
  </div>
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1324
    <div class="span4">
Mark Otto's avatar
Mark Otto committed
1325
      <h2>Modals</h2>
1326
      <p>Modals&mdash;dialogs or lightboxes&mdash;are great for contextual actions in situations where it’s important that the background context be maintained.</p>
Jacob Thornton's avatar
Jacob Thornton committed
1327
    </div>
Mark Otto's avatar
Mark Otto committed
1328
    <div class="span12">
Jacob Thornton's avatar
Jacob Thornton committed
1329
      <div class="well" style="background-color: #888; border: none; padding: 40px;">
1330
        <!-- Modal -->
1331
        <div class="modal" style="position: relative; top: auto; left: auto; margin: 0 auto; z-index: 1">
Jacob Thornton's avatar
Jacob Thornton committed
1332
1333
          <div class="modal-header">
            <a href="#" class="close">&times;</a>
1334
            <h3>Modal Heading</h3>
Jacob Thornton's avatar
Jacob Thornton committed
1335
1336
          </div>
          <div class="modal-body">
1337
            <p>One fine body…</p>
Jacob Thornton's avatar
Jacob Thornton committed
1338
1339
          </div>
          <div class="modal-footer">
Mark Otto's avatar
Mark Otto committed
1340
            <a href="#" class="btn secondary">Secondary</a>
Mark Otto's avatar
Mark Otto committed
1341
            <a href="#" class="btn primary">Primary</a>
Jacob Thornton's avatar
Jacob Thornton committed
1342
1343
1344
          </div>
        </div>
      </div>
1345
    </div>
1346
  </div><!-- /row -->
1347

1348
  <!-- Tooltips -->
1349
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1350
    <div class="span4">
1351
1352
1353
      <h2>Tool Tips</h2>
      <p>Twipsies are super useful for aiding a confused user and pointing them in the right direction.</p>
    </div>
Mark Otto's avatar
Mark Otto committed
1354
    <div class="span12">
1355
1356
1357
      <div class="twipsies well">
        <div style="position: relative">
          <p class="muted" style="margin-bottom: 0">
Jacob Thornton's avatar
Jacob Thornton committed
1358
Lorem ipsum dolar sit amet illo error <a href="#" title="below">ipsum</a> veritatis aut iste perspiciatis iste voluptas natus illo quasi odit aut natus consequuntur consequuntur, aut natus illo voluptatem odit perspiciatis laudantium rem doloremque totam voluptas. <a href="#" title="right">Voluptasdicta</a> eaque beatae aperiam ut enim voluptatem explicabo explicabo, voluptas quia odit fugit accusantium totam totam architecto explicabo sit quasi fugit fugit, totam doloremque unde sunt <a href="#" title="left">sed</a> dicta quae accusantium fugit voluptas nemo voluptas voluptatem <a href="#" title="above">rem</a> quae aut veritatis quasi quae.
1359
          </p>
Jacob Thornton's avatar
Jacob Thornton committed
1360
1361
1362
        </div>
      </div>
    </div>
1363
  </div><!-- /row -->
Jacob Thornton's avatar
Jacob Thornton committed
1364

1365
  <!-- Popovers -->
Mark Otto's avatar
Mark Otto committed
1366
  <div class="row">
Mark Otto's avatar
Mark Otto committed
1367
    <div class="span4">
Mark Otto's avatar
Mark Otto committed
1368
      <h2>Popovers</h2>
Mark Otto's avatar
Mark Otto committed
1369
      <p>Use popovers to provide subtextual information to a page without affecting layout.</p>
Mark Otto's avatar
Mark Otto committed
1370
    </div>
Mark Otto's avatar
Mark Otto committed
1371
    <div class="span12">
Mark Otto's avatar
Mark Otto committed
1372
      <div class="well popover-well">
Jacob Thornton's avatar
Jacob Thornton committed
1373
1374
         <div class="popover-wrapper">
          <div class="popover left">
Mark Otto's avatar
Mark Otto committed
1375
1376
            <div class="arrow"></div>
            <div class="inner">
Jacob Thornton's avatar
Jacob Thornton committed
1377
              <h3 class="title">Popover Title</h3>
Mark Otto's avatar
Mark Otto committed
1378
1379
1380
1381
1382
              <div class="content">
                <p>Etiam porta sem malesuada magna mollis euismod. Maecenas faucibus mollis interdum. Morbi leo risus, porta ac consectetur ac, vestibulum at eros.</p>
              </div>
            </div>
          </div>
1383
          <img class="large-bird" src="assets/img/bird.png" width="220px" height="145px">
Mark Otto's avatar
Mark Otto committed
1384
1385
1386
        </div>
      </div>
    </div>
1387
  </div><!-- /row -->
Jacob Thornton's avatar
Jacob Thornton committed
1388
</section>
1389

Mark Otto's avatar
Mark Otto committed
1390

1391
1392
1393
1394
1395
1396
1397
1398
<!-- Using Javascript w/ Bootstrap
 ================================================== -->

 <section id="javascript">
   <div class="page-header">
     <h1>Using Javascript with Bootstrap <small>An index of plugins to get you started</small></h1>
   </div>
   <div class="row">
Mark Otto's avatar
Mark Otto committed
1399
     <div class="span4">
1400
1401
       <p>Integrating javascript with the Bootstrap library is super easy. Below we go over the basics and provide you with some awesome plugins to get you started!</p>
     </div>
Mark Otto's avatar
Mark Otto committed
1402
     <div class="span12">
1403
1404
1405
       <h2>Getting started</h2>
       <p>We've set out to make your interactive work with Bootstrap even more simple, offering several lightweight plugins for things like modals, tooltips, and other dynamic components. These plugins have been coded up to work with either <a href="http://jquery.com/" target="_blank">jQuery</a> or <a href="http://ender.no.de" target="_blank">Ender</a>, but we encourage you to extend and modify them to fit your development needs!</p>
       <h2>Do I need javascript?</h2>
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
       <p>The short answer is <strong>no</strong>... of course not! However, for those who need it, we've provided the plugins below to help you understand how to integrate bootstrap with javascript and to give you a quick lightweight option for dropping something in and getting the basic functionality right away! For more information on these plugins and to see demos of them in action, please refer to our <a href="./javascript.html">plugin documentation page</a>.</p>
       <table class="zebra-striped">
         <thead>
           <tr>
             <th style="width: 150px;">File</th>
             <th>Description</th>
           </tr>
         </thead>
         <tbody>
           <tr>
             <td><a href="./javascript.html#modal">bootstrap-modal.js</a></td>
             <td>Our Modal plugin is a <strong>super</strong> slim take on the traditional modal js plugin! We took special care to include only the bare functionality that we require at twitter.</td>
           </tr>
           <tr>
             <td><a href="./javascript.html#alerts">bootstrap-alerts.js</a></td>
             <td>The alert plugin is a super tiny class for adding close functionality to alerts.</td>
           </tr>
           <tr>
             <td><a href="./javascript.html#dropdowns">bootstrap-dropdown.js</a></td>
1425
             <td>This plugin is for adding dropdowns to the bootstrap topbar or tabbed navigations.</td>
1426
           </tr>
1427
1428
           <tr>
             <td><a href="./javascript.html#tabs">bootstrap-tabs.js</a></td>
1429
             <td>This plugin adds quick, dynamic tab and pill functionality for cycling through local content.</td>
1430
           </tr>
1431
1432
           <tr>
             <td><a href="./javascript.html#twipsy">bootstrap-twipsy.js</a></td>
1433
             <td>Based on the excellent jQuery.tipsy plugin written by Jason Frame; twipsy is an updated version, which doesn't rely on images, uses css3 for animations, and data-attributes for local title storage!</td>
1434
1435
1436
1437
1438
1439
1440
           </tr>
           <tr>
             <td><a href="./javascript.html#popover">bootstrap-popover.js</a></td>
             <td>The popover plugin provides a simple interface for adding popovers to your application. It extends the <a href="#twipsy">boostrap-twipsy.js</a> plugin, so be sure to grab that file as well when including popovers in your project!</td>
           </tr>
         </tbody>
       </table>
1441
1442
1443
     </div>
   </div>

Mark Otto's avatar
Mark Otto committed
1444

Mark Otto's avatar
Mark Otto committed
1445
1446
<!-- Using Bootstrap w/ Less
================================================== -->
1447
<section id="less">
Mark Otto's avatar
Mark Otto committed
1448
<div class="page-header">
1449
  <h1>Using Bootstrap with Less <small>Supercharge your CSS with variables, mixins, and functions</small></h1>
Mark Otto's avatar
Mark Otto committed
1450
1451
</div>
<div class="row">
Mark Otto's avatar
Mark Otto committed
1452
  <div class="span4">
1453
1454
    <p>Bootstrap was built with <a href="http://markdotto.com/bootstrap/">Preboot</a>, an open-source pack of mixins and variables to be used in conjunction with <a href="http://lesscss.org" target="_blank">Less</a>, a CSS preprocessor for faster and easier web development.</p>
    <p>Check out how we used Preboot in Bootstrap and how you can make use of it should you choose to run Less on your next project.</p>
Mark Otto's avatar
Mark Otto committed
1455
  </div>
Mark Otto's avatar
Mark Otto committed
1456
  <div class="span12">
Mark Otto's avatar
Mark Otto committed
1457
    <h2>How to use it</h2>
1458
    <p>Use this option to make full use of Bootstrap’s Less variables, mixins, and nesting in CSS via javascript in your browser.</p>
1459
<pre class="prettyprint linenums">
Jacob Thornton's avatar
Jacob Thornton committed
1460
&lt;link rel="stylesheet/less" href="less/bootstrap.less" media="all" /&gt;
Mark Otto's avatar
Mark Otto committed
1461
&lt;script src="js/less-1.1.3.min.js"&gt;&lt;/script&gt;</pre>
1462
<p>Not feeling the .js solution? <a href="http://incident57.com/less" target="_blank">Try the Less Mac app</a> or <a href="http://lesscss.org/#-client-side-usage" target="_blank">use Node.js</a> to compile when you deploy your code.</p>
Mark Otto's avatar
Mark Otto committed
1463

1464
1465
    <h2>What’s included</h2>
    <p>Here are some of the highlights of what’s included in Twitter Bootstrap as part of Bootstrap. Head over to the Bootstrap website or Github project page to download and learn more.</p>
1466
    <h3>Variables</h3>
1467
    <p>Variables in Less are perfect for maintaining and updating your CSS headache free. When you want to change a color value or a frequently used value, update it in one spot and you’re set.</p>
1468
<pre class="prettyprint linenums">
Mark Otto's avatar
Mark Otto committed
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
// Links
@linkColor:         #8b59c2;
@linkColorHover:    darken(@linkColor, 10);

// Grays
@black:             #000;
@grayDark:          lighten(@black, 25%);
@gray:              lighten(@black, 50%);
@grayLight:         lighten(@black, 70%);
@grayLighter:       lighten(@black, 90%);
@white:             #fff;

// Accent Colors
@blue:              #08b5fb;
@green:             #46a546;
@red:               #9d261d;
@yellow:            #ffc40d;
@orange:            #f89406;
@pink:              #c3325f;
@purple:            #7a43b6;

1490
1491
1492
// Baseline grid
@basefont:          13px;
@baseline:          18px;
Mark Otto's avatar
Mark Otto committed
1493
1494
1495
</pre>

<h3>Commenting</h3>
1496
<p>Less also provides another style of commenting in addition to CSS’s normal <code>/* ... */</code> syntax.</p>
1497
<pre class="prettyprint linenums">
Mark Otto's avatar
Mark Otto committed
1498
1499
1500
1501
1502
// This is a comment
/* This is also a comment */
</pre>

<h3>Mixins up the wazoo</h3>
1503
<p>Mixins are basically includes or partials for CSS, allowing you to combine a block of code into one. They’re great for vendor prefixed properties like <code>box-shadow</code>, cross-browser gradients, font stacks, and more. Below is a sample of the mixins that are included with Bootstrap.</p>
Mark Otto's avatar
Mark Otto committed
1504
<h4>Font stacks</h4>
1505
<pre class="prettyprint linenums">
Mark Otto's avatar
Mark Otto committed
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
#font {
  .shorthand(@weight: normal, @size: 14px, @lineHeight: 20px) {
    font-size: @size;
    font-weight: @weight;
    line-height: @lineHeight;
  }
  .sans-serif(@weight: normal, @size: 14px, @lineHeight: 20px) {
    font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
    font-size: @size;
    font-weight: @weight;
    line-height: @lineHeight;
  }
  .serif(@weight: normal, @size: 14px, @lineHeight: 20px) {
    font-family: "Georgia", Times New Roman, Times, sans-serif;
    font-size: @size;
    font-weight: @weight;
    line-height: @lineHeight;
  }
  .monospace(@weight: normal, @size: 12px, @lineHeight: 20px) {
    font-family: "Monaco", Courier New, monospace;
    font-size: @size;
    font-weight: @weight;
    line-height: @lineHeight;
  }
}
</pre>
<h4>Gradients</h4>
1533
<pre class="prettyprint linenums">
Mark Otto's avatar
Mark Otto committed
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
#gradient {
  .horizontal (@startColor: #555, @endColor: #333) {
    background-color: @endColor;
    background-repeat: repeat-x;
    background-image: -khtml-gradient(linear, left top, right top, from(@startColor), to(@endColor)); // Konqueror
    background-image: -moz-linear-gradient(left, @startColor, @endColor); // FF 3.6+
    background-image: -ms-linear-gradient(left, @startColor, @endColor); // IE10
    background-image: -webkit-gradient(linear, left top, right top, color-stop(0%, @startColor), color-stop(100%, @endColor)); // Safari 4+, Chrome 2+
    background-image: -webkit-linear-gradient(left, @startColor, @endColor); // Safari 5.1+, Chrome 10+
    background-image: -o-linear-gradient(left, @startColor, @endColor); // Opera 11.10
    background-image: linear-gradient(left, @startColor, @endColor); // Le standard
  }
  .vertical (@startColor: #555, @endColor: #333) {
    background-color: @endColor;
    background-repeat: repeat-x;
1549
1550
1551
1552
1553
1554
1555
    background-image: -khtml-gradient(linear, left top, left bottom, from(@startColor), to(@endColor)); // Konqueror
    background-image: -moz-linear-gradient(@startColor, @endColor); // FF 3.6+
    background-image: -ms-linear-gradient(@startColor, @endColor); // IE10
    background-image: -webkit-gradient(linear, left top, left bottom, color-stop(0%, @startColor), color-stop(100%, @endColor)); // Safari 4+, Chrome 2+
    background-image: -webkit-linear-gradient(@startColor, @endColor); // Safari 5.1+, Chrome 10+
    background-image: -o-linear-gradient(@startColor, @endColor); // Opera 11.10
    background-image: linear-gradient(@startColor, @endColor); // The standard
Mark Otto's avatar
Mark Otto committed
1556
1557
1558
1559
  }
  .directional (@startColor: #555, @endColor: #333, @deg: 45deg) {
    ...
  }
1560
  .vertical-three-colors(@startColor: #00b3ee, @midColor: #7a43b6, @colorStop: 50%, @endColor: #c3325f) {
Mark Otto's avatar
Mark Otto committed
1561
1562
1563
1564
1565
1566
    ...
  }
}
</pre>

<h3>Operations and grid system</h3>
1567
<p>Get fancy and perform some math to generate flexible and powerful mixins like the one below.</p>
1568
<pre class="prettyprint linenums">
Mark Otto's avatar
Mark Otto committed
1569
1570
1571
1572
// Griditude
@gridColumns:       16;
@gridColumnWidth:   40px;
@gridGutterWidth:   20px;
1573
@siteWidth:         (@gridColumns * @gridColumnWidth) + (@gridGutterWidth * (@gridColumns - 1));
Mark Otto's avatar
Mark Otto committed
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584

// Grid System
.container {
  width: @siteWidth;
  margin: 0 auto;
  .clearfix();
}
.columns(@columnSpan: 1) {
  width: (@gridColumnWidth * @columnSpan) + (@gridGutterWidth * (@columnSpan - 1));
}
.offset(@columnOffset: 1) {
1585
  margin-left: (@gridColumnWidth * @columnOffset) + (@gridGutterWidth * (@columnOffset - 1)) + @extraSpace;
Mark Otto's avatar
Mark Otto committed
1586
1587
1588
1589
1590
1591
1592
}
</pre>
  </div>
</div>

</section>

1593
    </div><!-- /container -->
1594
1595
1596
1597

    <div id="footer">
      <div class="inner">
        <div class="container">
1598
          <p class="right"><a href="#">Back to top</a></p>
1599
          <p>
1600
            Designed and built with all the love in the world <a href="http://twitter.com/twitter" target="_blank">@twitter</a> by <a href="http://twitter.com/mdo" target="_blank">@mdo</a> and <a href="http://twitter.com/fat" target="_blank">@fat</a>.<br />
Mark Otto's avatar
Mark Otto committed
1601
            Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="_blank">Apache License v2.0</a>.
1602
          </p>
1603
1604
        </div>
      </div>
1605
1606
1607
    </div>

  </body>
1608
</html>
For faster browsing, not all history is shown. View entire blame