]> scripts.mit.edu Git - autoinstallsdev/mediawiki.git/blobdiff - resources/src/mediawiki.less/mediawiki.mixins.less
MediaWiki 1.30.2
[autoinstallsdev/mediawiki.git] / resources / src / mediawiki.less / mediawiki.mixins.less
diff --git a/resources/src/mediawiki.less/mediawiki.mixins.less b/resources/src/mediawiki.less/mediawiki.mixins.less
new file mode 100644 (file)
index 0000000..fb3b00e
--- /dev/null
@@ -0,0 +1,192 @@
+// Common Less mixin library for MediaWiki
+//
+// By default the folder containing this file is included in $wgResourceLoaderLESSImportPaths,
+// which makes this file importable by all less files via `@import 'mediawiki.mixins';`.
+//
+// The mixins included below are considered a public interface for MediaWiki extensions.
+// The signatures of parametrized mixins should be kept as stable as possible.
+//
+// See <http://lesscss.org/#-mixins> for more information about how to write mixins.
+
+.background-image( @url ) {
+       background-image: e( '/* @embed */' ) url( @url );
+}
+
+// Deprecated in MW 1.27
+.background-size( @width, @height ) {
+       // Vendor prefix is added to support Android 2
+       -webkit-background-size: @width @height;
+       background-size: @width @height;
+}
+
+.vertical-gradient( @startColor: gray, @endColor: white, @startPos: 0, @endPos: 100% ) {
+       background-color: @endColor;
+       background-image: -webkit-gradient( linear, left top, left bottom, color-stop( @startPos, @startColor ), color-stop( @endPos, @endColor ) ); // Safari 4+, Chrome 2+
+       background-image: -webkit-linear-gradient( top, @startColor @startPos, @endColor @endPos ); // Safari 5.1+, Chrome 10+
+       background-image: -moz-linear-gradient( top, @startColor @startPos, @endColor @endPos ); // Firefox 3.6+
+       background-image: linear-gradient( @startColor @startPos, @endColor @endPos ); // Standard
+}
+
+// SVG support using a transparent gradient to guarantee cross-browser
+// compatibility (browsers able to understand gradient syntax support also SVG).
+// http://pauginer.tumblr.com/post/36614680636/invisible-gradient-technique
+//
+// We use gzip compression, which means that it is okay to embed twice.
+//
+// We do not embed the fallback image on the assumption that the gain for old browsers
+// is not worth the harm done to modern ones.
+.background-image-svg( @svg, @fallback ) {
+       background-image: url( @fallback );
+       background-image: linear-gradient( transparent, transparent ), e( '/* @embed */' ) url( @svg );
+       // Do not serve SVG to Opera 12, bad rendering with border-radius or background-size (T87504)
+       background-image: -o-linear-gradient( transparent, transparent ), url( @fallback );
+}
+
+// Shorthand for background-image-svg. Use if your PNG and SVG have the same name
+// and only if you cannot use ResourceLoaderImage module for some particular reason.
+.background-image-svg-quick( @url ) {
+       .background-image-svg( ~'@{url}.svg', ~'@{url}.png' );
+}
+
+.list-style-image( @url ) {
+       list-style-image: e( '/* @embed */' ) url( @url );
+}
+
+.list-style-image-svg( @svg, @fallback ) {
+       list-style-image: e( '/* @embed */' ) url( @svg );
+       /* Fallback to PNG bullet for IE 8 and below using CSS hack */
+       list-style-image: e( '/* @embed */' ) url( @fallback ) e( '\9' );
+}
+
+.transform( @value ) {
+       -webkit-transform: @value; // Safari 3.1-8.0, iOS 3.2-8.4, Android 2.1-4.4.4
+       -moz-transform: @value; // Firefox 3.5-15
+       transform: @value; // Chrome 36+, Firefox 16+, IE 10+, Safari 9+, Opera 23+, iOS 9.2+, Android 5+
+}
+
+.transition( @value ) {
+       -webkit-transition: @value; // Safari 3.1-6.0, iOS 3.2-6.1, Android 2.1-4.3
+       -moz-transition: @value; // Firefox 4-15
+       transition: @value; // Chrome 26+, Firefox 16+, IE 10+, Safari 6.1+, Opera 12.1+, iOS 7+, Android 4.4+
+}
+
+// Provide a hardware accelerated transform transition
+// We can't use `.transition()` because WebKit requires `-webkit-` prefix before `transform`
+// Example usage: `.transition-transform( 1s, opacity 2s );`
+// First parameter is additional options for `transform` transition commencing with
+// duration property @see https://www.w3.org/TR/css3-transitions/#transition-duration-property
+// and remaining parameters are additional transitions."
+.transition-transform( ... ) {
+       -webkit-backface-visibility: hidden; // Older Webkit browsers: Promote element to a composite layer & involve the GPU
+
+       -webkit-transition: -webkit-transform @arguments; // Safari 3.1-8, iOS 3.2-8.4, Android 2.1-4.4.4
+       -moz-transition: -moz-transform @arguments; // Firefox 4-15 for `-moz-transition`
+       transition: transform @arguments; // Chrome 36+, Firefox 16+, IE 10+, Safari 9+, Opera 12.1+, iOS 9.2+, Android 36+
+}
+
+.box-sizing( @value ) {
+       -webkit-box-sizing: @value; // Safari 3.1-5.0, iOS 3.2-4.3, Android 2.1-3.0
+       -moz-box-sizing: @value; // Firefox 4-28,
+       box-sizing: @value; // Chrome 10+, Firefox 29+, IE 8+, Safari 5.1+, Opera 10+, iOS 5+, Android 4+
+}
+
+.box-shadow( @value ) {
+       -webkit-box-shadow: @value; // Safari 3.1-5.0, iOS 3.2-4.3, Android 2.1-3.0
+       box-shadow: @value; // Chrome 10+, Firefox 4+, IE 9+, Safari 5.1+, Opera 11+, iOS 5+, Android 4+
+}
+
+.column-count( @value ) {
+       -webkit-column-count: @value;
+       -moz-column-count: @value;
+       column-count: @value;
+}
+
+.column-width( @value ) {
+       -webkit-column-width: @value; // Chrome Any, Safari 3+, Opera 15+
+       -moz-column-width: @value; // Firefox 1.5+
+       column-width: @value; // IE 10+, Opera 11.1-12.1
+}
+
+.column-break-inside-avoid() {
+       -webkit-column-break-inside: avoid; // Chrome Any, Safari 3+, Opera 15+
+       page-break-inside: avoid; // Firefox 1.5+
+       break-inside: avoid-column; // IE 10+, Opera 11.1-12.1
+}
+
+.flex-display( @display: flex ) {
+       display: ~'-webkit-@{display}'; // iOS 6-, Safari 3.1-6
+       display: ~'-moz-@{display}'; // Firefox 21-
+       display: ~'-ms-@{display}box'; // IE 10
+       display: @display;
+}
+
+.flex-wrap( @wrap: wrap ) {
+       -webkit-flex-wrap: @wrap; // iOS 6-, Safari 3.1-6
+       -moz-flex-wrap: @wrap; // Firefox 21-
+       -ms-flex-wrap: @wrap; // IE 10
+       flex-wrap: @wrap;
+}
+
+.flex( @grow: 1, @shrink: 1, @width: auto, @order: 1 ) {
+       // For 2009/2012 spec alignment consistency with current default
+       -webkit-box-pack: justify; // iOS 6-, Safari 3.1-6
+       -moz-box-pack: justify; // Firefox 21-
+       -ms-flex-pack: justify; // IE 10 (2012 spec)
+       justify-content: space-between; // Current default
+
+       // 2009 spec only supports 'flexible' as opposed to grow (flexPositive)
+       // and shrink (flexNegative); default to grow value
+       -webkit-box-flex: @grow; // iOS 6-, Safari 3.1-6
+       -moz-box-flex: @grow; // Firefox 21-
+       width: @width; // Fallback for flex-basis
+
+       -ms-flex: @grow @shrink @width; // IE 10
+       flex: @grow @shrink @width;
+
+       -webkit-box-ordinal-group: @order; // iOS 6-, Safari 3.1-6
+       -moz-box-ordinal-group: @order; // Firefox 21-
+       -ms-flex-order: @order; // IE 10
+       order: @order;
+}
+
+/* stylelint-disable selector-no-vendor-prefix, at-rule-no-unknown */
+.mixin-placeholder( @rules ) {
+       // WebKit, Blink, Edge
+       &::-webkit-input-placeholder {
+               @rules();
+       }
+       // Internet Explorer 10-11
+       &:-ms-input-placeholder {
+               @rules();
+       }
+       // Firefox 19-
+       &::-moz-placeholder {
+               @rules();
+       }
+       // Firefox 4-18
+       &:-moz-placeholder {
+               @rules();
+       }
+       // W3C Standard Selectors Level 4
+       &::placeholder {
+               @rules();
+       }
+       // For inputs that use jquery.placeholder.js e.g. IE9
+       &.placeholder {
+               @rules();
+       }
+}
+/* stylelint-enable selector-no-vendor-prefix, at-rule-no-unknown */
+
+// Screen Reader Helper Mixin
+.mixin-screen-reader-text() {
+       display: block;
+       position: absolute !important; /* stylelint-disable-line declaration-no-important */
+       clip: rect( 1px, 1px, 1px, 1px );
+       width: 1px;
+       height: 1px;
+       margin: -1px;
+       border: 0;
+       padding: 0;
+       overflow: hidden;
+}