customize.html 12.1 KB
Newer Older
Mark Otto's avatar
Mark Otto committed
1
---
2
layout: default
Mark Otto's avatar
Mark Otto committed
3
title: Customize and download
Mark Otto's avatar
Mark Otto committed
4
slug: customize
Quy Ton's avatar
Quy Ton committed
5
lead: Customize Bootstrap's components, Less variables, and jQuery plugins to get your very own version.
Mark Otto's avatar
Mark Otto committed
6
7
---

8

9
10
11
12
13
14
<!-- 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.
  So we use a conditional comment instead to inform folks about the lack of IE8 support.
-->
<!--[if lt IE 9]>
  <style>
    .bs-customizer,
15
    .bs-customizer-import,
16
17
18
19
    .bs-docs-sidebar {
      display: none;
    }
  </style>
20
  <div class="alert alert-danger">
21
22
23
24
25
    <strong>The Bootstrap Customizer does not support IE9 and below.</strong><br>
    Please take a second to <a href="http://browsehappy.com/">upgrade to a more modern browser</a>.
  </div>
<![endif]-->

Mark Otto's avatar
Mark Otto committed
26
<!-- Customizer form -->
27
28
29
30
31
32
33
34
35
36
37

<div class="bs-docs-section bs-customizer-import">
  <div id="import-drop-target" class="bs-dropzone">
    <h2></h2>
    <p class="lead">Have an existing configuration? Upload your <code>config.json</code> to import it.</p>
    <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>
    <hr>
    <p><strong>Don't have one?</strong> That's okay—just start customizing the fields below.</p>
  </div>
</div><!-- /import -->

38
<form class="bs-customizer">
39
  <div class="bs-docs-section" id="less-section">
Mark Otto's avatar
Mark Otto committed
40
    <button class="btn btn-secondary toggle" type="button">Toggle all</button>
Quy Ton's avatar
Quy Ton committed
41
    <h1 id="less" class="page-header">Less files</h1>
42

Quy Ton's avatar
Quy Ton committed
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>
Mark Otto's avatar
Mark Otto committed
44

Mark Otto's avatar
Mark Otto committed
45
    <div class="row">
Mark Otto's avatar
Mark Otto committed
46
      <div class="col-xs-6 col-sm-4">
47
        <h3>Common CSS</h3>
Mark Otto's avatar
Mark Otto committed
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="print.less">
            Print media styles
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="type.less">
            Typography
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="code.less">
            Code
          </label>
        </div>
66
67
68
69
70
71
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="grid.less">
            Grid system
          </label>
        </div>
Mark Otto's avatar
Mark Otto committed
72
73
74
75
76
77
78
79
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="tables.less">
            Tables
          </label>
        </div>
        <div class="checkbox">
          <label>
80
            <input type="checkbox" checked value="forms.less" data-dependents="navbar.less,input-groups.less">
Mark Otto's avatar
Mark Otto committed
81
82
83
84
85
            Forms
          </label>
        </div>
        <div class="checkbox">
          <label>
86
            <input type="checkbox" checked value="buttons.less" data-dependents="button-groups.less">
Mark Otto's avatar
Mark Otto committed
87
88
89
            Buttons
          </label>
        </div>
90
91
92
93
94
95
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="responsive-utilities.less">
            Responsive utilities
          </label>
        </div>
96
97
      </div><!-- .col-xs-6 .col-sm-4 -->

Mark Otto's avatar
Mark Otto committed
98
      <div class="col-xs-6 col-sm-4">
99
        <h3>Components</h3>
Mark Otto's avatar
Mark Otto committed
100
101
        <div class="checkbox">
          <label>
102
103
            <input type="checkbox" checked value="glyphicons.less">
            Glyphicons
Mark Otto's avatar
Mark Otto committed
104
          </label>
105
        </div>
Mark Otto's avatar
Mark Otto committed
106
107
        <div class="checkbox">
          <label>
108
            <input type="checkbox" checked value="button-groups.less" data-dependencies="buttons.less">
109
            Button groups
Mark Otto's avatar
Mark Otto committed
110
111
112
113
          </label>
        </div>
        <div class="checkbox">
          <label>
114
            <input type="checkbox" checked value="input-groups.less" data-dependencies="forms.less">
115
            Input groups
Mark Otto's avatar
Mark Otto committed
116
117
118
119
          </label>
        </div>
        <div class="checkbox">
          <label>
120
            <input type="checkbox" checked value="navs.less" data-dependents="navbar.less">
