1 // Common Less mixin library for MediaWiki
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';`.
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.
9 // See <http://lesscss.org/#-mixins> for more information about how to write mixins.
11 .background-image( @url ) {
12 background-image: e( '/* @embed */' ) url( @url );
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;
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
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
34 // We use gzip compression, which means that it is okay to embed twice.
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 );
43 // Shorthand for background-image-svg. Use if your PNG and SVG have the same name
44 // and only if you cannot use ResourceLoaderImage module for some particular reason.
45 .background-image-svg-quick( @url ) {
46 .background-image-svg( ~'@{url}.svg', ~'@{url}.png' );
49 .list-style-image( @url ) {
50 list-style-image: e( '/* @embed */' ) url( @url );
53 .list-style-image-svg( @svg, @fallback ) {
54 list-style-image: e( '/* @embed */' ) url( @svg );
55 /* Fallback to PNG bullet for IE 8 and below using CSS hack */
56 list-style-image: e( '/* @embed */' ) url( @fallback ) e( '\9' );
59 .hyphens( @value: auto ) {
60 & when ( @value = auto ){
61 // Legacy `word-wrap`; IE 6-11, Edge 12+, Firefox 3.5+, Chrome 4+, Safari 3.1+,
62 // Opera 11.5+, iOS 3.2+, Android 2.1+
63 // `overflow-wrap` is W3 standard, but it doesn't seem as if browser vendors
64 // will abandon `word-wrap` (it has wider support), therefore no duplication.
65 word-wrap: break-word;
67 & when ( @value = none ) {
72 -webkit-hyphens: @value; // Safari 5.1+, iOS 4.3+
73 -moz-hyphens: @value; // Firefox 6-42
74 -ms-hyphens: @value; // IE 10-11, Edge 12+
75 hyphens: @value; // Firefox 43+, Chrome 55+, Android 62+, UC Browser 11.8+, Samsung 6.2+
78 .transform( @value ) {
79 -webkit-transform: @value; // Safari 3.1-8.0, iOS 3.2-8.4, Android 2.1-4.4.4
80 -moz-transform: @value; // Firefox 3.5-15
81 transform: @value; // Chrome 36+, Firefox 16+, IE 10+, Safari 9+, Opera 23+, iOS 9.2+, Android 5+
84 .transition( @value ) {
85 -webkit-transition: @value; // Safari 3.1-6.0, iOS 3.2-6.1, Android 2.1-4.3
86 -moz-transition: @value; // Firefox 4-15
87 transition: @value; // Chrome 26+, Firefox 16+, IE 10+, Safari 6.1+, Opera 12.1+, iOS 7+, Android 4.4+
90 // Provide a hardware accelerated transform transition
91 // We can't use `.transition()` because WebKit requires `-webkit-` prefix before `transform`
92 // Example usage: `.transition-transform( 1s, opacity 2s );`
93 // First parameter is additional options for `transform` transition commencing with
94 // duration property @see https://www.w3.org/TR/css3-transitions/#transition-duration-property
95 // and remaining parameters are additional transitions."
96 .transition-transform( ... ) {
97 -webkit-backface-visibility: hidden; // Older Webkit browsers: Promote element to a composite layer & involve the GPU
99 -webkit-transition: -webkit-transform @arguments; // Safari 3.1-8, iOS 3.2-8.4, Android 2.1-4.4.4
100 -moz-transition: -moz-transform @arguments; // Firefox 4-15 for `-moz-transition`
101 transition: transform @arguments; // Chrome 36+, Firefox 16+, IE 10+, Safari 9+, Opera 12.1+, iOS 9.2+, Android 36+
104 .box-sizing( @value ) {
105 -webkit-box-sizing: @value; // Safari 3.1-5.0, iOS 3.2-4.3, Android 2.1-3.0
106 -moz-box-sizing: @value; // Firefox 4-28,
107 box-sizing: @value; // Chrome 10+, Firefox 29+, IE 8+, Safari 5.1+, Opera 10+, iOS 5+, Android 4+
110 .box-shadow( @value ) {
111 -webkit-box-shadow: @value; // Safari 3.1-5.0, iOS 3.2-4.3, Android 2.1-3.0
112 box-shadow: @value; // Chrome 10+, Firefox 4+, IE 9+, Safari 5.1+, Opera 11+, iOS 5+, Android 4+
115 .column-count( @value ) {
116 -webkit-column-count: @value;
117 -moz-column-count: @value;
118 column-count: @value;
121 .column-width( @value ) {
122 -webkit-column-width: @value; // Chrome Any, Safari 3+, Opera 15+
123 -moz-column-width: @value; // Firefox 1.5+
124 column-width: @value; // IE 10+, Opera 11.1-12.1
127 .column-break-inside-avoid() {
128 -webkit-column-break-inside: avoid; // Chrome Any, Safari 3+, Opera 15+
129 page-break-inside: avoid; // Firefox 1.5+
130 break-inside: avoid-column; // IE 10+, Opera 11.1-12.1
133 .flex-display( @display: flex ) {
134 display: ~'-webkit-@{display}'; // iOS 6-, Safari 3.1-6
135 display: ~'-moz-@{display}'; // Firefox 21-
136 display: ~'-ms-@{display}box'; // IE 10
140 .flex-wrap( @wrap: wrap ) {
141 -webkit-flex-wrap: @wrap; // iOS 6-, Safari 3.1-6
142 -moz-flex-wrap: @wrap; // Firefox 21-
143 -ms-flex-wrap: @wrap; // IE 10
147 .flex( @grow: 1, @shrink: 1, @width: auto, @order: 1 ) {
148 // For 2009/2012 spec alignment consistency with current default
149 -webkit-box-pack: justify; // iOS 6-, Safari 3.1-6
150 -moz-box-pack: justify; // Firefox 21-
151 -ms-flex-pack: justify; // IE 10 (2012 spec)
152 justify-content: space-between; // Current default
154 // 2009 spec only supports 'flexible' as opposed to grow (flexPositive)
155 // and shrink (flexNegative); default to grow value
156 -webkit-box-flex: @grow; // iOS 6-, Safari 3.1-6
157 -moz-box-flex: @grow; // Firefox 21-
158 width: @width; // Fallback for flex-basis
160 -ms-flex: @grow @shrink @width; // IE 10
161 flex: @grow @shrink @width;
163 -webkit-box-ordinal-group: @order; // iOS 6-, Safari 3.1-6
164 -moz-box-ordinal-group: @order; // Firefox 21-
165 -ms-flex-order: @order; // IE 10
169 /* stylelint-disable selector-no-vendor-prefix, at-rule-no-unknown */
170 .mixin-placeholder( @rules ) {
171 // WebKit, Blink, Edge
172 &::-webkit-input-placeholder {
175 // Internet Explorer 10-11
176 &:-ms-input-placeholder {
180 &::-moz-placeholder {
187 // W3C Standard Selectors Level 4
192 /* stylelint-enable selector-no-vendor-prefix, at-rule-no-unknown */
194 // Screen Reader Helper Mixin
195 .mixin-screen-reader-text() {
197 position: absolute !important; /* stylelint-disable-line declaration-no-important */
198 clip: rect( 1px, 1px, 1px, 1px );