customize.html 12.2 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.
  The alert covers up the entire customizer UI.
-->
<!--[if lt IE 9]>
  <style>
    .bs-customizer,
15
    .bs-customizer-import,
16
17
18
19
20
21
22
23
24
25
    .bs-docs-sidebar {
      display: none;
    }
  </style>
  <div class="alert alert-danger bs-customizer-alert-ie">
    <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" role="form">
39
  <div class="bs-docs-section" id="less-section">
40
    <button class="btn btn-default 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

Mark Otto's avatar
Mark Otto committed
264
265


266
  <div class="bs-docs-section" id="plugin-section">
267
268
269
    <button class="btn btn-default toggle" type="button">Toggle all</button>
    <h1 id="plugins" class="page-header">jQuery plugins</h1>

270
    <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
271
272
273
274
275
276
277
278
    <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
279
        </div>
Mark Otto's avatar
Mark Otto committed
280
281
282
283
284
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="button.js">
            Advanced buttons
          </label>
285
        </div>
Mark Otto's avatar
Mark Otto committed
286
287
288
289
290
        <div class="checkbox">
          <label>
            <input type="checkbox" checked value="carousel.js">
            Carousel functionality
          </label>
syed's avatar
syed committed
291
        </div>
Mark Otto's avatar
Mark Otto committed
292
293
294
295
296
297
298
299
300
301
302
303
304
305
        <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
306
            <input type="checkbox" checked value="tooltip.js">
Mark Otto's avatar
Mark Otto committed
307
308
309
310
311
            Tooltips
          </label>
        </div>
        <div class="checkbox">
          <label>
312
            <input type="checkbox" checked value="popover.js" data-dependencies="tooltip.js">
Mark Otto's avatar
Mark Otto committed
313
314
315
316
317
318
            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
319
            Togglable tabs
Mark Otto's avatar
Mark Otto committed
320
          </label>
syed's avatar
syed committed
321
        </div>
Mark Otto's avatar
Mark Otto committed
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
348
349
      </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
350
    </div>
351

Mark Otto's avatar
Mark Otto committed
352
353
354
355
    <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>
356

Mark Otto's avatar
Mark Otto committed
357
358
359
360
361
    <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
362
363
364



365
  <div class="bs-docs-section" id="less-variables-section">
366
    <button class="btn btn-default toggle" type="button">Reset to defaults</button>
Quy Ton's avatar
Quy Ton committed
367
    <h1 id="less-variables" class="page-header">Less variables</h1>
368

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

Mark Otto's avatar
Mark Otto committed
373
  <div class="bs-docs-section">
374
375
    <h1 id="download" class="page-header">Download</h1>

Mark Otto's avatar
Mark Otto committed
376
377
    <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">
378
      <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
379
380
    </div>
  </div><!-- /download -->
381
</form>