Modules intégrés de SASS
Cet article explique les modules intégrés de SASS.
Nous abordons pas à pas les modules intégrés de SASS, des bases à l'utilisation avancée.
YouTube Video
Modules intégrés de SASS
SASS propose une variété de modules intégrés, dont l'utilisation rend la création de feuilles de style encore plus efficace.
Que sont les modules intégrés de SASS ?
Les modules intégrés de SASS fournissent des fonctions et des mixins réutilisables. Les utiliser facilite les calculs complexes et la création de styles personnalisés.
Les principaux modules intégrés sont les suivants :.
sass:colorsass:stringsass:mathsass:listsass:mapsass:selectorsass:meta
Chaque module inclut des fonctionnalités pour simplifier des tâches spécifiques.
Détails et exemples de chaque module
Le module sass:color
Le module sass:color fournit des fonctions qui facilitent la manipulation des couleurs.
Fonctions principales
mix(): Mélanger deux couleursadjust(): Ajustez ensemble la teinte, la luminosité, la saturation et d'autres propriétés
Exemple d'utilisation
1@use "sass:color";
2
3$primary-color: #3498db;
4$secondary-color: #e74c3c;
5
6// Mix two colors with equal weight
7$blended-color: color.mix($primary-color, $secondary-color, 50%);
8
9// Adjust hue by 45 degrees using color.adjust()
10$adjusted-color: color.adjust($primary-color, $hue: 45deg);
11
12div {
13 background-color: $blended-color; // Result of mixing two colors
14 border-color: $adjusted-color; // Hue adjusted by 45 degrees
15}- Ce code génère une nouvelle couleur en mélangeant deux couleurs, ainsi qu'une autre couleur à la teinte ajustée. Les couleurs générées sont appliquées aux éléments comme couleurs d'arrière-plan et de bordure. Cet exemple aide à comprendre les bases de la manipulation des couleurs.
Le module sass:string
Le module sass:string fournit des fonctions utiles pour la manipulation des chaînes de caractères.
Fonctions principales
quote(),unquote(): Ajouter ou retirer des guillemets à une chaînelength(): Obtenir la longueur d'une chaîneto-upper-case(),to-lower-case(): Convertir une chaîne en majuscules ou en minuscules
Exemple d'utilisation
1@use "sass:string";
2
3// base values
4$base-url: "https://example.com";
5$path: "/assets/style.css";
6
7// 1) Combine strings using interpolation and then quote the result
8$full-quoted: string.quote("#{$base-url}#{$path}");
9// Example result: "\"https://example.com/assets/style.css\""
10
11// 2) Remove quotes from a quoted string
12$full-unquoted: string.unquote($full-quoted);
13// Example result: https://example.com/assets/style.css
14
15// 3) Get the length of the unquoted string
16$url-length: string.length($full-unquoted);
17// Example output: number of characters in the URL
18
19// 4) Convert strings to upper/lower case and quote for safe CSS output
20$block-name: "main-header";
21// "MAIN-HEADER"
22$upper-quoted: string.quote(string.to-upper-case($block-name));
23// "main-footer"
24$lower-quoted: string.quote(string.to-lower-case("MAIN-FOOTER"));
25
26a::after {
27 /* Use quoted strings for content to ensure valid CSS */
28 content: $full-quoted; /* "https://example.com/assets/style.css" */
29}
30
31:root {
32 /* Insert numeric values with interpolation when needed */
33 --url-length: #{ $url-length }; /* Example: --url-length: 31; */
34}
35
36.header::before {
37 /* Output uppercase version */
38 content: $upper-quoted; /* "MAIN-HEADER" */
39}
40
41.footer::after {
42 /* Output lowercase version */
43 content: $lower-quoted; /* "main-footer" */
44}- L'utilisation de
string.quote()etstring.unquote()permet de contrôler précisément les représentations des chaînes dans le CSS produit.string.length()est une fonction qui obtient la longueur d'une chaîne.string.to-upper-case()/string.to-lower-case()sont pratiques pour générer des noms de classes et formater des noms BEM.
Le module sass:math
Le module sass:math fournit des fonctions pour les calculs mathématiques.
Fonctions principales
pow(): Exponentiationsqrt(): Racine carréeabs(): Valeur absolueround(),ceil(),floor(): Arrondir, arrondir à l'entier supérieur, arrondir à l'entier inférieur
Exemple d'utilisation
1@use "sass:math";
2
3// Using pow() to calculate exponential values
4$base-size: math.pow(2, 3) * 10px; // 80px
5
6// Using sqrt() to compute a square root
7$root-size: math.sqrt(144) * 1px; // 12px
8
9// Using abs() to ensure a positive value
10$offset: math.abs(-15px); // 15px
11
12// Using round(), ceil(), and floor() for different rounding methods
13$rounded: math.round(12.6px); // 13px
14$ceiled: math.ceil(12.1px); // 13px
15$floored: math.floor(12.9px); // 12px
16
17.container {
18 width: $base-size; // 80px
19 height: $root-size; // 12px
20 margin-left: $offset; // 15px
21}
22
23.values {
24 /* Demonstrating different rounding operations */
25 padding: $rounded; // 13px
26 border-width: $ceiled; // 13px
27 margin-top: $floored; // 12px
28}math.pow()etmath.sqrt()sont utiles pour les calculs de tailles, tandis quemath.abs()et les fonctions d'arrondi aident à gérer les ajustements. Les combiner permet de calculer facilement des échelles d'interface cohérentes.
Le module sass:list
Le module sass:list fournit des fonctions spécialisées pour les opérations sur les listes.
Fonctions principales
append(): Ajouter des élémentsjoin(): Concaténer des listesnth(): Obtenir l'élément à une position donnéelength(): Obtenir la longueur d'une liste
Exemple d'utilisation
1@use "sass:list";
2
3// Base list
4$colors: ("red", "blue", "green");
5
6// Add an element to the end of the list
7$colors-appended: list.append($colors, "yellow");
8// ("red", "blue", "green", "yellow")
9
10// Add an element to the beginning of the list using join()
11$colors-prepended: list.join(("black",), $colors);
12// ("black", "red", "blue", "green", "yellow")
13
14// Join two lists together
15$extra-colors: ("pink", "cyan");
16$merged-colors: list.join($colors-prepended, $extra-colors);
17// ("black", "red", "blue", "green", "yellow", "pink", "cyan")
18
19// Get list length
20$total-length: list.length($merged-colors);
21
22// Example usage in a loop: assign each color to a list item
23ul {
24 @for $i from 1 through $total-length {
25 li:nth-child(#{$i}) {
26 /* Get the color at index $i */
27 color: list.nth($merged-colors, $i);
28 }
29 }
30}- Vous pouvez ajouter des éléments à la fin d'une liste avec
append(), et utiliserjoin()pour combiner plusieurs listes de manière flexible. Si vous souhaitez ajouter un élément au début, vous pouvez le faire en joignant une liste à un seul élément au début avecjoin(). En combinantlength()etnth(), il devient plus facile de générer des styles d'UI nécessitant un traitement dynamique des listes.
Le module sass:map
Le module sass:map fournit des fonctions pour travailler avec des maps (tableaux associatifs).
Fonctions principales
get(): Obtenir la valeur d'une cléset(): Ajouter ou mettre à jour une paire clé-valeurkeys(): Obtenir toutes les clés
Exemple d'utilisation
1@use "sass:map";
2
3// Base theme map
4$theme-colors: (
5 "primary": #3498db,
6 "secondary": #e74c3c
7);
8
9// Update or add a value using set()
10$updated-theme: map.set($theme-colors, "warning", #f1c40f);
11// Map now has "warning": #f1c40f added
12
13// Get a value from the map
14$primary-color: map.get($updated-theme, "primary");
15
16// Get all keys from the map
17$all-keys: map.keys($updated-theme);
18// Example: ("primary", "secondary", "warning")
19
20button {
21 /* Apply color retrieved from the theme map */
22 background-color: $primary-color;
23}
24
25.debug {
26 /* Print keys as content for demonstration */
27 content: "#{$all-keys}";
28}- L'utilisation de
map.set()permet de mettre à jour les maps dynamiquement et, combinée àmap.get(), de construire des structures de thèmes flexibles. Avecmap.keys(), vous pouvez lister les entrées de configuration, ce qui aide à concevoir des styles extensibles.
Le module sass:selector
Le module sass:selector fournit des fonctions utiles pour la manipulation de sélecteurs.
Fonctions principales
nest(): Imbriquer des sélecteursis-superselector(): Vérifier l'inclusion de sélecteursreplace(): Remplacer des sélecteurs
Exemple d'utilisation
1@use "sass:selector";
2
3// Nest selectors (combine parent and child)
4$nested-selector: selector.nest(".parent", ".child");
5// Result: ".parent .child"
6
7// Check if one selector is a superselector of another
8$is-super: selector.is-superselector(".parent", $nested-selector);
9// true because ".parent" matches all elements that
10// ".parent .child" can match as an ancestor
11
12// Replace part of a selector with another selector
13$replaced-selector: selector.replace(".parent .child", ".child", ".item");
14// Result: ".parent .item"
15
16// Use generated selectors in actual CSS output
17#{$nested-selector} {
18 /* Applies to .parent .child */
19 color: red;
20}
21
22@if $is-super {
23 .info::after {
24 /* Demonstrate boolean result */
25 content: "parent is a superselector";
26 }
27}
28
29#{$replaced-selector} {
30 /* Applies to .parent .item */
31 background: blue;
32}- Utilisez
selector.nest()pour composer des sélecteurs de manière flexible etselector.is-superselector()pour vérifier leurs relations. Combinez avecselector.replace()pour gérer succinctement une logique avancée de génération de sélecteurs.
Le module sass:meta
Le module sass:meta fournit des fonctionnalités utiles pour la méta-programmation dans SASS.
Fonctions principales
variable-exists(): Vérifier si une variable existeglobal-variable-exists(): Vérifier si une variable globale existeinspect(): Afficher une valeur pour le débogage
Exemple d'utilisation
1@use "sass:meta";
2
3// Define a global variable
4$color: #3498db;
5
6// Check if a variable exists in the current scope
7@if meta.variable-exists("color") {
8 body {
9 /* Apply style only if $color exists */
10 background-color: $color;
11 }
12}
13
14// Create a local variable inside a block
15.container {
16 $local-size: 20px;
17
18 @if meta.variable-exists("local-size") {
19 /* Demonstrates detection of local variable */
20 width: $local-size;
21 }
22}
23
24// Check if a global variable exists
25$result: meta.global-variable-exists("color"); // true
26
27.debug {
28 /* Use inspect() to output the inspected value as a string */
29 content: meta.inspect($result); // "true"
30}meta.variable-exists()etmeta.global-variable-exists()permettent de déterminer en toute sécurité l'état des variables selon la portée.meta.inspect()est très utile pour le débogage et peut afficher des valeurs sous forme de chaînes.
Exemple pratique
Combiner plusieurs modules intégrés renforce encore l'expressivité de SASS. Ci-dessous, un exemple qui utilise conjointement les modules color, math et list pour automatiser le traitement des couleurs et les opérations sur les listes.
1@use "sass:color";
2@use "sass:math";
3@use "sass:list";
4
5// Base color list
6$base-colors: (#3498db, #e74c3c, #2ecc71);
7$darkened-colors: (); // Empty list for processed colors
8
9// Loop through each base color and darken it by 10%
10@each $color in $base-colors {
11 $darkened-colors: list.append(
12 $darkened-colors,
13 // Darken color by decreasing lightness by 10%
14 color.adjust($color, $lightness: -10%)
15 );
16}
17
18div {
19 // Apply each processed color to a corresponding <div>
20 @for $i from 1 through list.length($darkened-colors) {
21 &:nth-child(#{$i}) {
22 // Set color by index
23 background-color: list.nth($darkened-colors, $i);
24 }
25 }
26}- Dans ce code, les couleurs traitées sont ajoutées séquentiellement avec
list.append()etcolor.adjust()avec$lightness: -10%est utilisé pour assombrir les couleurs de 10 %. Enfin,@forest combiné aveclist.nth()pour appliquer des couleurs d'arrière-plan différentes à chaque<div>.
Résumé
Les modules intégrés de SASS augmentent considérablement la flexibilité du CSS. En comprenant chaque module et en les utilisant de manière appropriée, vous pouvez créer des feuilles de style plus efficaces et plus faciles à maintenir.
Vous pouvez suivre l'article ci-dessus avec Visual Studio Code sur notre chaîne YouTube. Veuillez également consulter la chaîne YouTube.