mixins.less 17 KB
Newer Older
1
2
3
//
// Mixins
// --------------------------------------------------
4

5

6
7
// Utilities
// -------------------------
8
9

// Clearfix
10
11
12
13
14
15
16
17
18
// Source: http://nicolasgallagher.com/micro-clearfix-hack/
//
// For modern browsers
// 1. The space content is one way to avoid an Opera bug when the
//    contenteditable attribute is included anywhere else in the document.
//    Otherwise it causes space to appear at the top and bottom of elements
//    that are clearfixed.
// 2. The use of `table` rather than `block` is only necessary if using
//    `:before` to contain the top-margins of child elements.
19
.clearfix() {
20
  &:before,
21
  &:after {
22
23
    content: " "; /* 1 */
    display: table; /* 2 */
24
25
  }
  &:after {
26
    clear: both;
27
  }
28
29
}

Mark Otto's avatar
Mark Otto committed
30
31
32
// Webkit-style focus
.tab-focus() {
  // Default
33
  outline: thin dotted #333;
Mark Otto's avatar
Mark Otto committed
34
35
36
37
38
  // Webkit
  outline: 5px auto -webkit-focus-ring-color;
  outline-offset: -2px;
}

39
// Center-align a block level element
40
.center-block() {
41
  display: block;
42
43
  margin-left: auto;
  margin-right: auto;
44
45
46
}

// Sizing shortcuts
47
.size(@width, @height) {
48
  width: @width;
49
  height: @height;
50
}
51
.square(@size) {
52
  .size(@size, @size);
53
54
}

55
// Placeholder text
Mark Otto's avatar
Mark Otto committed
56
.placeholder(@color: @input-color-placeholder) {
57
58
59
60
  &:-moz-placeholder            { color: @color; } // Firefox 4-18
  &::-moz-placeholder           { color: @color; } // Firefox 19+
  &:-ms-input-placeholder       { color: @color; } // Internet Explorer 10+
  &::-webkit-input-placeholder  { color: @color; } // Safari and Chrome
61
62
}

Mark Otto's avatar
Mark Otto committed
63
64
65
66
67
68
69
70
// Text overflow
// Requires inline-block or block for proper styling
.text-overflow() {
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}

71
72
// CSS image replacement
// Source: https://github.com/h5bp/html5-boilerplate/commit/aa0396eae757
73
.hide-text() {
74
  font: ~"0/0" a;
75
  color: transparent;
76
  text-shadow: none;
77
  background-color: transparent;
78
  border: 0;
79
}
80

81

82

83
84
85
// CSS3 PROPERTIES
// --------------------------------------------------

86
// Single side border-radius
87
.border-top-radius(@radius) {
88
89
  border-top-right-radius: @radius;
   border-top-left-radius: @radius;
90
91
}
.border-right-radius(@radius) {
92
93
  border-bottom-right-radius: @radius;
     border-top-right-radius: @radius;
Mark Otto's avatar
Mark Otto committed
94
95
}
.border-bottom-radius(@radius) {
96
97
  border-bottom-right-radius: @radius;
   border-bottom-left-radius: @radius;
Mark Otto's avatar
Mark Otto committed
98
99
}
.border-left-radius(@radius) {
100
101
  border-bottom-left-radius: @radius;
     border-top-left-radius: @radius;
102
103
}

104
// Drop shadows
Mark Otto's avatar
Mark Otto committed
105
.box-shadow(@shadow) {
106
  -webkit-box-shadow: @shadow; // iOS <4.3 & Android <4.1
107
          box-shadow: @shadow;
108
109
110
}

// Transitions
Mark Otto's avatar
Mark Otto committed
111
112
113
.transition(@transition) {
  -webkit-transition: @transition;
          transition: @transition;
114
}
Tunghsiao Liu's avatar
Tunghsiao Liu committed
115
116
117
118
.transition-delay(@transition-delay) {
  -webkit-transition-delay: @transition-delay;
          transition-delay: @transition-delay;
}
Tunghsiao Liu's avatar
Tunghsiao Liu committed
119
120
121
122
.transition-duration(@transition-duration) {
  -webkit-transition-duration: @transition-duration;
          transition-duration: @transition-duration;
}
123

