Sass @mixin и @include

Директива @mixin позволяет нам определить стиль, который можно повторно использовать во всей таблице стилей.

Директива @include может включать миксин в документ.


Определение миксина

Миксин определяется с помощью директивы @mixin. @mixin name { property: value; property: value; ... }

Следующий пример создаёт миксин с именем "important-text":

Код Sass:

@mixin important-text {
  color: red;
  font-size: 25px;
  font-weight: bold;
  border: 1px solid blue;
}

Примечание:В Sass дефис - и знак подчёркивания _ — одно и то же, то есть @mixin important-text { } и @mixin important_text { } — один и тот же миксин.

Использование миксина

Директиву @include можно использовать для подключения миксина:

Синтаксис @include миксина в Sass:

selector {
  @include mixin-name;
}

Следовательно, код для подключения миксина important-text выглядит так:

Пример

.danger {
  @include important-text;
  background-color: green;
}

Преобразуйте приведённый выше код в CSS-код, как показано ниже:

Код CSS:

.danger {
  color: red;
  font-size: 25px;
  font-weight: bold;
  border: 1px solid blue;
  background-color: green;
}

Миксин также может включать другие миксины, как показано ниже:

Пример

@mixin special-text {
  @include important-text;
  @include link;
  @include special-border;
}

Передача переменных в миксин

Миксины могут принимать параметры.

Мы можем передавать переменные в миксин.

Определите миксин, который может принимать параметры:

Пример

/* Миксин принимает два параметра */
@mixin bordered($color, $width) {
  border: $width solid $color;
}

.myArticle {
  @include bordered(blue, 1px);  // Вызовите миксин и передайте два параметра
}

.myNotes {
  @include bordered(red, 2px); // Вызовите миксин и передайте два параметра
}

Параметры миксина в приведённом выше примере — это свойства для установки границы (цвет и ширина).

Преобразуйте приведённый выше код в CSS-код, как показано ниже:

Код CSS:

.myArticle {
  border: 1px solid blue;
}

.myNotes {
  border: 2px solid red;
}

Параметры миксина также могут задавать значения по умолчанию, синтаксис следующий:

Пример

@mixin bordered($color: blue, $width: 1px) {
  border: $width solid $color;
}

При подключении миксина нужно только передать нужные имена переменных и их значения:

Пример

@mixin sexy-border($color, $width: 1in) {
  border: {
    color: $color;
    width: $width;
    style: dashed;
  }
}
p { @include sexy-border(blue); }
h1 { @include sexy-border(blue, 2in); }

Преобразуйте приведённый выше код в CSS-код, как показано ниже:

Код CSS:

p {
  border-color: blue;
  border-width: 1in;
  border-style: dashed; }

h1 {
  border-color: blue;
  border-width: 2in;
  border-style: dashed;
}

Аргументы переменной длины

Иногда, когда вы не можете определить, сколько параметров будет использовать миксин или функция, вы можете использовать..., чтобы задать переменные аргументы.

Например, миксин, используемый для создания box-shadow, может принимать любое количество значений box-shadow в качестве параметров.

Пример

@mixin box-shadow($shadows...) {
      -moz-box-shadow: $shadows;
      -webkit-box-shadow: $shadows;
      box-shadow: $shadows;
}

.shadows {
  @include box-shadow(0px 4px 5px #666, 2px 6px 10px #999);
}

Преобразуйте приведённый выше код в CSS-код, как показано ниже:

Код CSS:

.shadows {
  -moz-box-shadow: 0px 4px 5px #666, 2px 6px 10px #999;
  -webkit-box-shadow: 0px 4px 5px #666, 2px 6px 10px #999;
  box-shadow: 0px 4px 5px #666, 2px 6px 10px #999;
}

Использование миксинов для браузерных префиксов

Использование миксинов для браузерных префиксов также очень удобно, как в следующем примере:

Пример

@mixin transform($property) {
  -webkit-transform: $property;
  -ms-transform: $property;
  transform: $property;
}

.myBox {
  @include transform(rotate(20deg));
}

Преобразуйте приведённый выше код в CSS-код, как показано ниже:

Код CSS:

.myBox {
  -webkit-transform: rotate(20deg);
  -ms-transform: rotate(20deg);
  transform: rotate(20deg);
}
Другие расширения