blob: 11ba1096c784ade85c48ead8684973999258c6a9 [file] [log] [blame]
Matteo Scandolo2500e392016-03-25 17:20:27 -07001//
2// Forms
3// --------------------------------------------------
4
5
6// Normalize non-controls
7//
8// Restyle and baseline non-control form elements.
9
10fieldset {
11 padding: 0;
12 margin: 0;
13 border: 0;
14 // Chrome and Firefox set a `min-width: min-content;` on fieldsets,
15 // so we reset that to ensure it behaves more like a standard block element.
16 // See https://github.com/twbs/bootstrap/issues/12359.
17 min-width: 0;
18}
19
20legend {
21 display: block;
22 width: 100%;
23 padding: 0;
24 margin-bottom: $line-height-computed;
25 font-size: ($font-size-base * 1.5);
26 line-height: inherit;
27 color: $legend-color;
28 border: 0;
29 border-bottom: 1px solid $legend-border-color;
30}
31
32label {
33 display: inline-block;
34 max-width: 100%; // Force IE8 to wrap long content (see https://github.com/twbs/bootstrap/issues/13141)
35 margin-bottom: 5px;
36 font-weight: bold;
37}
38
39
40// Normalize form controls
41//
42// While most of our form styles require extra classes, some basic normalization
43// is required to ensure optimum display with or without those classes to better
44// address browser inconsistencies.
45
46// Override content-box in Normalize (* isn't specific enough)
47input[type="search"] {
48 @include box-sizing(border-box);
49}
50
51// Position radios and checkboxes better
52input[type="radio"],
53input[type="checkbox"] {
54 margin: 4px 0 0;
55 margin-top: 1px \9; // IE8-9
56 line-height: normal;
57}
58
59input[type="file"] {
60 display: block;
61}
62
63// Make range inputs behave like textual form controls
64input[type="range"] {
65 display: block;
66 width: 100%;
67}
68
69// Make multiple select elements height not fixed
70select[multiple],
71select[size] {
72 height: auto;
73}
74
75// Focus for file, radio, and checkbox
76input[type="file"]:focus,
77input[type="radio"]:focus,
78input[type="checkbox"]:focus {
79 @include tab-focus;
80}
81
82// Adjust output element
83output {
84 display: block;
85 padding-top: ($padding-base-vertical + 1);
86 font-size: $font-size-base;
87 line-height: $line-height-base;
88 color: $input-color;
89}
90
91
92// Common form controls
93//
94// Shared size and type resets for form controls. Apply `.form-control` to any
95// of the following form controls:
96//
97// select
98// textarea
99// input[type="text"]
100// input[type="password"]
101// input[type="datetime"]
102// input[type="datetime-local"]
103// input[type="date"]
104// input[type="month"]
105// input[type="time"]
106// input[type="week"]
107// input[type="number"]
108// input[type="email"]
109// input[type="url"]
110// input[type="search"]
111// input[type="tel"]
112// input[type="color"]
113
114.form-control {
115 display: block;
116 width: 100%;
117 height: $input-height-base; // Make inputs at least the height of their button counterpart (base line-height + padding + border)
118 padding: $padding-base-vertical $padding-base-horizontal;
119 font-size: $font-size-base;
120 line-height: $line-height-base;
121 color: $input-color;
122 background-color: $input-bg;
123 background-image: none; // Reset unusual Firefox-on-Android default style; see https://github.com/necolas/normalize.css/issues/214
124 border: 1px solid $input-border;
125 border-radius: $input-border-radius; // Note: This has no effect on <select>s in some browsers, due to the limited stylability of <select>s in CSS.
126 @include box-shadow(inset 0 1px 1px rgba(0,0,0,.075));
127 @include transition(border-color ease-in-out .15s, box-shadow ease-in-out .15s);
128
129 // Customize the `:focus` state to imitate native WebKit styles.
130 @include form-control-focus;
131
132 // Placeholder
133 @include placeholder;
134
135 // Unstyle the caret on `<select>`s in IE10+.
136 &::-ms-expand {
137 border: 0;
138 background-color: transparent;
139 }
140
141 // Disabled and read-only inputs
142 //
143 // HTML5 says that controls under a fieldset > legend:first-child won't be
144 // disabled if the fieldset is disabled. Due to implementation difficulty, we
145 // don't honor that edge case; we style them as disabled anyway.
146 &[disabled],
147 &[readonly],
148 fieldset[disabled] & {
149 background-color: $input-bg-disabled;
150 opacity: 1; // iOS fix for unreadable disabled content; see https://github.com/twbs/bootstrap/issues/11655
151 }
152
153 &[disabled],
154 fieldset[disabled] & {
155 cursor: $cursor-disabled;
156 }
157
158 // [converter] extracted textarea& to textarea.form-control
159}
160
161// Reset height for `textarea`s
162textarea.form-control {
163 height: auto;
164}
165
166
167// Search inputs in iOS
168//
169// This overrides the extra rounded corners on search inputs in iOS so that our
170// `.form-control` class can properly style them. Note that this cannot simply
171// be added to `.form-control` as it's not specific enough. For details, see
172// https://github.com/twbs/bootstrap/issues/11586.
173
174input[type="search"] {
175 -webkit-appearance: none;
176}
177
178
179// Special styles for iOS temporal inputs
180//
181// In Mobile Safari, setting `display: block` on temporal inputs causes the
182// text within the input to become vertically misaligned. As a workaround, we
183// set a pixel line-height that matches the given height of the input, but only
184// for Safari. See https://bugs.webkit.org/show_bug.cgi?id=139848
185//
186// Note that as of 8.3, iOS doesn't support `datetime` or `week`.
187
188@media screen and (-webkit-min-device-pixel-ratio: 0) {
189 input[type="date"],
190 input[type="time"],
191 input[type="datetime-local"],
192 input[type="month"] {
193 &.form-control {
194 line-height: $input-height-base;
195 }
196
197 &.input-sm,
198 .input-group-sm & {
199 line-height: $input-height-small;
200 }
201
202 &.input-lg,
203 .input-group-lg & {
204 line-height: $input-height-large;
205 }
206 }
207}
208
209
210// Form groups
211//
212// Designed to help with the organization and spacing of vertical forms. For
213// horizontal forms, use the predefined grid classes.
214
215.form-group {
216 margin-bottom: $form-group-margin-bottom;
217}
218
219
220// Checkboxes and radios
221//
222// Indent the labels to position radios/checkboxes as hanging controls.
223
224.radio,
225.checkbox {
226 position: relative;
227 display: block;
228 margin-top: 10px;
229 margin-bottom: 10px;
230
231 label {
232 min-height: $line-height-computed; // Ensure the input doesn't jump when there is no text
233 padding-left: 20px;
234 margin-bottom: 0;
235 font-weight: normal;
236 cursor: pointer;
237 }
238}
239.radio input[type="radio"],
240.radio-inline input[type="radio"],
241.checkbox input[type="checkbox"],
242.checkbox-inline input[type="checkbox"] {
243 position: absolute;
244 margin-left: -20px;
245 margin-top: 4px \9;
246}
247
248.radio + .radio,
249.checkbox + .checkbox {
250 margin-top: -5px; // Move up sibling radios or checkboxes for tighter spacing
251}
252
253// Radios and checkboxes on same line
254.radio-inline,
255.checkbox-inline {
256 position: relative;
257 display: inline-block;
258 padding-left: 20px;
259 margin-bottom: 0;
260 vertical-align: middle;
261 font-weight: normal;
262 cursor: pointer;
263}
264.radio-inline + .radio-inline,
265.checkbox-inline + .checkbox-inline {
266 margin-top: 0;
267 margin-left: 10px; // space out consecutive inline controls
268}
269
270// Apply same disabled cursor tweak as for inputs
271// Some special care is needed because <label>s don't inherit their parent's `cursor`.
272//
273// Note: Neither radios nor checkboxes can be readonly.
274input[type="radio"],
275input[type="checkbox"] {
276 &[disabled],
277 &.disabled,
278 fieldset[disabled] & {
279 cursor: $cursor-disabled;
280 }
281}
282// These classes are used directly on <label>s
283.radio-inline,
284.checkbox-inline {
285 &.disabled,
286 fieldset[disabled] & {
287 cursor: $cursor-disabled;
288 }
289}
290// These classes are used on elements with <label> descendants
291.radio,
292.checkbox {
293 &.disabled,
294 fieldset[disabled] & {
295 label {
296 cursor: $cursor-disabled;
297 }
298 }
299}
300
301
302// Static form control text
303//
304// Apply class to a `p` element to make any string of text align with labels in
305// a horizontal form layout.
306
307.form-control-static {
308 // Size it appropriately next to real form controls
309 padding-top: ($padding-base-vertical + 1);
310 padding-bottom: ($padding-base-vertical + 1);
311 // Remove default margin from `p`
312 margin-bottom: 0;
313 min-height: ($line-height-computed + $font-size-base);
314
315 &.input-lg,
316 &.input-sm {
317 padding-left: 0;
318 padding-right: 0;
319 }
320}
321
322
323// Form control sizing
324//
325// Build on `.form-control` with modifier classes to decrease or increase the
326// height and font-size of form controls.
327//
328// The `.form-group-* form-control` variations are sadly duplicated to avoid the
329// issue documented in https://github.com/twbs/bootstrap/issues/15074.
330
331@include input-size('.input-sm', $input-height-small, $padding-small-vertical, $padding-small-horizontal, $font-size-small, $line-height-small, $input-border-radius-small);
332.form-group-sm {
333 .form-control {
334 height: $input-height-small;
335 padding: $padding-small-vertical $padding-small-horizontal;
336 font-size: $font-size-small;
337 line-height: $line-height-small;
338 border-radius: $input-border-radius-small;
339 }
340 select.form-control {
341 height: $input-height-small;
342 line-height: $input-height-small;
343 }
344 textarea.form-control,
345 select[multiple].form-control {
346 height: auto;
347 }
348 .form-control-static {
349 height: $input-height-small;
350 min-height: ($line-height-computed + $font-size-small);
351 padding: ($padding-small-vertical + 1) $padding-small-horizontal;
352 font-size: $font-size-small;
353 line-height: $line-height-small;
354 }
355}
356
357@include input-size('.input-lg', $input-height-large, $padding-large-vertical, $padding-large-horizontal, $font-size-large, $line-height-large, $input-border-radius-large);
358.form-group-lg {
359 .form-control {
360 height: $input-height-large;
361 padding: $padding-large-vertical $padding-large-horizontal;
362 font-size: $font-size-large;
363 line-height: $line-height-large;
364 border-radius: $input-border-radius-large;
365 }
366 select.form-control {
367 height: $input-height-large;
368 line-height: $input-height-large;
369 }
370 textarea.form-control,
371 select[multiple].form-control {
372 height: auto;
373 }
374 .form-control-static {
375 height: $input-height-large;
376 min-height: ($line-height-computed + $font-size-large);
377 padding: ($padding-large-vertical + 1) $padding-large-horizontal;
378 font-size: $font-size-large;
379 line-height: $line-height-large;
380 }
381}
382
383
384// Form control feedback states
385//
386// Apply contextual and semantic states to individual form controls.
387
388.has-feedback {
389 // Enable absolute positioning
390 position: relative;
391
392 // Ensure icons don't overlap text
393 .form-control {
394 padding-right: ($input-height-base * 1.25);
395 }
396}
397// Feedback icon (requires .glyphicon classes)
398.form-control-feedback {
399 position: absolute;
400 top: 0;
401 right: 0;
402 z-index: 2; // Ensure icon is above input groups
403 display: block;
404 width: $input-height-base;
405 height: $input-height-base;
406 line-height: $input-height-base;
407 text-align: center;
408 pointer-events: none;
409}
410.input-lg + .form-control-feedback,
411.input-group-lg + .form-control-feedback,
412.form-group-lg .form-control + .form-control-feedback {
413 width: $input-height-large;
414 height: $input-height-large;
415 line-height: $input-height-large;
416}
417.input-sm + .form-control-feedback,
418.input-group-sm + .form-control-feedback,
419.form-group-sm .form-control + .form-control-feedback {
420 width: $input-height-small;
421 height: $input-height-small;
422 line-height: $input-height-small;
423}
424
425// Feedback states
426.has-success {
427 @include form-control-validation($state-success-text, $state-success-text, $state-success-bg);
428}
429.has-warning {
430 @include form-control-validation($state-warning-text, $state-warning-text, $state-warning-bg);
431}
432.has-error {
433 @include form-control-validation($state-danger-text, $state-danger-text, $state-danger-bg);
434}
435
436// Reposition feedback icon if input has visible label above
437.has-feedback label {
438
439 & ~ .form-control-feedback {
440 top: ($line-height-computed + 5); // Height of the `label` and its margin
441 }
442 &.sr-only ~ .form-control-feedback {
443 top: 0;
444 }
445}
446
447
448// Help text
449//
450// Apply to any element you wish to create light text for placement immediately
451// below a form control. Use for general help, formatting, or instructional text.
452
453.help-block {
454 display: block; // account for any element using help-block
455 margin-top: 5px;
456 margin-bottom: 10px;
457 color: lighten($text-color, 25%); // lighten the text some for contrast
458}
459
460
461// Inline forms
462//
463// Make forms appear inline(-block) by adding the `.form-inline` class. Inline
464// forms begin stacked on extra small (mobile) devices and then go inline when
465// viewports reach <768px.
466//
467// Requires wrapping inputs and labels with `.form-group` for proper display of
468// default HTML form controls and our custom form controls (e.g., input groups).
469//
470// Heads up! This is mixin-ed into `.navbar-form` in navbars.less.
471
472// [converter] extracted from `.form-inline` for libsass compatibility
473@mixin form-inline {
474
475 // Kick in the inline
476 @media (min-width: $screen-sm-min) {
477 // Inline-block all the things for "inline"
478 .form-group {
479 display: inline-block;
480 margin-bottom: 0;
481 vertical-align: middle;
482 }
483
484 // In navbar-form, allow folks to *not* use `.form-group`
485 .form-control {
486 display: inline-block;
487 width: auto; // Prevent labels from stacking above inputs in `.form-group`
488 vertical-align: middle;
489 }
490
491 // Make static controls behave like regular ones
492 .form-control-static {
493 display: inline-block;
494 }
495
496 .input-group {
497 display: inline-table;
498 vertical-align: middle;
499
500 .input-group-addon,
501 .input-group-btn,
502 .form-control {
503 width: auto;
504 }
505 }
506
507 // Input groups need that 100% width though
508 .input-group > .form-control {
509 width: 100%;
510 }
511
512 .control-label {
513 margin-bottom: 0;
514 vertical-align: middle;
515 }
516
517 // Remove default margin on radios/checkboxes that were used for stacking, and
518 // then undo the floating of radios and checkboxes to match.
519 .radio,
520 .checkbox {
521 display: inline-block;
522 margin-top: 0;
523 margin-bottom: 0;
524 vertical-align: middle;
525
526 label {
527 padding-left: 0;
528 }
529 }
530 .radio input[type="radio"],
531 .checkbox input[type="checkbox"] {
532 position: relative;
533 margin-left: 0;
534 }
535
536 // Re-override the feedback icon.
537 .has-feedback .form-control-feedback {
538 top: 0;
539 }
540 }
541}
542// [converter] extracted as `@mixin form-inline` for libsass compatibility
543.form-inline {
544 @include form-inline;
545}
546
547
548
549// Horizontal forms
550//
551// Horizontal forms are built on grid classes and allow you to create forms with
552// labels on the left and inputs on the right.
553
554.form-horizontal {
555
556 // Consistent vertical alignment of radios and checkboxes
557 //
558 // Labels also get some reset styles, but that is scoped to a media query below.
559 .radio,
560 .checkbox,
561 .radio-inline,
562 .checkbox-inline {
563 margin-top: 0;
564 margin-bottom: 0;
565 padding-top: ($padding-base-vertical + 1); // Default padding plus a border
566 }
567 // Account for padding we're adding to ensure the alignment and of help text
568 // and other content below items
569 .radio,
570 .checkbox {
571 min-height: ($line-height-computed + ($padding-base-vertical + 1));
572 }
573
574 // Make form groups behave like rows
575 .form-group {
576 @include make-row;
577 }
578
579 // Reset spacing and right align labels, but scope to media queries so that
580 // labels on narrow viewports stack the same as a default form example.
581 @media (min-width: $screen-sm-min) {
582 .control-label {
583 text-align: right;
584 margin-bottom: 0;
585 padding-top: ($padding-base-vertical + 1); // Default padding plus a border
586 }
587 }
588
589 // Validation states
590 //
591 // Reposition the icon because it's now within a grid column and columns have
592 // `position: relative;` on them. Also accounts for the grid gutter padding.
593 .has-feedback .form-control-feedback {
594 right: floor(($grid-gutter-width / 2));
595 }
596
597 // Form group sizes
598 //
599 // Quick utility class for applying `.input-lg` and `.input-sm` styles to the
600 // inputs and labels within a `.form-group`.
601 .form-group-lg {
602 @media (min-width: $screen-sm-min) {
603 .control-label {
604 padding-top: ($padding-large-vertical + 1);
605 font-size: $font-size-large;
606 }
607 }
608 }
609 .form-group-sm {
610 @media (min-width: $screen-sm-min) {
611 .control-label {
612 padding-top: ($padding-small-vertical + 1);
613 font-size: $font-size-small;
614 }
615 }
616 }
617}