Mark Otto's avatar
Mark Otto committed
124
// Transformations
125
.rotate(@degrees) {
126
  -webkit-transform: rotate(@degrees);
Mark Otto's avatar
Mark Otto committed
127
      -ms-transform: rotate(@degrees);
128
129
          transform: rotate(@degrees);
}
130
131
132
133
.scale(@ratio) {
  -webkit-transform: scale(@ratio);
      -ms-transform: scale(@ratio);
          transform: scale(@ratio);
134
}
135
.translate(@x, @y) {
Mark Otto's avatar
Mark Otto committed
136
137
138
139
  -webkit-transform: translate(@x, @y);
      -ms-transform: translate(@x, @y);
          transform: translate(@x, @y);
}
140
.skew(@x, @y) {
Mark Otto's avatar
Mark Otto committed
141
  -webkit-transform: skew(@x, @y);
Chris Rebert's avatar
Chris Rebert committed
142
      -ms-transform: skewX(@x) skewY(@y); // See https://github.com/twbs/bootstrap/issues/4885
Mark Otto's avatar
Mark Otto committed
143
144
          transform: skew(@x, @y);
}
145
.translate3d(@x, @y, @z) {
146
147
  -webkit-transform: translate3d(@x, @y, @z);
          transform: translate3d(@x, @y, @z);
148
}
149

150
151
// Backface visibility
// Prevent browsers from flickering when using CSS 3D transforms.
Chris Rebert's avatar
Chris Rebert committed
152
// Default value is `visible`, but can be changed to `hidden`
153
// See git pull https://github.com/dannykeane/bootstrap.git backface-visibility for examples
154
.backface-visibility(@visibility){
155
	-webkit-backface-visibility: @visibility;
156
157
	   -moz-backface-visibility: @visibility;
	        backface-visibility: @visibility;
158
159
}

160
// Background clipping
Mark Otto's avatar
Mark Otto committed
161
162
.background-clip(@clip) {
          background-clip: @clip;
163
164
}

165
// Background sizing
166
.background-size(@size) {
Mark Otto's avatar
Mark Otto committed
167
          background-size: @size;
168
169
}

170
171
172
173
174
175
176
// Box sizing
.box-sizing(@boxmodel) {
  -webkit-box-sizing: @boxmodel;
     -moz-box-sizing: @boxmodel;
          box-sizing: @boxmodel;
}

177
178
179
180
181
// User select
// For selecting text on the page
.user-select(@select) {
  -webkit-user-select: @select;
     -moz-user-select: @select;
Han Lin Yap's avatar
Han Lin Yap committed
182
      -ms-user-select: @select;
183
184
185
186
       -o-user-select: @select;
          user-select: @select;
}

187
// Resize anything
188
.resizable(@direction) {
189
190
191
192
  resize: @direction; // Options: horizontal, vertical, both
  overflow: auto; // Safari fix
}

193
// CSS3 Content Columns
194
195
196
197
198
199
200
.content-columns(@column-count, @column-gap: @grid-gutter-width) {
  -webkit-column-count: @column-count;
     -moz-column-count: @column-count;
          column-count: @column-count;
  -webkit-column-gap: @column-gap;
     -moz-column-gap: @column-gap;
          column-gap: @column-gap;
201
202
}

Synchro's avatar
Synchro committed
203
204
// Optional hyphenation
.hyphens(@mode: auto) {
Mark Otto's avatar
Mark Otto committed
205
  word-wrap: break-word;
Synchro's avatar
Synchro committed
206
207
208
  -webkit-hyphens: @mode;
     -moz-hyphens: @mode;
      -ms-hyphens: @mode;
Synchro's avatar
Synchro committed
209
       -o-hyphens: @mode;
Synchro's avatar
Synchro committed
210
211
212
          hyphens: @mode;
}

213
// Opacity
214
.opacity(@opacity) {
215
216
  opacity: @opacity;
  // IE8 filter
217
  @opacity-ie: (@opacity * 100);
218
  filter: ~"alpha(opacity=@{opacity-ie})";
219
220
221
222
}



