Sass @mixin y @include

La directiva @mixin nos permite definir un estilo que se puede reutilizar en toda la hoja de estilos.

La directiva @include puede introducir un mixin en el documento.


Definir un mixin

Un mixin se define mediante la directiva @mixin. @mixin name { property: value; property: value; ... }

El siguiente ejemplo crea un mixin llamado "important-text":

Código Sass:

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

Nota:En Sass, el guion - y el guion bajo _ son equivalentes, es decir, @mixin important-text { } y @mixin important_text { } son el mismo mixin.

Usar mixins

La directiva @include se puede utilizar para incluir un mixin:

Sintaxis de @include mixin en Sass:

selector {
  @include mixin-name;
}

Por lo tanto, el código para incluir el mixin important-text es el siguiente:

Ejemplo

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

Convierte el código anterior a código CSS, como se muestra a continuación:

Código CSS:

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

Un mixin también puede incluir otros mixins, como se muestra a continuación:

Ejemplo

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

Pasar variables a un mixin

Los mixins pueden aceptar parámetros.

Podemos pasar variables a un mixin.

Definir un mixin que pueda aceptar parámetros:

Ejemplo

/* El mixin recibe dos parámetros */
@mixin bordered($color, $width) {
  border: $width solid $color;
}

.myArticle {
  @include bordered(blue, 1px);  // Llamar al mixin y pasar dos parámetros
}

.myNotes {
  @include bordered(red, 2px); // Llamar al mixin y pasar dos parámetros
}

Los parámetros del mixin en el ejemplo anterior establecen las propiedades del borde (color y width).

Convierte el código anterior a código CSS, como se muestra a continuación:

Código CSS:

.myArticle {
  border: 1px solid blue;
}

.myNotes {
  border: 2px solid red;
}

Los parámetros de un mixin también pueden definir valores predeterminados, la sintaxis es la siguiente:

Ejemplo

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

Al incluir un mixin, solo necesitas pasar los nombres de variables necesarios y sus valores:

Ejemplo

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

Convierte el código anterior a código CSS, como se muestra a continuación:

Código CSS:

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

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

Parámetros variables

A veces, no se puede determinar cuántos parámetros usará un mixin o una función, entonces podemos usar...para establecer parámetros variables.

Por ejemplo, un mixin para crear sombras de caja (box-shadow) puede tomar cualquier cantidad de box-shadow como parámetros.

Ejemplo

@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);
}

Convierte el código anterior a código CSS, como se muestra a continuación:

Código 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;
}

Mixins para prefijos de navegador

Usar mixins para prefijos de navegador también es muy conveniente, como en el siguiente ejemplo:

Ejemplo

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

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

Convierte el código anterior a código CSS, como se muestra a continuación:

Código CSS:

.myBox {
  -webkit-transform: rotate(20deg);
  -ms-transform: rotate(20deg);
  transform: rotate(20deg);
}
Otras extensiones