map.deep-merge()

The modified map.deep-merge() function merges multiple maps by using sass original deep-merge().

The function modify original map.deep-merge() by adding arbitrary $maps... argument, to deep merge multiple maps.

// Sass.
@use 'sass:map';

// The `map.deep-merge()` function.
@function deep-merge($map1, $map2, $maps...) {
  $map1: map.deep-merge($map1, $map2);
  @each $map in $maps {
    $map1: map.deep-merge($map1, $map);
  }
  @return $map1;
}

https://github.com/angular-package/sass/blob/main/map/_map.deep-merge.function.scss

// Sass.
@use 'sass:map';

// Status: DONE
// The modified `map.deep-merge()` function merges multiple maps by using sass original `deep-merge()`.
// @param `$map1` A map to deep merge with `$map2`.
// @param `$map2` A map to deep merge with `$map1`.
// @arbitrary `$maps...` Multiple maps to deep merge with the merged `$map1` and `$map2`.
// @return The return value is the map built from `$map2` and `$maps`.
@function deep-merge($map1, $map2, $maps...) {
  $map1: map.deep-merge($map1, $map2);
  @each $map in $maps {
    $map1: map.deep-merge($map1, $map);
  }
  @return $map1;
}

// Examples.
// @debug deep-merge((prefix: spectre), (suffix: end), (affix: name)); // (prefix: spectre, suffix: end, affix: name)

Parameters

$map1

A map to deep merge with $map2.

$map2

A map to deep merge with $map1.

$maps...

Multiple maps to deep merge with the merged $map1 and $map2.

Return

The return value is the map built from $map1, $map2 and $maps.

Examples

// Use.
@use '@angular-package/sass/map';

// Examples.
@debug map.deep-merge((prefix: spectre), (suffix: end), (affix: name)); // (prefix: spectre, suffix: end, affix: name)