Mark Otto's avatar
Mark Otto committed
223
// GRADIENTS
224
225
// --------------------------------------------------

226
#gradient {
Mark Otto's avatar
Mark Otto committed
227
228
229
230
231
232
233
234
235
236
237

  // Horizontal gradient, from left to right
  //
  // Creates two color stops, start and end, by specifying a color and position for each color stop.
  // Color stops are not available in IE9 and below.
  .horizontal(@start-color: #555; @start-percent: 0%; @end-color: #333; @end-percent: 100%) {
    background-color: @end-color;
    background-image: -webkit-gradient(linear, @start-percent top, @end-percent top, from(@start-color), to(@end-color)); // Safari 4+, Chrome 2+
    background-image: -webkit-linear-gradient(left, color-stop(@start-color @start-percent), color-stop(@end-color @end-percent)); // Safari 5.1+, Chrome 10+
    background-image: -moz-linear-gradient(left, @start-color @start-percent, @end-color @end-percent); // FF 3.6+
    background-image:  linear-gradient(to right, @start-color @start-percent, @end-color @end-percent); // Standard, IE10
238
    background-repeat: repeat-x;
Mark Otto's avatar
Mark Otto committed
239
    filter: e(%("progid:DXImageTransform.Microsoft.gradient(startColorstr='%d', endColorstr='%d', GradientType=1)",argb(@start-color),argb(@end-color))); // IE9 and down
240
  }
Mark Otto's avatar
Mark Otto committed
241
242
243
244
245
246
247
248
249
250
251

  // Vertical gradient, from top to bottom
  //
  // Creates two color stops, start and end, by specifying a color and position for each color stop.
  // Color stops are not available in IE9 and below.
  .vertical(@start-color: #555; @start-percent: 0%; @end-color: #333; @end-percent: 100%) {
    background-color: @end-color;
    background-image: -webkit-gradient(linear, left @start-percent, left @end-percent, from(@start-color), to(@end-color)); // Safari 4+, Chrome 2+
    background-image: -webkit-linear-gradient(top, @start-color, @start-percent, @end-color, @end-percent); // Safari 5.1+, Chrome 10+
    background-image:  -moz-linear-gradient(top, @start-color @start-percent, @end-color @end-percent); // FF 3.6+
    background-image: linear-gradient(to bottom, @start-color @start-percent, @end-color @end-percent); // Standard, IE10
252
    background-repeat: repeat-x;
Mark Otto's avatar
Mark Otto committed
253
    filter: e(%("progid:DXImageTransform.Microsoft.gradient(startColorstr='%d', endColorstr='%d', GradientType=0)",argb(@start-color),argb(@end-color))); // IE9 and down
254
  }
Mark Otto's avatar
Mark Otto committed
255
256
257

  .directional(@start-color: #555, @end-color: #333, @deg: 45deg) {
    background-color: @end-color;
258
    background-repeat: repeat-x;
Mark Otto's avatar
Mark Otto committed
259
260
261
    background-image: -webkit-linear-gradient(@deg, @start-color, @end-color); // Safari 5.1+, Chrome 10+
    background-image: -moz-linear-gradient(@deg, @start-color, @end-color); // FF 3.6+
    background-image: linear-gradient(@deg, @start-color, @end-color); // Standard, IE10
262
  }
Mark Otto's avatar
Mark Otto committed
263
264
265
266
267
268
  .horizontal-three-colors(@start-color: #00b3ee, @mid-color: #7a43b6, @color-stop: 50%, @end-color: #c3325f) {
    background-color: mix(@mid-color, @end-color, 80%);
    background-image: -webkit-gradient(left, linear, 0 0, 0 100%, from(@start-color), color-stop(@color-stop, @mid-color), to(@end-color));
    background-image: -webkit-linear-gradient(left, @start-color, @mid-color @color-stop, @end-color);
    background-image: -moz-linear-gradient(left, @start-color, @mid-color @color-stop, @end-color);
    background-image: linear-gradient(to right, @start-color, @mid-color @color-stop, @end-color);
Francisco arenas's avatar
Francisco arenas committed
269
    background-repeat: no-repeat;
Mark Otto's avatar
Mark Otto committed
270
    filter: e(%("progid:DXImageTransform.Microsoft.gradient(startColorstr='%d', endColorstr='%d', GradientType=1)",argb(@start-color),argb(@end-color))); // IE9 and down, gets no color-stop at all for proper fallback
Francisco arenas's avatar
Francisco arenas committed
271
272
  }