Mark Otto's avatar
Mark Otto committed
121
122
123
124
125
            Navs
          </label>
        </div>
        <div class="checkbox">
          <label>
126
            <input type="checkbox" checked value="navbar.less" data-dependencies="forms.less,navs.less">
Mark Otto's avatar
Mark Otto committed
127
128
129
            Navbar
          </label>
        </div>
130
131
132
133
134
135
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="breadcrumbs.less">
            Breadcrumbs
          </label>
        </div>
Mark Otto's avatar
Mark Otto committed
136
137
138
139
140
141
142
143
144
145
146
147
148
149
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="pagination.less">
            Pagination
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="pager.less">
            Pager
          </label>
        </div>
        <div class="checkbox">
          <label>
150
151
            <input type="checkbox" checked value="labels.less">
            Labels
Mark Otto's avatar
Mark Otto committed
152
153
154
155
          </label>
        </div>
        <div class="checkbox">
          <label>
156
157
            <input type="checkbox" checked value="badges.less">
            Badges
Mark Otto's avatar
Mark Otto committed
158
159
160
161
          </label>
        </div>
        <div class="checkbox">
          <label>
162
163
            <input type="checkbox" checked value="jumbotron.less">
            Jumbotron
Mark Otto's avatar
Mark Otto committed
164
165
166
167
          </label>
        </div>
        <div class="checkbox">
          <label>
168
169
            <input type="checkbox" checked value="thumbnails.less">
            Thumbnails
Mark Otto's avatar
Mark Otto committed
170
          </label>
171
        </div>
Mark Otto's avatar
Mark Otto committed
172
173
174
175
176
177
178
179
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="alerts.less">
            Alerts
          </label>
        </div>
        <div class="checkbox">
          <label>
180
181
            <input type="checkbox" checked value="progress-bars.less">
            Progress bars
Mark Otto's avatar
Mark Otto committed
182
183
184
185
          </label>
        </div>
        <div class="checkbox">
          <label>
186
187
            <input type="checkbox" checked value="media.less">
            Media items
Mark Otto's avatar
Mark Otto committed
188
189
190
191
          </label>
        </div>
        <div class="checkbox">
          <label>
192
193
            <input type="checkbox" checked value="list-group.less">
            List groups
Mark Otto's avatar
Mark Otto committed
194
195
196
197
          </label>
        </div>
        <div class="checkbox">
          <label>
198
199
            <input type="checkbox" checked value="panels.less">
            Panels
Mark Otto's avatar
Mark Otto committed
200
201
202
          </label>
        </div>
        <div class="checkbox">
Mark Otto's avatar
Mark Otto committed
203
204
205
206
207
208
          <label>
            <input type="checkbox" checked value="responsive-embed.less">
            Responsive embed
          </label>
        </div>
        <div class="checkbox">
Mark Otto's avatar
Mark Otto committed
209
          <label>
210
211
            <input type="checkbox" checked value="wells.less">
            Wells
Mark Otto's avatar
Mark Otto committed
212
213
214
215
          </label>
        </div>
        <div class="checkbox">
          <label>
216
217
            <input type="checkbox" checked value="close.less">
            Close icon
Mark Otto's avatar
Mark Otto committed
218
219
          </label>
        </div>
220
221
222
223
      </div><!-- .col-xs-6 .col-sm-4 -->

      <div class="col-xs-6 col-sm-4">
        <h3>JavaScript components</h3>
224
225
226
227
228
229
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="component-animations.less">
            Component animations (for JS)
          </label>
        </div>
Mark Otto's avatar
Mark Otto committed
230
231
        <div class="checkbox">
          <label>
232
233
            <input type="checkbox" checked value="dropdowns.less">
            Dropdowns
Mark Otto's avatar
Mark Otto committed
234
235
236
237
          </label>
        </div>
        <div class="checkbox">
          <label>
238
239
            <input type="checkbox" checked value="tooltip.less">
            Tooltips
Mark Otto's avatar
Mark Otto committed
240
241
          </label>
        </div>
Mark Otto's avatar
Mark Otto committed
242
243
        <div class="checkbox">
          <label>
244
245
            <input type="checkbox" checked value="popovers.less">
            Popovers
Mark Otto's avatar
Mark Otto committed
246
247
          </label>
        </div>
Mark Otto's avatar
Mark Otto committed
248
249
        <div class="checkbox">
          <label>
250
251
            <input type="checkbox" checked value="modals.less">
            Modals
