Sass @mixin et @include
La directive @mixin permet de définir un style qui peut être réutilisé dans toute la feuille de style.
La directive @include peut inclure un mixin dans le document.
Définition d'un mixin
Un mixin est défini à l'aide de la directive @mixin. @mixin name { property: value; property: value; ... }L'exemple suivant crée un mixin nommé "important-text" :
Code Sass :
color: red;
font-size: 25px;
font-weight: bold;
border: 1px solid blue;
}
Remarque :En Sass, le tiret - et le trait de soulignement _ sont identiques, ce qui signifie que @mixin important-text { } et @mixin important_text { } sont le même mixin.
Utilisation d'un mixin
La directive @include peut être utilisée pour inclure un mixin :
Syntaxe de @include mixin en Sass :
@include mixin-name;
}
Par conséquent, le code pour inclure le mixin important-text est le suivant :
Exemple
@include important-text;
background-color: green;
}
Convertissez le code ci-dessus en code CSS, comme indiqué ci-dessous :
Code CSS :
color: red;
font-size: 25px;
font-weight: bold;
border: 1px solid blue;
background-color: green;
}
Un mixin peut également inclure d'autres mixins, comme illustré ci-dessous :
Exemple
@include important-text;
@include link;
@include special-border;
}
Transmettre des variables à un mixin
Les mixins peuvent accepter des paramètres.
Nous pouvons transmettre des variables à un mixin.
Définir un mixin qui peut accepter des paramètres :
Exemple
@mixin bordered($color, $width) {
border: $width solid $color;
}
.myArticle {
@include bordered(blue, 1px); // Appeler le mixin et passer deux paramètres
}
.myNotes {
@include bordered(red, 2px); // Appeler le mixin et passer deux paramètres
}
Les paramètres du mixin dans l'exemple ci-dessus sont des propriétés pour définir la bordure (couleur et largeur).
Convertissez le code ci-dessus en code CSS, comme indiqué ci-dessous :
Code CSS :
border: 1px solid blue;
}
.myNotes {
border: 2px solid red;
}
Les paramètres d'un mixin peuvent aussi définir des valeurs par défaut, avec la syntaxe suivante :
Exemple
border: $width solid $color;
}
Lors de l'inclusion d'un mixin, vous n'avez qu'à passer les noms de variables souhaités et leurs valeurs :
Exemple
border: {
color: $color;
width: $width;
style: dashed;
}
}
p { @include sexy-border(blue); }
h1 { @include sexy-border(blue, 2in); }
Convertissez le code ci-dessus en code CSS, comme indiqué ci-dessous :
Code CSS :
border-color: blue;
border-width: 1in;
border-style: dashed; }
h1 {
border-color: blue;
border-width: 2in;
border-style: dashed;
}
Arguments variables
Parfois, lorsque vous ne pouvez pas déterminer combien de paramètres un mixin ou une fonction utilisera, vous pouvez utiliser...pour définir des arguments variables.
Par exemple, un mixin utilisé pour créer box-shadow peut prendre n'importe quel nombre de valeurs box-shadow comme paramètres.
Exemple
-moz-box-shadow: $shadows;
-webkit-box-shadow: $shadows;
box-shadow: $shadows;
}
.shadows {
@include box-shadow(0px 4px 5px #666, 2px 6px 10px #999);
}
Convertissez le code ci-dessus en code CSS, comme indiqué ci-dessous :
Code 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;
}
Utilisation de mixins pour les préfixes de navigateur
L'utilisation de mixins pour les préfixes de navigateur est également très pratique, comme dans l'exemple suivant :
Exemple
-webkit-transform: $property;
-ms-transform: $property;
transform: $property;
}
.myBox {
@include transform(rotate(20deg));
}
Convertissez le code ci-dessus en code CSS, comme indiqué ci-dessous :
Code CSS :
-webkit-transform: rotate(20deg);
-ms-transform: rotate(20deg);
transform: rotate(20deg);
}