Mark Otto's avatar
Mark Otto committed
273
274
275
276
277
278
  .vertical-three-colors(@start-color: #00b3ee, @mid-color: #7a43b6, @color-stop: 50%, @end-color: #c3325f) {
    background-color: mix(@mid-color, @end-color, 80%);
    background-image: -webkit-gradient(linear, 0 0, 0 100%, from(@start-color), color-stop(@color-stop, @mid-color), to(@end-color));
    background-image: -webkit-linear-gradient(@start-color, @mid-color @color-stop, @end-color);
    background-image: -moz-linear-gradient(top, @start-color, @mid-color @color-stop, @end-color);
    background-image: linear-gradient(@start-color, @mid-color @color-stop, @end-color);
279
    background-repeat: no-repeat;
Mark Otto's avatar
Mark Otto committed
280
    filter: e(%("progid:DXImageTransform.Microsoft.gradient(startColorstr='%d', endColorstr='%d', GradientType=0)",argb(@start-color),argb(@end-color))); // IE9 and down, gets no color-stop at all for proper fallback
281
  }
Mark Otto's avatar
Mark Otto committed
282
283
284
285
286
287
  .radial(@inner-color: #555, @outer-color: #333) {
    background-color: @outer-color;
    background-image: -webkit-gradient(radial, center center, 0, center center, 460, from(@inner-color), to(@outer-color));
    background-image: -webkit-radial-gradient(circle, @inner-color, @outer-color);
    background-image: -moz-radial-gradient(circle, @inner-color, @outer-color);
    background-image: radial-gradient(circle, @inner-color, @outer-color);
288
289
    background-repeat: no-repeat;
  }
290
  .striped(@color: #555, @angle: 45deg) {
Piotrek Okoński's avatar
Piotrek Okoński committed
291
    background-color: @color;
292
293
294
295
    background-image: -webkit-gradient(linear, 0 100%, 100% 0, color-stop(.25, rgba(255,255,255,.15)), color-stop(.25, transparent), color-stop(.5, transparent), color-stop(.5, rgba(255,255,255,.15)), color-stop(.75, rgba(255,255,255,.15)), color-stop(.75, transparent), to(transparent));
    background-image: -webkit-linear-gradient(@angle, rgba(255,255,255,.15) 25%, transparent 25%, transparent 50%, rgba(255,255,255,.15) 50%, rgba(255,255,255,.15) 75%, transparent 75%, transparent);
    background-image: -moz-linear-gradient(@angle, rgba(255,255,255,.15) 25%, transparent 25%, transparent 50%, rgba(255,255,255,.15) 50%, rgba(255,255,255,.15) 75%, transparent 75%, transparent);
    background-image: linear-gradient(@angle, rgba(255,255,255,.15) 25%, transparent 25%, transparent 50%, rgba(255,255,255,.15) 50%, rgba(255,255,255,.15) 75%, transparent 75%, transparent);
Piotrek Okoński's avatar
Piotrek Okoński committed
296
  }
297
}
Mark Otto's avatar
Mark Otto committed
298

299
// Reset filters for IE
Mark Otto's avatar
Mark Otto committed
300
301
302
//
// When you need to remove a gradient background, don't forget to use this to reset
// the IE filter for IE9 and below.
303
.reset-filter() {
304
  filter: e(%("progid:DXImageTransform.Microsoft.gradient(enabled = false)"));
305
}
306

307

Mark Otto's avatar
Mark Otto committed
308

Danny Keane's avatar
Danny Keane committed
309
310
311
// RETINA IMAGE SUPPORT
// --------------------------------------------------

