customize.html 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385
  1. ---
  2. layout: default
  3. title: Customize and download
  4. slug: customize
  5. lead: Customize Bootstrap's components, Less variables, and jQuery plugins to get your very own version.
  6. ---
  7. <!-- less.js isn't IE8-compatible and throws an exception during initialization, so our Blob compatibility check and error messaging code never get called in that case.
  8. So we use a conditional comment instead to inform folks about the lack of IE8 support.
  9. -->
  10. <!--[if lt IE 9]>
  11. <style>
  12. .bs-customizer,
  13. .bs-customizer-import,
  14. .bs-docs-sidebar {
  15. display: none;
  16. }
  17. </style>
  18. <div class="alert alert-danger">
  19. <strong>The Bootstrap Customizer does not support IE9 and below.</strong><br>
  20. Please take a second to <a href="http://browsehappy.com/">upgrade to a more modern browser</a>.
  21. </div>
  22. <![endif]-->
  23. <!-- Customizer form -->
  24. <div id="defaults-change-alert" class="alert alert-warning alert-dismissible" role="alert">
  25. <button type="button" class="close" data-dismiss="alert" aria-label="Close"><span aria-hidden="true">&times;</span></button>
  26. <strong>Heads up!</strong> The default value for <code>@brand-primary</code> has changed in the latest release to improve contrast and accessibility. Please double check your compiled CSS when upgrading.
  27. </div>
  28. <div class="bs-docs-section bs-customizer-import">
  29. <div id="import-drop-target" class="bs-dropzone">
  30. <div class="import-header">
  31. <span class="glyphicon glyphicon-download-alt" aria-hidden="true"></span>
  32. </div>
  33. <p class="lead">Have an existing configuration? Upload your <code>config.json</code> to import it.</p>
  34. <p>Drag and drop here, or <label id="import-manual-trigger" class="btn-link">manually upload<input type="file" id="import-file-select" class="hidden"></label>.</p>
  35. <hr>
  36. <p><strong>Don't have one?</strong> That's okay—just start customizing the fields below.</p>
  37. </div>
  38. </div>
  39. <form class="bs-customizer">
  40. <div class="bs-docs-section" id="less-section">
  41. <button class="btn btn-default toggle" type="button">Toggle all</button>
  42. <h1 id="less" class="page-header">Less files</h1>
  43. <p class="lead">Choose which Less files to compile into your custom build of Bootstrap. Not sure which files to use? Read through the <a href="../css/">CSS</a> and <a href="../components/">Components</a> pages in the docs.</p>
  44. <div class="row">
  45. <div class="col-xs-6 col-sm-4">
  46. <h3>Common CSS</h3>
  47. <div class="checkbox">
  48. <label>
  49. <input type="checkbox" checked value="print.less">
  50. Print media styles
  51. </label>
  52. </div>
  53. <div class="checkbox">
  54. <label>
  55. <input type="checkbox" checked value="type.less">
  56. Typography
  57. </label>
  58. </div>
  59. <div class="checkbox">
  60. <label>
  61. <input type="checkbox" checked value="code.less">
  62. Code
  63. </label>
  64. </div>
  65. <div class="checkbox">
  66. <label>
  67. <input type="checkbox" checked value="grid.less">
  68. Grid system
  69. </label>
  70. </div>
  71. <div class="checkbox">
  72. <label>
  73. <input type="checkbox" checked value="tables.less">
  74. Tables
  75. </label>
  76. </div>
  77. <div class="checkbox">
  78. <label>
  79. <input type="checkbox" checked value="forms.less" data-dependents="navbar.less,input-groups.less">
  80. Forms
  81. </label>
  82. </div>
  83. <div class="checkbox">
  84. <label>
  85. <input type="checkbox" checked value="buttons.less" data-dependents="button-groups.less">
  86. Buttons
  87. </label>
  88. </div>
  89. <div class="checkbox">
  90. <label>
  91. <input type="checkbox" checked value="responsive-utilities.less">
  92. Responsive utilities
  93. </label>
  94. </div>
  95. </div><!-- .col-xs-6 .col-sm-4 -->
  96. <div class="col-xs-6 col-sm-4">
  97. <h3>Components</h3>
  98. <div class="checkbox">
  99. <label>
  100. <input type="checkbox" checked value="glyphicons.less">
  101. Glyphicons
  102. </label>
  103. </div>
  104. <div class="checkbox">
  105. <label>
  106. <input type="checkbox" checked value="button-groups.less" data-dependencies="buttons.less">
  107. Button groups
  108. </label>
  109. </div>
  110. <div class="checkbox">
  111. <label>
  112. <input type="checkbox" checked value="input-groups.less" data-dependencies="forms.less">
  113. Input groups
  114. </label>
  115. </div>
  116. <div class="checkbox">
  117. <label>
  118. <input type="checkbox" checked value="navs.less" data-dependents="navbar.less">
  119. Navs
  120. </label>
  121. </div>
  122. <div class="checkbox">
  123. <label>
  124. <input type="checkbox" checked value="navbar.less" data-dependencies="forms.less,navs.less">
  125. Navbar
  126. </label>
  127. </div>
  128. <div class="checkbox">
  129. <label>
  130. <input type="checkbox" checked value="breadcrumbs.less">
  131. Breadcrumbs
  132. </label>
  133. </div>
  134. <div class="checkbox">
  135. <label>
  136. <input type="checkbox" checked value="pagination.less">
  137. Pagination
  138. </label>
  139. </div>
  140. <div class="checkbox">
  141. <label>
  142. <input type="checkbox" checked value="pager.less">
  143. Pager
  144. </label>
  145. </div>
  146. <div class="checkbox">
  147. <label>
  148. <input type="checkbox" checked value="labels.less">
  149. Labels
  150. </label>
  151. </div>
  152. <div class="checkbox">
  153. <label>
  154. <input type="checkbox" checked value="badges.less">
  155. Badges
  156. </label>
  157. </div>
  158. <div class="checkbox">
  159. <label>
  160. <input type="checkbox" checked value="jumbotron.less">
  161. Jumbotron
  162. </label>
  163. </div>
  164. <div class="checkbox">
  165. <label>
  166. <input type="checkbox" checked value="thumbnails.less">
  167. Thumbnails
  168. </label>
  169. </div>
  170. <div class="checkbox">
  171. <label>
  172. <input type="checkbox" checked value="alerts.less">
  173. Alerts
  174. </label>
  175. </div>
  176. <div class="checkbox">
  177. <label>
  178. <input type="checkbox" checked value="progress-bars.less">
  179. Progress bars
  180. </label>
  181. </div>
  182. <div class="checkbox">
  183. <label>
  184. <input type="checkbox" checked value="media.less">
  185. Media items
  186. </label>
  187. </div>
  188. <div class="checkbox">
  189. <label>
  190. <input type="checkbox" checked value="list-group.less">
  191. List groups
  192. </label>
  193. </div>
  194. <div class="checkbox">
  195. <label>
  196. <input type="checkbox" checked value="panels.less">
  197. Panels
  198. </label>
  199. </div>
  200. <div class="checkbox">
  201. <label>
  202. <input type="checkbox" checked value="responsive-embed.less">
  203. Responsive embed
  204. </label>
  205. </div>
  206. <div class="checkbox">
  207. <label>
  208. <input type="checkbox" checked value="wells.less">
  209. Wells
  210. </label>
  211. </div>
  212. <div class="checkbox">
  213. <label>
  214. <input type="checkbox" checked value="close.less">
  215. Close icon
  216. </label>
  217. </div>
  218. </div><!-- .col-xs-6 .col-sm-4 -->
  219. <div class="col-xs-6 col-sm-4">
  220. <h3>JavaScript components</h3>
  221. <div class="checkbox">
  222. <label>
  223. <input type="checkbox" checked value="component-animations.less">
  224. Component animations (for JS)<br>
  225. (includes Collapse)
  226. </label>
  227. </div>
  228. <div class="checkbox">
  229. <label>
  230. <input type="checkbox" checked value="dropdowns.less">
  231. Dropdown
  232. </label>
  233. </div>
  234. <div class="checkbox">
  235. <label>
  236. <input type="checkbox" checked value="tooltip.less">
  237. Tooltip
  238. </label>
  239. </div>
  240. <div class="checkbox">
  241. <label>
  242. <input type="checkbox" checked value="popovers.less">
  243. Popover
  244. </label>
  245. </div>
  246. <div class="checkbox">
  247. <label>
  248. <input type="checkbox" checked value="modals.less">
  249. Modal
  250. </label>
  251. </div>
  252. <div class="checkbox">
  253. <label>
  254. <input type="checkbox" checked value="carousel.less">
  255. Carousel
  256. </label>
  257. </div>
  258. </div><!-- .col-xs-6 .col-sm-4 -->
  259. </div><!-- /.row -->
  260. </div>
  261. <div class="bs-docs-section" id="plugin-section">
  262. <button class="btn btn-default toggle" type="button">Toggle all</button>
  263. <h1 id="plugins" class="page-header">jQuery plugins</h1>
  264. <p class="lead">Choose which jQuery plugins should be included in your custom JavaScript files. Unsure what to include? Read the <a href="../javascript/">JavaScript</a> page in the docs.</p>
  265. <div class="row">
  266. <div class="col-lg-6">
  267. <h4>Linked to components</h4>
  268. <div class="checkbox">
  269. <label>
  270. <input type="checkbox" checked value="alert.js">
  271. Alert dismissal
  272. </label>
  273. </div>
  274. <div class="checkbox">
  275. <label>
  276. <input type="checkbox" checked value="button.js">
  277. Advanced buttons
  278. </label>
  279. </div>
  280. <div class="checkbox">
  281. <label>
  282. <input type="checkbox" checked value="carousel.js">
  283. Carousel functionality
  284. </label>
  285. </div>
  286. <div class="checkbox">
  287. <label>
  288. <input type="checkbox" checked value="dropdown.js">
  289. Dropdowns
  290. </label>
  291. </div>
  292. <div class="checkbox">
  293. <label>
  294. <input type="checkbox" checked value="modal.js">
  295. Modals
  296. </label>
  297. </div>
  298. <div class="checkbox">
  299. <label>
  300. <input type="checkbox" checked value="tooltip.js">
  301. Tooltips
  302. </label>
  303. </div>
  304. <div class="checkbox">
  305. <label>
  306. <input type="checkbox" checked value="popover.js" data-dependencies="tooltip.js">
  307. Popovers <small>(requires Tooltips)</small>
  308. </label>
  309. </div>
  310. <div class="checkbox">
  311. <label>
  312. <input type="checkbox" checked value="tab.js">
  313. Togglable tabs
  314. </label>
  315. </div>
  316. </div>
  317. <div class="col-lg-6">
  318. <h4>Magic</h4>
  319. <div class="checkbox">
  320. <label>
  321. <input type="checkbox" checked value="affix.js">
  322. Affix
  323. </label>
  324. </div>
  325. <div class="checkbox">
  326. <label>
  327. <input type="checkbox" checked value="collapse.js">
  328. Collapse
  329. </label>
  330. </div>
  331. <div class="checkbox">
  332. <label>
  333. <input type="checkbox" checked value="scrollspy.js">
  334. Scrollspy
  335. </label>
  336. </div>
  337. <div class="checkbox">
  338. <label>
  339. <input type="checkbox" checked value="transition.js">
  340. Transitions <small>(required for any kind of animation)</small>
  341. </label>
  342. </div>
  343. </div>
  344. </div>
  345. <div class="bs-callout bs-callout-info">
  346. <h4>Produces two files</h4>
  347. <p>All checked plugins will be compiled into a readable <code>bootstrap.js</code> and a minified <code>bootstrap.min.js</code>. We recommend you use the minified version in production.</p>
  348. </div>
  349. <div class="bs-callout bs-callout-danger">
  350. <h4>jQuery required</h4>
  351. <p>All plugins require the latest version of <a href="http://jquery.com/" target="_blank">jQuery</a> to be included.</p>
  352. </div>
  353. </div>
  354. <div class="bs-docs-section" id="less-variables-section">
  355. <button class="btn btn-default toggle" type="button">Reset to defaults</button>
  356. <h1 id="less-variables" class="page-header">Less variables</h1>
  357. <p class="lead">Customize Less variables to define colors, sizes and more inside your custom CSS stylesheets.</p>
  358. {% include customizer-variables.html %}
  359. </div>
  360. <div class="bs-docs-section">
  361. <h1 id="download" class="page-header">Download</h1>
  362. <p class="lead">Hooray! Your custom version of Bootstrap is now ready to be compiled. Just click the button below to finish the process.</p>
  363. <div class="bs-customize-download">
  364. <button type="submit" id="btn-compile" disabled class="btn btn-block btn-lg btn-outline" onclick="ga('send', 'event', 'Customize', 'Download', 'Customize and Download');">Compile and Download</button>
  365. </div>
  366. </div><!-- /download -->
  367. </form>