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:
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:
@include mixin-name;
}
Por lo tanto, el código para incluir el mixin important-text es el siguiente:
Ejemplo
@include important-text;
background-color: green;
}
Convierte el código anterior a código CSS, como se muestra a continuación:
Código CSS:
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
@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
@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:
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
border: $width solid $color;
}
Al incluir un mixin, solo necesitas pasar los nombres de variables necesarios y sus valores:
Ejemplo
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:
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
-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:
-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
-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:
-webkit-transform: rotate(20deg);
-ms-transform: rotate(20deg);
transform: rotate(20deg);
}