Mark Otto's avatar
Mark Otto committed
312
// Short retina mixin for setting background-image and -size
313
.img-retina(@file-1x, @file-2x, @width-1x, @height-1x) {
Mark Otto's avatar
Mark Otto committed
314
315
316
317
318
319
320
321
322
323
324
325
  background-image: url("@{file-1x}");

  @media
  only screen and (-webkit-min-device-pixel-ratio: 2),
  only screen and (   min--moz-device-pixel-ratio: 2),
  only screen and (     -o-min-device-pixel-ratio: 2/1),
  only screen and (        min-device-pixel-ratio: 2),
  only screen and (                min-resolution: 192dpi),
  only screen and (                min-resolution: 2dppx) {
    background-image: url("@{file-2x}");
    background-size: @width-1x @height-1x;
  }
Danny Keane's avatar
Danny Keane committed
326
327
}

328
329
330
331

// COMPONENT MIXINS
// --------------------------------------------------

332
// Horizontal dividers
333
334
// -------------------------
// Dividers (basically an hr) within dropdowns and nav lists
Mark Otto's avatar
Mark Otto committed
335
336
.nav-divider(@color: #e5e5e5) {
  height: 1px;
337
  margin: ((@line-height-computed / 2) - 1) 0;
Jacob Thornton's avatar
Jacob Thornton committed
338
  overflow: hidden;
Mark Otto's avatar
Mark Otto committed
339
  background-color: @color;
340
341
}

Chris Rebert's avatar
Chris Rebert committed
342
343
344
345
346
347
348
349
350
351
352
353
354
355
// Alerts
// -------------------------
.alert-variant(@background, @border, @text-color) {
  background-color: @background;
  border-color: @border;
  color: @text-color;
  hr {
    border-top-color: darken(@border, 5%);
  }
  .alert-link {
    color: darken(@text-color, 10%);
  }
}

356
357
358
359
// Button psuedo states
// -------------------------
// Easily pump out default styles, as well as :hover, :focus, :active,
// and disabled options for all buttons
360
361
.btn-pseudo-states(@color, @background, @border) {
  color: @color;
362
363
  background-color: @background;
  border-color: @border;
364

Mark Otto's avatar
Mark Otto committed
365
  &:hover,
366
  &:focus,
367
368
  &:active,
  &.active {
369
370
    background-color: darken(@background, 5%);
        border-color: darken(@border, 10%);
Mark Otto's avatar
Mark Otto committed
371
  }
372

373
  &.disabled,
374
  &[disabled],
375
  fieldset[disabled] & {
376
    &,
377
378
    &:hover,
    &:focus,
379
380
    &:active,
    &.active {
381
382
383
      background-color: @background;
          border-color: @border
    }
384
385
386
  }
}

Chris Rebert's avatar
Chris Rebert committed
387
388
389
390
391
392
393
394
395
396
397
398
// Labels
// -------------------------
.label-variant(@color) {
  background-color: @color;
  &[href] {
    &:hover,
    &:focus {
      background-color: darken(@color, 10%);
    }
  }
}

399
400
401
402
// Navbar vertical align
// -------------------------
// Vertically center elements in the navbar.
// Example: an element has a height of 30px, so write out `.navbarVerticalAlign(30px);` to calculate the appropriate top margin.
Mark Otto's avatar
Mark Otto committed
403
.navbar-vertical-align(@element-height) {
404
405
  margin-top: ((@navbar-height - @element-height) / 2);
  margin-bottom: ((@navbar-height - @element-height) / 2);
406
407
}

408
409
410
411
412
413
414
415
416
// Progress bars
// -------------------------
.progress-bar-variant(@color) {
  background-color: @color;
  .progress-striped & {
    #gradient > .striped(@color);
  }
}

Mark Otto's avatar
Mark Otto committed
417
418
419
420
421
422
423
424
425
426
// Responsive utilities
// -------------------------
// More easily include all the states for responsive-utilities.less.
.responsive-visibility() {
  display: block !important;
  tr& { display: table-row !important; }
  th&,
  td& { display: table-cell !important; }
}

427
428
429
430
431
432
433
.responsive-invisibility() {
  display: none !important;
  tr& { display: none !important; }
  th&,
  td& { display: none !important; }
}

434
435
436
// Grid System
// -----------

437
// Centered container element
438
439
.container-fixed() {
  margin-right: auto;
Jacob Thornton's avatar
Jacob Thornton committed
440
  margin-left: auto;
441
  .clearfix();
442
443
}

