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 .background-size(@width, @height) {
  16         // Vendor prefix for certain older opera browsers e.g. nintendo ds
  17         -o-background-size: @width @height;
  18         // Vendor prefix is added to support Android 2
  19         -webkit-background-size: @width @height;
  20         background-size: @width @height;
  21 }
  22
  23
  24 .vertical-gradient(@startColor: gray, @endColor: white, @startPos: 0, @endPos: 100%) {
  25         background-color: @endColor;
  26         background-image: -moz-linear-gradient( top, @startColor @startPos, @endColor @endPos ); // Firefox 3.6+
  27         background-image: -webkit-gradient( linear, left top, left bottom, color-stop( @startPos, @startColor ), color-stop( @endPos, @endColor ) ); // Safari 4+, Chrome 2+
  28         background-image: -webkit-linear-gradient( top, @startColor @startPos, @endColor @endPos ); // Safari 5.1+, Chrome 10+
  29         background-image: linear-gradient( @startColor @startPos, @endColor @endPos ); // Standard
  30 }
  31
  32 // SVG support using a transparent gradient to guarantee cross-browser
  33 // compatibility (browsers able to understand gradient syntax support also SVG).
  34 // http://pauginer.tumblr.com/post/36614680636/invisible-gradient-technique
  35 //
  36 // We use gzip compression, which means that it is okay to embed twice.
  37 //
  38 // We do not embed the fallback image on the assumption that the gain for old browsers
  39 // is not worth the harm done to modern ones.
  40 .background-image-svg(@svg, @fallback) {
  41         background-image: url(@fallback);
  42         background-image: linear-gradient(transparent, transparent), e('/* @embed */') url(@svg);
  43         // Do not serve SVG to Opera 12, bad rendering with border-radius or background-size (T87504)
  44         background-image: -o-linear-gradient(transparent, transparent), url(@fallback);
  45 }
  46
  47 .list-style-image(@url) {
  48         list-style-image: e('/* @embed */') url(@url);
  49 }
  50
  51 .list-style-image-svg(@svg, @fallback) {
  52         list-style-image: e('/* @embed */') url(@svg);
  53         /* Fallback to PNG bullet for IE 8 and below using CSS hack */
  54         list-style-image: e('/* @embed */') url(@fallback) e('\9');
  55 }
  56
  57 .transition(@value) {
  58         -webkit-transition: @value; // Safari 3.1-6.0, iOS 3.2-6.1, Android 2.1-4.3
  59         -moz-transition: @value; // Firefox 4-15
  60         -o-transition: @value; // Opera 10.5-12.0
  61         transition: @value; // Chrome 26+, Firefox 16+, IE 10+, Safari 6.1+, Opera 12.1+, iOS 7+, Android 4.4+
  62 }
  63
  64 .box-sizing(@value) {
  65         -webkit-box-sizing: @value; // Safari 3.1-5.0, iOS 3.2-4.3, Android 2.1-3.0
  66         -moz-box-sizing: @value; // Firefox 4-28,
  67         box-sizing: @value; // Chrome 10+, Firefox 29+, IE 8+, Safari 5.1+, Opera 10+, iOS 5+, Android 4+
  68 }
  69
  70 .box-shadow(@value) {
  71         -webkit-box-shadow: @value; // Safari 3.1-5.0, iOS 3.2-4.3, Android 2.1-3.0
  72         box-shadow: @value; // Chrome 10+, Firefox 4+, IE 9+, Safari 5.1+, Opera 11+, iOS 5+, Android 4+
  73 }
  74
  75 .column-count(@value) {
  76         -webkit-column-count: @value;
  77         -moz-column-count: @value;
  78         column-count: @value;
  79 }
  80
  81 .column-width(@value) {
  82         -webkit-column-width: @value; // Chrome Any, Safari 3+, Opera 11.1+
  83         -moz-column-width: @value; // Firefox 1.5+
  84         column-width: @value; // IE 10+
  85 }
  86
  87 .column-break-inside-avoid() {
  88         -webkit-column-break-inside: avoid; // Chrome Any, Safari 3+, Opera 11.1+
  89         page-break-inside: avoid; // Firefox 1.5+
  90         break-inside: avoid-column; // IE 10+
  91 }
  92
  93 .flex-display(@display: flex) {
  94         display: ~"-webkit-@{display}"; // iOS 6-, Safari 3.1-6
  95         display: ~"-moz-@{display}"; // Firefox 21-
  96         display: ~"-ms-@{display}box"; // IE 10
  97         display: @display;
  98 }
  99
 100 .flex(@grow: 1, @shrink: 1, @width: auto, @order: 1) {
 101         // For 2009/2012 spec alignment consistency with current default
 102         -webkit-box-pack: justify; // iOS 6-, Safari 3.1-6
 103         -moz-box-pack: justify; // Firefox 21-
 104         -ms-flex-pack: justify; // IE10 (2012 spec)
 105         justify-content: space-between; // Current default
 106
 107         // 2009 spec only supports 'flexible' as opposed to grow (flexPositive)
 108         // and shrink (flexNegative); default to grow value
 109         -webkit-box-flex: @grow; // iOS 6-, Safari 3.1-6
 110         -moz-box-flex: @grow; // Firefox 21-
 111         width: @width; // Fallback for flex-basis
 112
 113         -ms-flex: @grow @shrink @width; // IE10
 114         flex: @grow @shrink @width;
 115
 116         -webkit-box-ordinal-group: @order; // iOS 6-, Safari 3.1-6
 117         -moz-box-ordinal-group: @order; // Firefox 21-
 118         -ms-flex-order: @order; // IE10
 119         order: @order;
 120 }