sass:map
- Dart·Sass(Dart Sass)
- 从 1.23.0开始
- LibSass
- ✗
- rubySass
- ✗
兼容性:
目前只有Dart Sass支持使用加载内置模块@use
。其他实现的用户必须使用其全局名称来调用函数。
map.get($map, $key)
map-get($map, $key)
返回与$map
关联 的值$key
。
如果$map
没有与关联的值$key
,则返回null
。
SCSS 语法
$font-weights: ("regular": 400, "medium": 500, "bold": 700);
@debug map.get($font-weights, "medium"); // 500
@debug map.get($font-weights, "extra-bold"); // null
Sass语法
$font-weights: ("regular": 400, "medium": 500, "bold": 700)
@debug map.get($font-weights, "medium") // 500
@debug map.get($font-weights, "extra-bold") // null
map.has-key($map, $key)
map-has-key($map, $key) //=> boolean
返回是否$map
包含与关联的值 $key
。
SCSS 语法
$font-weights: ("regular": 400, "medium": 500, "bold": 700);
@debug map.has-key($font-weights, "regular"); // true
@debug map.has-key($font-weights, "bolder"); // false
Sass语法
$font-weights: ("regular": 400, "medium": 500, "bold": 700)
@debug map.has-key($font-weights, "regular") // true
@debug map.has-key($font-weights, "bolder") // false
map.keys($map)
map-keys($map) //=> list
返回中所有键的逗号分隔列表 $map
。
map.merge($map1, $map2)
map-merge($map1, $map2) //=> map
返回与所有来自键和值的新地图$map1
和 $map2
。
$map1
通过将单个键/值对传递为, 这也可以用于添加新值或覆盖其中的值$map2
。
如果同时$map1
与$map2
具有相同的钥匙,$map2
“价值优先。
返回的映射中所有也以出现的键$map1
具有与中相同的顺序$map1
。来自的新键$map2
显示在地图的末尾。
SCSS 语法
$light-weights: ("lightest": 100, "light": 300);
$heavy-weights: ("medium": 500, "bold": 700);
@debug map.merge($light-weights, $heavy-weights);
// (
// "lightest": 100,
// "light": 300,
// "medium": 500,
// "bold": 700
// )
// map.merge() can be used to add a single key/value pair to a map.
@debug map.merge($light-weights, ("lighter": 200));
// ("lightest": 100, "light": 300, "lighter": 200)
// It can also be used to overwrite a value in a map.
@debug map.merge($light-weights, ("light": 200));
// ("lightest": 100, "light": 200)
Sass语法
$light-weights: ("lightest": 100, "light": 300)
$heavy-weights: ("medium": 500, "bold": 700)
@debug map.merge($light-weights, $heavy-weights)
// (
// "lightest": 100,
// "light": 300,
// "medium": 500,
// "bold": 700
// )
// map.merge() can be used to add a single key/value pair to a map.
@debug map.merge($light-weights, ("lighter": 200))
// ("lightest": 100, "light": 300, "lighter": 200)
// It can also be used to overwrite a value in a map.
@debug map.merge($light-weights, ("light": 200))
// ("lightest": 100, "light": 200)
map.remove($map, $keys...)
map-remove($map, $keys...) //=> map
传回的副本,$map
而没有与关联的任何值 $keys
。
如果key in $keys
中没有关联的值$map
,则会将其忽略。
SCSS 语法
$font-weights: ("regular": 400, "medium": 500, "bold": 700);
@debug map.remove($font-weights, "regular"); // ("medium": 500, "bold": 700)
@debug map.remove($font-weights, "regular", "bold"); // ("medium": 500)
@debug map.remove($font-weights, "bolder");
// ("regular": 400, "medium": 500, "bold": 700)
Sass语法
$font-weights: ("regular": 400, "medium": 500, "bold": 700)
@debug map.remove($font-weights, "regular") // ("medium": 500, "bold": 700)
@debug map.remove($font-weights, "regular", "bold") // ("medium": 500)
@debug map.remove($font-weights, "bolder")
// ("regular": 400, "medium": 500, "bold": 700)
map.values($map)
map-values($map) //=> list
返回中所有值的逗号分隔列表 $map
。