444
// Creates a wrapper for a series of columns
445
.make-row() {
446
  // Then clear the floated columns
447
  .clearfix();
448

Mark Otto's avatar
Mark Otto committed
449
450
451
452
453
  @media (min-width: @screen-small) {
    margin-left:  (@grid-gutter-width / -2);
    margin-right: (@grid-gutter-width / -2);
  }

454
455
456
457
458
  // Negative margin nested rows out to align the content of columns
  .row {
    margin-left:  (@grid-gutter-width / -2);
    margin-right: (@grid-gutter-width / -2);
  }
459
}
Mark Otto's avatar
Mark Otto committed
460

461
// Generate the columns
462
.make-column(@columns) {
463
  position: relative;
464
465
  // Prevent columns from collapsing when empty
  min-height: 1px;
466
  // Inner gutter via padding
467
468
  padding-left:  (@grid-gutter-width / 2);
  padding-right: (@grid-gutter-width / 2);
469
470
471

  // Calculate width based on number of columns available
  @media (min-width: @grid-float-breakpoint) {
472
    float: left;
473
474
    width: percentage((@columns / @grid-columns));
  }
475
}
Mark Otto's avatar
Mark Otto committed
476

477
// Generate the column offsets
478
.make-column-offset(@columns) {
479
480
481
482
483
484
485
486
487
488
489
490
491
  @media (min-width: @grid-float-breakpoint) {
    margin-left: percentage((@columns / @grid-columns));
  }
}
.make-column-push(@columns) {
  @media (min-width: @grid-float-breakpoint) {
    left: percentage((@columns / @grid-columns));
  }
}
.make-column-pull(@columns) {
  @media (min-width: @grid-float-breakpoint) {
    right: percentage((@columns / @grid-columns));
  }
492
}
493

Bass Jobsen's avatar
Bass Jobsen committed
494
495
496
497
498
499
500
501
502
// Generate the small columns
.make-small-column(@columns) {
  position: relative;
  float: left;
  // Prevent columns from collapsing when empty
  min-height: 1px;
  // Inner gutter via padding
  padding-left:  (@grid-gutter-width / 2);
  padding-right: (@grid-gutter-width / 2);
Mark Otto's avatar
Mark Otto committed
503
504
  @max-width: (@grid-float-breakpoint - 1);

Bass Jobsen's avatar
Bass Jobsen committed
505
  // Calculate width based on number of columns available
Mark Otto's avatar
Mark Otto committed
506
  @media (max-width: @max-width) {
Bass Jobsen's avatar
Bass Jobsen committed
507
508
509
    width: percentage((@columns / @grid-columns));
  }
}
Mark Otto's avatar
Mark Otto committed
510
511


Mark Otto's avatar
Mark Otto committed
512
513
514
515
516
517
518
// Form validation states
//
// Used in forms.less to generate the form validation CSS for warnings, errors,
// and successes.

.form-control-validation(@text-color: #555, @border-color: #ccc, @background-color: #f5f5f5) {
  // Color the label and help text
519
  .help-block,
Mark Otto's avatar
Mark Otto committed
520
521
522
523
  .control-label {
    color: @text-color;
  }
  // Set the border and box shadow on specific inputs to match
Mark Otto's avatar
Mark Otto committed
524
  .form-control {
Mark Otto's avatar
Mark Otto committed
525
526
527
528
529
530
531
532
533
    padding-right: 32px; // to account for the feedback icon
    border-color: @border-color;
    .box-shadow(inset 0 1px 1px rgba(0,0,0,.075)); // Redeclare so transitions work
    &:focus {
      border-color: darken(@border-color, 10%);
      @shadow: inset 0 1px 1px rgba(0,0,0,.075), 0 0 6px lighten(@border-color, 20%);
      .box-shadow(@shadow);
    }
  }
534
535
536
537
538
  // Set validation states also for addons
  .input-group-addon {
    color: @text-color;
    border-color: @border-color;
    background-color: @background-color;
Mark Otto's avatar
Mark Otto committed
539
  }
Mark Otto's avatar
Mark Otto committed
540
}