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 :

@mixin important-text {
  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 :

selector {
  @include mixin-name;
}

Par conséquent, le code pour inclure le mixin important-text est le suivant :

Exemple

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

Convertissez le code ci-dessus en code CSS, comme indiqué ci-dessous :

Code CSS :

.danger {
  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

@mixin special-text {
  @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

/* Le mixin accepte deux paramètres */
@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 :

.myArticle {
  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

@mixin bordered($color: blue, $width: 1px) {
  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

@mixin sexy-border($color, $width: 1in) {
  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 :

p {
  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

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

Convertissez le code ci-dessus en code CSS, comme indiqué ci-dessous :

Code 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;
}

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

@mixin transform($property) {
  -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 :

.myBox {
  -webkit-transform: rotate(20deg);
  -ms-transform: rotate(20deg);
  transform: rotate(20deg);
}
Autres extensions