resources/src/mediawiki.ui/components/checkbox.less

   1 @import "mediawiki.mixins";
   2 @import "mediawiki.ui/variables";
   3
   4 // Checkbox
   5 //
   6 // Styling checkboxes in a way that works cross browser is a tricky problem to solve.
   7 // In MediaWiki UI put a checkbox and label inside a mw-ui-checkbox div.
   8 // This renders in all browsers except IE6-8 which do not support the :checked selector;
   9 // these are kept backwards-compatible using the :not(#noop) selector.
  10 // You should give the checkbox and label matching "id" and "for" attributes, respectively.
  11 //
  12 // Markup:
  13 // <div class="mw-ui-checkbox">
  14 //   <input type="checkbox" id="kss-example-5"><label for="kss-example-5">Standard checkbox</label>
  15 // </div>
  16 // <div class="mw-ui-checkbox">
  17 //   <input type="checkbox" id="kss-example-5-2" disabled><label for="kss-example-5-2">Disabled checkbox</label>
  18 // </div>
  19 //
  20 // Styleguide 5.
  21 .mw-ui-checkbox {
  22         display: inline-block;
  23         vertical-align: middle;
  24 }
  25
  26 @checkboxSize: 1.6em;
  27
  28 // We use the not selector to cancel out styling on IE 8 and below
  29 .mw-ui-checkbox:not(#noop) {
  30         // Position relatively so we can make use of absolute pseudo elements
  31         position: relative;
  32         line-height: @checkboxSize;
  33
  34         * {
  35                 vertical-align: middle;
  36         }
  37
  38         input[type="checkbox"] {
  39                 // we hide the input element as instead we will style the label that follows
  40                 // we use opacity so that VoiceOver software can still identify it
  41                 opacity: 0;
  42                 // ensure the invisible checkbox takes up the required width
  43                 width: @checkboxSize;
  44                 height: @checkboxSize;
  45
  46                 // the pseudo before element of the label after the checkbox now looks like a checkbox
  47                 & + label {
  48                         cursor: pointer;
  49                         margin: 0 .4em;
  50
  51                         &::before {
  52                                                 content: '';
  53                                                 position: absolute;
  54                                                 left: 0;
  55                                                 display: inline-block;
  56                                                 border-radius: @borderRadius;
  57                                                 margin-right: 18px;
  58                                                 width: @checkboxSize;
  59                                                 height: @checkboxSize;
  60                                                 background-color: #fff;
  61                                                 border: 1px solid grey;
  62                                         }
  63                 }
  64
  65                 // when the input is checked, style the label pseudo before element that followed as a checked checkbox
  66                 &:checked {
  67                         + label {
  68                                 &::before {
  69                                         .background-image-svg('images/checked.svg', 'images/checked.png');
  70                                         .background-size( @checkboxSize, @checkboxSize );
  71                                         background-repeat: no-repeat;
  72                                         background-position: center top;
  73                                 }
  74                         }
  75                 }
  76
  77                 @focusBottomBorderSize: 0.2em;
  78                 &:active,
  79                 &:focus {
  80                         + label {
  81                                 &::after {
  82                                         content: '';
  83                                         position: absolute;
  84                                         width: @checkboxSize;
  85                                         height: @checkboxSize - @focusBottomBorderSize + 0.08; // offset by bottom border
  86                                         // offset from the checkbox by 1px to account for left border
  87                                         left: 1px;
  88                                         border-bottom: solid @focusBottomBorderSize lightgrey;
  89                                 }
  90                         }
  91                 }
  92
  93                 // disabled checked boxes have a gray background
  94                 &:disabled + label {
  95                         cursor: default;
  96
  97                         &::before {
  98                                 background-color: lightgrey;
  99                         }
 100                 }
 101         }
 102 }