resources/src/mediawiki.less/mediawiki.mixins.less

   1 // Common Less mixin library for MediaWiki
   2 //
   3 // By default the folder containing this file is included in $wgResourceLoaderLESSImportPaths,
   4 // which makes this file importable by all less files via `@import 'mediawiki.mixins';`.
   5 //
   6 // The mixins included below are considered a public interface for MediaWiki extensions.
   7 // The signatures of parametrized mixins should be kept as stable as possible.
   8 //
   9 // See <http://lesscss.org/#-mixins> for more information about how to write mixins.
  10
  11 .background-image( @url ) {
  12         background-image: e( '/* @embed */' ) url( @url );
  13 }
  14
  15 // Deprecated in MW 1.27
  16 .background-size( @width, @height ) {
  17         // Vendor prefix is added to support Android 2
  18         -webkit-background-size: @width @height;
  19         background-size: @width @height;
  20 }
  21
  22 .vertical-gradient( @startColor: gray, @endColor: white, @startPos: 0, @endPos: 100% ) {
  23         background-color: @endColor;
  24         background-image: -webkit-gradient( linear, left top, left bottom, color-stop( @startPos, @startColor ), color-stop( @endPos, @endColor ) ); // Safari 4+, Chrome 2+
  25         background-image: -webkit-linear-gradient( top, @startColor @startPos, @endColor @endPos ); // Safari 5.1+, Chrome 10+
  26         background-image: -moz-linear-gradient( top, @startColor @startPos, @endColor @endPos ); // Firefox 3.6+
  27         background-image: linear-gradient( @startColor @startPos, @endColor @endPos ); // Standard
  28 }
  29
  30 // SVG support using a transparent gradient to guarantee cross-browser
  31 // compatibility (browsers able to understand gradient syntax support also SVG).
  32 // http://pauginer.tumblr.com/post/36614680636/invisible-gradient-technique
  33 //
  34 // We use gzip compression, which means that it is okay to embed twice.
  35 //
  36 // We do not embed the fallback image on the assumption that the gain for old browsers
  37 // is not worth the harm done to modern ones.
  38 .background-image-svg( @svg, @fallback ) {
  39         background-image: url( @fallback );
  40         background-image: linear-gradient( transparent, transparent ), e( '/* @embed */' ) url( @svg );
  41         // Do not serve SVG to Opera 12, bad rendering with border-radius or background-size (T87504)
  42         background-image: -o-linear-gradient( transparent, transparent ), url( @fallback );
  43 }
  44
  45 // Shorthand for background-image-svg. Use if your PNG and SVG have the same name
  46 // and only if you cannot use ResourceLoaderImage module for some particular reason.
  47 .background-image-svg-quick( @url ) {
  48         .background-image-svg( ~'@{url}.svg', ~'@{url}.png' );
  49 }
  50
  51 .list-style-image( @url ) {
  52         list-style-image: e( '/* @embed */' ) url( @url );
  53 }
  54
  55 .list-style-image-svg( @svg, @fallback ) {
  56         list-style-image: e( '/* @embed */' ) url( @svg );
  57         /* Fallback to PNG bullet for IE 8 and below using CSS hack */
  58         list-style-image: e( '/* @embed */' ) url( @fallback ) e( '\9' );
  59 }
  60
  61 .transition( @value ) {
  62         -webkit-transition: @value; // Safari 3.1-6.0, iOS 3.2-6.1, Android 2.1-4.3
  63         -moz-transition: @value; // Firefox 4-15
  64         transition: @value; // Chrome 26+, Firefox 16+, IE 10+, Safari 6.1+, Opera 12.1+, iOS 7+, Android 4.4+
  65 }
  66
  67 .box-sizing( @value ) {
  68         -webkit-box-sizing: @value; // Safari 3.1-5.0, iOS 3.2-4.3, Android 2.1-3.0
  69         -moz-box-sizing: @value; // Firefox 4-28,
  70         box-sizing: @value; // Chrome 10+, Firefox 29+, IE 8+, Safari 5.1+, Opera 10+, iOS 5+, Android 4+
  71 }
  72
  73 .box-shadow( @value ) {
  74         -webkit-box-shadow: @value; // Safari 3.1-5.0, iOS 3.2-4.3, Android 2.1-3.0
  75         box-shadow: @value; // Chrome 10+, Firefox 4+, IE 9+, Safari 5.1+, Opera 11+, iOS 5+, Android 4+
  76 }
  77
  78 .column-count( @value ) {
  79         -webkit-column-count: @value;
  80         -moz-column-count: @value;
  81         column-count: @value;
  82 }
  83
  84 .column-width( @value ) {
  85         -webkit-column-width: @value; // Chrome Any, Safari 3+, Opera 15+
  86         -moz-column-width: @value; // Firefox 1.5+
  87         column-width: @value; // IE 10+, Opera 11.1-12.1
  88 }
  89
  90 .column-break-inside-avoid() {
  91         -webkit-column-break-inside: avoid; // Chrome Any, Safari 3+, Opera 15+
  92         page-break-inside: avoid; // Firefox 1.5+
  93         break-inside: avoid-column; // IE 10+, Opera 11.1-12.1
  94 }
  95
  96 .flex-display( @display: flex ) {
  97         display: ~'-webkit-@{display}'; // iOS 6-, Safari 3.1-6
  98         display: ~'-moz-@{display}'; // Firefox 21-
  99         display: ~'-ms-@{display}box'; // IE 10
 100         display: @display;
 101 }
 102
 103 .flex-wrap( @wrap: wrap ) {
 104         -webkit-flex-wrap: @wrap; // iOS 6-, Safari 3.1-6
 105         -moz-flex-wrap: @wrap; // Firefox 21-
 106         -ms-flex-wrap: @wrap; // IE 10
 107         flex-wrap: @wrap;
 108 }
 109
 110 .flex( @grow: 1, @shrink: 1, @width: auto, @order: 1 ) {
 111         // For 2009/2012 spec alignment consistency with current default
 112         -webkit-box-pack: justify; // iOS 6-, Safari 3.1-6
 113         -moz-box-pack: justify; // Firefox 21-
 114         -ms-flex-pack: justify; // IE 10 (2012 spec)
 115         justify-content: space-between; // Current default
 116
 117         // 2009 spec only supports 'flexible' as opposed to grow (flexPositive)
 118         // and shrink (flexNegative); default to grow value
 119         -webkit-box-flex: @grow; // iOS 6-, Safari 3.1-6
 120         -moz-box-flex: @grow; // Firefox 21-
 121         width: @width; // Fallback for flex-basis
 122
 123         -ms-flex: @grow @shrink @width; // IE 10
 124         flex: @grow @shrink @width;
 125
 126         -webkit-box-ordinal-group: @order; // iOS 6-, Safari 3.1-6
 127         -moz-box-ordinal-group: @order; // Firefox 21-
 128         -ms-flex-order: @order; // IE 10
 129         order: @order;
 130 }
 131
 132 /* stylelint-disable selector-no-vendor-prefix, at-rule-no-unknown */
 133 .mixin-placeholder( @rules ) {
 134         // WebKit, Blink, Edge
 135         &::-webkit-input-placeholder {
 136                 @rules();
 137         }
 138         // Internet Explorer 10-11
 139         &:-ms-input-placeholder {
 140                 @rules();
 141         }
 142         // Firefox 19-
 143         &::-moz-placeholder {
 144                 @rules();
 145         }
 146         // Firefox 4-18
 147         &:-moz-placeholder {
 148                 @rules();
 149         }
 150         // W3C Standard Selectors Level 4
 151         &::placeholder {
 152                 @rules();
 153         }
 154         // For inputs that use jquery.placeholder.js e.g. IE9
 155         &.placeholder {
 156                 @rules();
 157         }
 158 }
 159 /* stylelint-enable selector-no-vendor-prefix, at-rule-no-unknown */
 160
 161 // Screen Reader Helper Mixin
 162 .mixin-screen-reader-text() {
 163         display: block;
 164         position: absolute !important; /* stylelint-disable-line declaration-no-important */
 165         clip: rect( 1px, 1px, 1px, 1px );
 166         width: 1px;
 167         height: 1px;
 168         margin: -1px;
 169         border: 0;
 170         padding: 0;
 171         overflow: hidden;
 172 }