Mark Otto's avatar
Mark Otto committed
252
253
254
255
          </label>
        </div>
        <div class="checkbox">
          <label>
256
257
            <input type="checkbox" checked value="carousel.less">
            Carousel
Mark Otto's avatar
Mark Otto committed
258
          </label>
259
        </div>
260
261
      </div><!-- .col-xs-6 .col-sm-4 -->
    </div><!-- /.row -->
Mark Otto's avatar
Mark Otto committed
262
  </div>
263

264
  <div class="bs-docs-section" id="plugin-section">
Mark Otto's avatar
Mark Otto committed
265
    <button class="btn btn-secondary toggle" type="button">Toggle all</button>
266
267
    <h1 id="plugins" class="page-header">jQuery plugins</h1>

268
    <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>
Mark Otto's avatar
Mark Otto committed
269
270
271
272
273
274
275
276
    <div class="row">
      <div class="col-lg-6">
        <h4>Linked to components</h4>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="alert.js">
            Alert dismissal
          </label>
syed's avatar
syed committed
277
        </div>
Mark Otto's avatar
Mark Otto committed
278
279
280
281
282
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="button.js">
            Advanced buttons
          </label>
283
        </div>
Mark Otto's avatar
Mark Otto committed
284
285
286
287
288
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="carousel.js">
            Carousel functionality
          </label>
syed's avatar
syed committed
289
        </div>
Mark Otto's avatar
Mark Otto committed
290
291
292
293
294
295
296
297
298
299
300
301
302
303
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="dropdown.js">
            Dropdowns
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="modal.js">
            Modals
          </label>
        </div>
        <div class="checkbox">
          <label>
Mark Otto's avatar
Mark Otto committed
304
            <input type="checkbox" checked value="tooltip.js">
Mark Otto's avatar
Mark Otto committed
305
306
307
308
309
            Tooltips
          </label>
        </div>
        <div class="checkbox">
          <label>
310
            <input type="checkbox" checked value="popover.js" data-dependencies="tooltip.js">
Mark Otto's avatar
Mark Otto committed
311
312
313
314
315
316
            Popovers <small>(requires Tooltips)</small>
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="tab.js">
Chris Rebert's avatar
Chris Rebert committed
317
            Togglable tabs
Mark Otto's avatar
Mark Otto committed
318
          </label>
syed's avatar
syed committed
319
        </div>
Mark Otto's avatar
Mark Otto committed
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
      </div>
      <div class="col-lg-6">
        <h4>Magic</h4>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="affix.js">
            Affix
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="collapse.js">
            Collapse
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="scrollspy.js">
            Scrollspy
          </label>
        </div>
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="transition.js">
            Transitions <small>(required for any kind of animation)</small>
          </label>
        </div>
      </div>
Mark Otto's avatar
Mark Otto committed
348
    </div>
349

Mark Otto's avatar
Mark Otto committed
350
351
352
353
    <div class="bs-callout bs-callout-info">
      <h4>Produces two files</h4>
      <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>
    </div>
354

Mark Otto's avatar
Mark Otto committed
355
356
357
358
359
    <div class="bs-callout bs-callout-danger">
      <h4>jQuery required</h4>
      <p>All plugins require the latest version of <a href="http://jquery.com/" target="_blank">jQuery</a> to be included.</p>
    </div>
  </div>
Mark Otto's avatar
Mark Otto committed
360

361
  <div class="bs-docs-section" id="less-variables-section">
Mark Otto's avatar
Mark Otto committed
362
    <button class="btn btn-secondary toggle" type="button">Reset to defaults</button>
Quy Ton's avatar
Quy Ton committed
363
    <h1 id="less-variables" class="page-header">Less variables</h1>
364

Quy Ton's avatar
Quy Ton committed
365
    <p class="lead">Customize Less variables to define colors, sizes and more inside your custom CSS stylesheets.</p>
366
    {% include customizer-variables.html %}
Mark Otto's avatar
Mark Otto committed
367
  </div>
Mark Otto's avatar
Mark Otto committed
368

Mark Otto's avatar
Mark Otto committed
369
  <div class="bs-docs-section">
370
371
    <h1 id="download" class="page-header">Download</h1>

Mark Otto's avatar
Mark Otto committed
372
373
    <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>
    <div class="bs-customize-download">
374
      <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>
Mark Otto's avatar
Mark Otto committed
375
376
    </div>
  </div><!-- /download -->
377
</form>