| Current Path : /var/www/html/mediawiki-1.43.1/resources/src/mediawiki.less/ |
| Current File : /var/www/html/mediawiki-1.43.1/resources/src/mediawiki.less/mediawiki.mixins.less |
// Common LESS mixin library for MediaWiki
//
// By default the folder containing this file is included in the LESS import paths,
// which makes this file importable by all less files via `@import 'mediawiki.mixins.less';`.
//
// The mixins included below are considered a public interface for MediaWiki extensions.
// The signatures of parameterized mixins should be kept as stable as possible.
//
// See <http://lesscss.org/#-mixins> for more information about how to write mixins.
/* stylelint-disable selector-class-pattern */
// Deprecated in MW v1.43, use linear-gradient directly
.horizontal-gradient( @startColor: #808080, @endColor: #fff, @startPos: 0, @endPos: 100% ) {
background-color: average( @startColor, @endColor );
background-image: linear-gradient( to right, @startColor @startPos, @endColor @endPos );
}
// Deprecated in MW v1.43, use linear-gradient directly
.vertical-gradient( @startColor: #808080, @endColor: #fff, @startPos: 0, @endPos: 100% ) {
background-color: average( @startColor, @endColor );
background-image: linear-gradient( to bottom, @startColor @startPos, @endColor @endPos );
}
.hyphens( @value: auto ) {
& when ( @value = auto ) {
// Legacy `word-wrap`; Edge 12+, Firefox 3.5+, Chrome 4+, Safari 3.1+,
// Opera 11.5+, iOS 3.2+, Android 2.1+
// `overflow-wrap` is W3 standard, but it doesn't seem as if browser vendors
// will abandon `word-wrap` (it has wider support), therefore no duplication.
word-wrap: break-word;
}
& when ( @value = none ) {
word-wrap: normal;
}
// CSS3 hyphenation
// Chrome < 55 support "-webkit-hyphens: none",
// but not the "auto" property. It is advisable to set the @lang attribute
// on the HTML element to enable hyphenation support and improve accessibility.
// Chrome 55-87 only supports `auto` exclusively on Mac platform.
/* stylelint-disable plugin/no-unsupported-browser-features */
-webkit-hyphens: @value; // Safari 5.1+, iOS 4.2+
hyphens: @value; // Firefox 43+, Chrome 55+, Safari 17+, iOS 17+, Android 62+, UC Browser 11.8+, Samsung 6.2+
/* stylelint-enable plugin/no-unsupported-browser-features */
}
// Use to truncate overflow text with value of `ellipsis` (mixin default)
// a custom string (Firefox 9+ only).
// Recommended usage: `text-overflow( @visible: false )` for best readability.
.text-overflow( @visible: false, @value: ellipsis ) {
& when ( @visible = true ) {
overflow: visible;
text-overflow: clip;
white-space: normal;
}
& when ( @visible = false ) {
overflow: hidden;
text-overflow: @value;
white-space: nowrap;
}
}
// Enable (`text` or `element`) or prevent (`none`) text/element selection.
// Since MW 1.38
.user-select( @value ) {
-webkit-user-select: @value; // Chrome 4-53, Safari 3.1-, Opera 15-40
-moz-user-select: @value; // Firefox 2-68
user-select: @value;
}
// In the future this can be simply migrated to `margin-inline: @start @end;`
// Since MW 1.43
.margin-inline( @start, @end ) {
margin-left: @start;
margin-right: @end;
-webkit-margin-start: @start; // Archaic WebKit/Chrome versions
-webkit-margin-end: @end;
/* stylelint-disable declaration-block-no-redundant-longhand-properties */
margin-inline-start: @start; // Firefox 41, Safari 12.1, Chrome 69, Opera 56
margin-inline-end: @end;
/* stylelint-enable declaration-block-no-redundant-longhand-properties */
}
// In the future this can be simply migrated to `padding-inline: @start @end;`
// Since MW 1.43
.padding-inline( @start, @end ) {
padding-left: @start;
padding-right: @end;
-webkit-padding-start: @start; // Archaic WebKit/Chrome versions
-webkit-padding-end: @end;
/* stylelint-disable declaration-block-no-redundant-longhand-properties */
padding-inline-start: @start; // Firefox 41, Safari 12.1, Chrome 69, Opera 56
padding-inline-end: @end;
/* stylelint-enable declaration-block-no-redundant-longhand-properties */
}
// Not supported in Chrome <= 55, Firefox <= 31, Opera <= 41
.position-sticky() {
-webkit-position: sticky; // Support: Safari < 13
/* stylelint-disable-next-line plugin/no-unsupported-browser-features */
position: sticky;
}
.column-count( @value ) {
-moz-column-count: @value; // Firefox 2-51
column-count: @value; // Chrome 50+, Firefox 52+, Edge, Opera 11.5+, Android 90+
}
.column-width( @value ) {
-moz-column-width: @value; // Firefox 1.5-49
column-width: @value; // Chrome 50+, Firefox 50+, Edge, Opera 11.5+, Safari 9+
}
.column-break-inside-avoid() {
page-break-inside: avoid; // Firefox 1.5-91
break-inside: avoid-column; // Chrome 80+, Firefox 92+, Edge 80+, Safari 13.1+, Opera 67+
}
// Deprecated in MW v1.43.0, use just CSS property now.
.column-break-after-avoid() {
// Not supported by Firefox
break-after: avoid-column; // Chrome 80+, Firefox 92+, Edge 80+, Safari 13.1+, Opera 67+
}
.flex-display( @display: flex ) {
display: @display;
}
.flex-wrap( @wrap: wrap ) {
flex-wrap: @wrap;
}
.flex( @grow: 1, @shrink: 1, @width: auto, @order: 1 ) {
// Current spec
justify-content: space-between;
width: @width; // Fallback for flex-basis
flex: @grow @shrink @width;
order: @order;
}
// “Clearfix Reloaded” Mixin
// The mixin is used on a container with floating children.
// Margin collapsing is a feature, not a bug, hence relying on `display: block` as default.
// With `.mixin-clearfix( @collapse: false; );` you call it to let `margin`s not collapse.
// See https://www.cssmojo.com/the-very-latest-clearfix-reloaded/
// In future we might replace the `&:after` pseudo-element with
// `display: flow-root;` altogether.
// Support: Firefox 3.5+, Safari 4+, Chrome, Opera 15+
.mixin-clearfix( @collapse: true ) {
&::after {
clear: both;
// Margin collapsing as feature. Apply it.
& when ( @collapse ) {
content: '';
display: block;
}
}
// Margin collapsing as bug. Prevent it.
& when not ( @collapse ) {
&::before,
&::after {
content: '';
display: table;
}
}
}
/* stylelint-disable selector-no-vendor-prefix */
.mixin-placeholder( @rules ) {
// Chrome 4-56, WebKit, Blink, Edge 12-18
&::-webkit-input-placeholder {
@rules();
}
// W3C Standard Selectors Level 4
&::placeholder {
@rules();
}
}
/* stylelint-enable selector-no-vendor-prefix */
// 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;
}