Při práci na složitých architekturách Sass není neobvyklé používat mapy Sass k udržení konfigurace a možností. Čas od času uvidíte mapy v mapách (možná na několika úrovních), jako je tato, z o-grid:
$o-grid-default-config: ( columns: 12, gutter: 10px, min-width: 240px, max-width: 1330px, layouts: ( S: 370px, // ≥20px columns M: 610px, // ≥40px columns L: 850px, // ≥60px columns XL: 1090px // ≥80px columns ), fluid: true, debug: false, fixed-layout: M, enhanced-experience: true );
Problém s takovými mapami je, že není snadné získat a nastavit hodnoty ze vnořeného stromu. To je určitě něco, co chcete skrýt ve funkcích, abyste nemuseli pokaždé dělat to ručně.
Hluboko dostat
Vytvoření funkce pro načtení hluboce vnořených hodnot z mapy je ve skutečnosti velmi snadné.
/// Map deep get /// @author Hugo Giraudel /// @access public /// @param (Map) $map - Map /// @param (Arglist) $keys - Key chain /// @return (*) - Desired value @function map-deep-get($map, $keys… ) ( @each $key in $keys ( $map: map-get($map, $key); ) @return $map; )
Například pokud chceme získat hodnotu přidruženou k M
rozvržení z naší konfigurační mapy, je to tak snadné jako:
$m-breakpoint: map-deep-get($o-grid-default-config, "layouts", "M"); // 610px
Uvědomte si, že uvozovky kolem řetězců jsou volitelné. Přidáváme je pouze kvůli obavám o čitelnost.
Hluboká sada
Na druhou stranu budování funkce pro nastavení hluboce vnořeného klíče může být velmi zdlouhavé.
/// Deep set function to set a value in nested maps /// @author Hugo Giraudel /// @access public /// @param (Map) $map - Map /// @param (List) $keys - Key chaine /// @param (*) $value - Value to assign /// @return (Map) @function map-deep-set($map, $keys, $value) ( $maps: ($map,); $result: null; // If the last key is a map already // Warn the user we will be overriding it with $value @if type-of(nth($keys, -1)) == "map" ( @warn "The last key you specified is a map; it will be overrided with `#($value)`."; ) // If $keys is a single key // Just merge and return @if length($keys) == 1 ( @return map-merge($map, ($keys: $value)); ) // Loop from the first to the second to last key from $keys // Store the associated map to this key in the $maps list // If the key doesn't exist, throw an error @for $i from 1 through length($keys) - 1 ( $current-key: nth($keys, $i); $current-map: nth($maps, -1); $current-get: map-get($current-map, $current-key); @if $current-get == null ( @error "Key `#($key)` doesn't exist at current level in map."; ) $maps: append($maps, $current-get); ) // Loop from the last map to the first one // Merge it with the previous one @for $i from length($maps) through 1 ( $current-map: nth($maps, $i); $current-key: nth($keys, $i); $current-val: if($i == length($maps), $value, $result); $result: map-merge($current-map, ($current-key: $current-val)); ) // Return result @return $result; )
Nyní, když chceme aktualizovat hodnotu přidruženou k M
rozložení z naší konfigurační mapy, můžeme udělat:
$o-grid-default-config: map-deep-set($o-grid-default-config, "layouts" "M", 650px);
Další zdroje
Výše uvedená funkce není jediným řešením tohoto problému.
Knihovna Sassy-Maps také poskytuje map-deep-set
a map-deep-get
funguje. Stejným způsobem Hugo Giraudel také napsal extend
funkci ve stylu jQuery, která má vestavěnou map-merge
rekurzivní schopnost sloučit více než 2 mapy najednou.