SASS

内置函数

sass官网提供了很多实用的内置函数，将常用到的内置函数以及场景分享给大家使用。

darken内置函数

定义

lighten()和darken()两个函数都是围绕颜色的亮度值做调整的，其中lighten()函数会让颜色变得更亮，与之相反的darken()函数会让颜色变得更暗。这个亮度值可以是0~1之间。

  1. lighten(#fff,10%) //原色的亮度值 增加百分之10亮度
  2. draken(#fff,10%) // 在原色的基础上 减少百分之10亮度

应用场景

lighten和darken这两个内置函数经常被用到元素被hover/focus时，当hover一个元素的时候。此时并不希望改变这个元素的色值，但是又想要用户感知到鼠标停留在这个元素上。此时这两个内置函数就发挥了他们的作用了。

  1. @mixin button-type(
  2.   $background,
  3.   $border,
  4.   $color,
  5.   $hover-background: lighten($background, 7.5),
  6.   $hover-border: lighten($border, 10%),
  7.   $hover-color: $color
  8. ) {
  9.   color: $color;
  10.   background: $background;
  11.   border-color: $border;
  12.   &:hover {
  13.     color: $hover-color;
  14.     background: $hover-background;
  15.     border-color: $hover-border;
  16.   }
  17.   &:focus,
  18.   &.is-focus {
  19.     color: $hover-color;
  20.     background: $hover-background;
  21.     border-color: $hover-border;
  22.   }
  23.   &[disabled],
  24.   &.is-disabled {
  25.     color: $color;
  26.     background: $background;
  27.     border-color: $border;
  28.   }
  29. }

desaturate

饱和度（Saturation）是指色彩的纯度，饱和度越高色彩越纯越浓，饱和度越低则色彩变灰变淡。
sass中的desaturate函数就是针对饱和度操作的内置方法。

  1. desaturate($color, $amount) //=> color

使$color饱和度降低，在$amount必须之间的数字0%和100%（包含）。

@warn

When writing mixins and functions, you may want to discourage users from passing certain arguments or certain values. They may be passing legacy arguments that are now deprecated, or they may be calling your API in a way that’s not quite optimal.

编写MixIn和函数时，可能希望劝阻用户传递某些参数或某些值。他们可能正在传递现在已弃用的传统参数，或者他们可能会以不太最佳的方式调用API。
简单来说在mixin或者function内部，可以通过@warn操作符给用户提示一些警告内容输出在控制台。

  1. @mixin prefix($property, $value, $prefixes) {
  2.   @each $prefix in $prefixes {
  3.     @if not index($known-prefixes, $prefix) {
  4.       @warn "Unknown prefix #{$prefix}.";
  5.     }
  7.     -#{$prefix}-#{$property}: $value;
  8.   }
  9.   #{$property}: $value;
  10. }

控制台会提示

  1. Warning: Unknown prefix wekbit.
  2.     example.scss 6:7   prefix()
  3.     example.scss 16:3  root stylesheet

Inspect()断电函数

其实Inspect()函数用的比较少，主要是用来做校验类型的。
Inspect(...)表达式中的内容如果是正常会返回对应的内容，如果发生错误则会弹出一个错误提示。

Map相关内容

Map-has-key

If $keys is empty, returns whether $map contains a value associated with $key.

  1. $font-weights: ("regular": 400, "medium": 500, "bold": 700);
  3.  map.has-key($font-weights, "regular"); // true
  4.  map.has-key($font-weights, "bolder"); // false

map.has-key()在scss中的条件判断时应用场景特别多。
比如下方这段代码

  1. $--sm: 768px !default;
  2. $--md: 992px !default;
  3. $--lg: 1200px !default;
  4. $--xl: 1920px !default;
  6. $--breakpoints: (
  7.   'xs' : (max-width: $--sm - 1),
  8.   'sm' : (min-width: $--sm),
  9.   'md' : (min-width: $--md),
  10.   'lg' : (min-width: $--lg),
  11.   'xl' : (min-width: $--xl)
  12. );
  14. @mixin res($key, $map: $--breakpoints) {
  15.   // 循环断点Map，如果存在则返回
  16.   @if map.has-key($map, $key) {
  17.     @media only screen and #{inspect(map-get($map, $key))} {
  18.       @content;
  19.     }
  20.   } @else {
  21.     @warn "Undefeined points: `#{$map}`";
  22.   }
  23. }

map.get(map,k1,k2,...)

简单来说就是通过key在map中取到对应的value

  1. $config: (a: (b: (c: d)));
  2. map.get($config, a, b, c); // d

占位符选择器%作用

定义

Sass 额外提供了一种特殊类型的选择器：占位符选择器 (placeholder selector)。与常用的 id 与 class 选择器写法相似，只是 # 或 . 替换成了 %。
比如:

  1. %heading {
  2.   margin-top: 0; // 1
  3.   margin-bottom: $headings-margin-bottom;
  4.   font-family: $headings-font-family;
  5.   font-style: $headings-font-style;
  6.   font-weight: $headings-font-weight;
  7.   line-height: $headings-line-height;
  8.   color: $headings-color;
  9. }

应用场景

其实使用%在大多数(~所有~)场景下，就是和@mixin是一样的效果。使用%占位符选择器的样式，只能被@extend进行调用。
需要注意的是，如果使用占位符选择器%定义的样式，单独使用的时候(未通过extend)进行调用，那么这段样式是不会编译到css的输出结果之后的。

Partials import

定义

和css类似scss支持@import命令，但css的import命令每次调用都会创建一个额外的html请求，但scss的import命令是编译时将文件包含在css中，不需要额外发起请求。
如果需要导入 SCSS 或者 Sass 文件，但又不希望将其编译为 CSS，只需要在文件名前添加下划线，这样会告诉 Sass 不要单独编译这些文件，但导入语句中却不需要添加下划线。
简单来说，项目目录中的所有scss文件在编译阶段都会被编译成为一个个css文件。
但是对于一个公用样式文件，此时并不需要将它编译成为单独的css文件，而是希望将公用文件中的样式插入到对应引入样式文件中，只需要在引入它的文件中将它编译进入引入的css文件中就可以。
此时给文件名称以_开头就可以告诉scss在编译阶段并不会将它编译成为单独的css文件，而是仅仅会将它的样式编译进入引入它的样式文件中去。
比如一个文件夹两个 scss 文件，一个 root.scss，一个 _vars.scss。

  1. // 第一个 scss 文件夹名 -o 是输出文件夹名称``npx node-sass scss -o output``// 只会有一个文件生成
  2. rendering Complete, saving .css file...
  3. Wrote CSS to /Users/liusha/Public/vikingship/output/root.css //将 _vars 该名称为 vars.scss 再执行一遍
  4. Rendering Complete, saving .css file...
  5. Wrote CSS to /Users/liusha/Public/vikingship/output/root.css
  6. Rendering Complete, saving .css file...
  7. Wrote CSS to /Users/liusha/Public/vikingship/output/vars.css
  8. 会有两个文件生成

应用场景

这在组件库的开发中是非常有用的，定义单独组件的样式文件以Partials import进行定义，不单独打包成为css文件，在最终导入的样式文件中统一进行合并管理而不打包出单独的css文件。

变量声明global与default

!default 默认变量

可以在变量的结尾添加 !default 给一个未通过 !default 声明赋值的变量赋值，此时，如果变量已经被赋值，不会再被重新赋值，但是如果变量还没有被赋值，则会被赋予新的值。
比如这样一段代码:

  1. $color:red;
  2. $color:blue !default;
  4. .modules-a {
  5.     color: $color; // red
  6. }

可以看到即使是先声明的red，因为blue !default，所以红色覆盖了蓝色。!default声明变量的意思就是说如果项目中存在相同的声明则优先使用别的声明，如果不存在则使用!default的值，可以理解为默认值。

!global全局声明

变量支持块级作用域，嵌套规则内定义的变量只能在嵌套规则内使用（局部变量），不在嵌套规则内定义的变量则可在任何地方使用（全局变量）。将局部变量转换为全局变量可以添加 !global 声明
在scss中都清楚局部变量的定义是无法影响同名的global变量的。但是可以通过!global在局部作用域中去定义一个全局都可以使用的变量。同样也可以通过!default在局部作用域中去覆盖一个全局变量的值。

  1. #main {
  2.   $width: 5em !global;
  3.   width: $width;
  4. }
  6. #sidebar {
  7.   // 同样可以使用$width全局变量
  8.   width: $width;
  9. }

编译为

  1. #main {
  2.   width: 5em;
  3. }
  5. #sidebar {
  6.   width: 5em;
  7. }

mixin

参数变量…

有时，不能确定混合指令需要使用多少个参数，比如一个关于 box-shadow 的混合指令不能确定有多少个 ‘shadow’ 会被用到。这时，可以使用参数变量 … 声明（写在参数的最后方）告诉 Sass 将这些参数视为值列表处理。
其实就类似于js中的…rest运算符。

  1. @mixin box-shadow($shadows...) {
  2.   -moz-box-shadow: $shadows;
  3.   -webkit-box-shadow: $shadows;
  4.   box-shadow: $shadows;
  5. }
  6. .shadows {
  7.   @include box-shadow(0px 4px 5px #666, 2px 6px 10px #999);
  8. }

编译后：

  1. .shadowed {
  2.   -moz-box-shadow: 0px 4px 5px #666, 2px 6px 10px #999;
  3.   -webkit-box-shadow: 0px 4px 5px #666, 2px 6px 10px #999;
  4.   box-shadow: 0px 4px 5px #666, 2px 6px 10px #999;
  5. }

使用，分隔为.shadowed元素添加多个阴影。

@content— 向混合样式中导入内容

在引用混合样式mixin的时候，可以先将一段代码导入到混合指令中，然后再输出混合样式，额外导入的部分将出现在 @content 标志的地方
比如这样的代码，在include中填充了对应的样式，在mixin中可以通过@content使用。

  1. @mixin apply-to-ie6-only {
  2.   * html {
  3.     @content;
  4.   }
  5. }
  6. @include apply-to-ie6-only {
  7.   #logo {
  8.     background-image: url(/logo.gif);
  9.   }
  10. }

编译为

  1. // mixin中接受了include 可以理解为插槽
  2. * html #logo {
  3.   background-image: url(/logo.gif);
  4. }

为便于书写，@mixin 可以用 = 表示，而 @include 可以用 + 表示，所以上面的例子可以写成：

  1. // = 简写mixin
  2. =apply-to-ie6-only
  3.   * html
  4.     @content
  6. // + 简写include
  7. +apply-to-ie6-only
  8.   #logo
  9.     background-image: url(/logo.gif)

注意： 当 @content 在指令中出现过多次或者出现在循环中时，额外的代码将被导入到每一个地方。

@at-root

常规用法

@at-root指令可以使一个或多个规则被限定输出在文档的根层级上，而不是被嵌套在其父选择器下。
比如

  1. .parent {
  2.   ...
  3.   @at-root .child { ... }
  4. }

编译之后.child并不会嵌套在任何规则之下，因为使用了@at-root选择符

  1. .parent { ... }
  2. .child { ... }

@at-root同样也可以当作一个作用域给多个选择器去使用:

  1. .parent {
  2.   ...
  3.   @at-root {
  4.     .child1 { ... }
  5.     .child2 { ... }
  6.   }
  7.   .step-child { ... }
  8. }

编译后:

  1. .parent { ... }
  2. .child1 { ... }
  3. .child2 { ... }
  4. .parent .step-child { ... }

支持参数

@at-root (without: ...) and @at-root (with: ...)
默认使用@at-root不传递任何时，他的作用为跳出选择器的作用域嵌套，当然可以传递参数去使用。
比如下面的@at-root意为跳出@media的嵌套:

  1. @media print {
  2.   .page {
  3.     width: 8in;
  4.     @at-root (without: media) {
  5.       color: red;
  6.     }
  7.   }
  8. }
  10. @media print {
  11.   .page {
  12.     width: 8in;
  13.   }
  14. }
  15. .page {
  16.   color: red;
  17. }

默认 @at-root 只会跳出选择器嵌套，而不能跳出@media或 @support，如果要跳出这两种，则需使用 @at-root(without: media)，@at-root(without: support)。这个语法的关键词有
四个：

  • all（表示所有）
  • rule（表示常规,默认行为。
  • media（表示 media）
  • support（表示 support）。

默认的 @at-root 其实就是 @at-root( without: rule )：跳出作用域嵌套规则。

  1. @at-root(without: rule)

rule 关键词只能跳出选择器嵌套，不能跳出 @media 和 @support

  1. @at-root(without: media)

可以跳出 @media ，但是没有跳出父级选择器

  1. @at-root(without: support)

@at-root(without: support) 和 @at-root(without: media) 相似，只是跳出的是 @support。

  1. @at-root(without: all)

@at-root(without: all) 是跳出所的指令和规则，如上面的代码里 @at-root(without: media rule) 可以换成 @at-root(without: all)，效果是一样的。

@each in

maps数据格式

首先说说在scss中定义类似js中的对象。

  1. $map: (key1: value1, key2: value2, key3: value3);

通过()就可以定义了。比如这样的Maps结构定义。

  1. $blue: #0d6efd !default;
  2. $indigo: #6610f2 !default;
  3. $purple: #6f42c1 !default;
  4. $pink: #d63384 !default;
  5. $red: #dc3545 !default;
  6. $orange: #fd7e14 !default;
  7. $yellow: #fadb14 !default;
  8. $green: #52c41a !default;
  9. $teal: #20c997 !default;
  10. $cyan: #17a2b8 !default;
  12. $primary: $blue !default;
  13. $secondary: $gray-600 !default;
  14. $success: $green !default;
  15. $info: $cyan !default;
  16. $warning: $yellow !default;
  17. $danger: $red !default;
  18. $light: $gray-100 !default;
  19. $dark: $gray-800 !default;
  21. $theme-colors: (
  22.   'primary': $primary,
  23.   'secondary': $secondary,
  24.   'success': $success,
  25.   'info': $info,
  26.   'warning': $warning,
  27.   'danger': $danger,
  28.   'light': $light,
  29.   'dark': $dark,
  30. );

定义了一个maps的主题，分别存在对应的名称和对应的颜色值。

@each in

@each 指令的格式是 $var in <list>，$var 可以是任何变量名，比如 $length 或者 $name，而 <list> 是一连串的值，也就是值列表。

“数组”迭代

@each 将变量 $var 作用于值列表中的每一个项目，然后输出结果，例如：

  1. @each $animal in puma, sea-slug, egret, salamander {
  2.   .#{$animal}-icon {
  3.     background-image: url('/images/#{$animal}.png');
  4.   }
  5. }

编译为

  1. .puma-icon {
  2.   background-image: url('/images/puma.png'); }
  3. .sea-slug-icon {
  4.   background-image: url('/images/sea-slug.png'); }
  5. .egret-icon {
  6.   background-image: url('/images/egret.png'); }
  7. .salamander-icon {
  8.   background-image: url('/images/salamander.png'); }

此时类似于js中的数组迭代。

对象迭代

当然@each $val,$key in maps，也支持”迭代”一个对象(maps)。比如:

  1. @each $key, $value in $theme-colors {
  2.   .#{$prefix}-icon--#{$key} {
  3.     color: $value;
  4.   }
  5. }

这样就迭代了上边定义的$theme-colors这个对象，并且取得了他的key,value。

多个值迭代

The @each directive can also use multiple variables, as in @each v a r 1 , var1, var1,var2, … in . If is a list of lists, each element of the sub-lists is assigned to the respective variable. For example:

@each 指令也可以使用多个变量，如@each $var1, $var2, ... in 。如果是列表列表，则子列表的每个元素都分配给相应的变量。例如

  1. @each $animal, $color, $cursor in (puma, black, default),
  2.                                   (sea-slug, blue, pointer),
  3.                                   (egret, white, move) {
  4.   .#{$animal}-icon {
  5.     background-image: url('/images/#{$animal}.png');
  6.     border: 2px solid $color;
  7.     cursor: $cursor;
  8.   }
  9. }

is compiled to:

  1. .puma-icon {
  2.   background-image: url('/images/puma.png');
  3.   border: 2px solid black;
  4.   cursor: default; }
  5. .sea-slug-icon {
  6.   background-image: url('/images/sea-slug.png');
  7.   border: 2px solid blue;
  8.   cursor: pointer; }
  9. .egret-icon {
  10.   background-image: url('/images/egret.png');
  11.   border: 2px solid white;
  12.   cursor: move; }

css :scope选择器

偶然在写jest中看到别人使用xxx.querySelect(':scope')。感到比较新奇随机查阅记录一番。
在JavaScript中，当用于Element.querySelector，Element.querySelectorAll或Element.closest时，:scope是指调用这些方法的元素。例如，document.body.querySelector(":scope")返回body元素。尽管CSS对 :scope的支持已被移除，但 :scope 的这种用法仍然被支持
使用:scope选择器可以匹配对应的方法比如element.querySelector(':scope')则会返回element元素本身。
需要主要的是:scope伪类在css中已经不被大多数浏览器支持，甚至已经废弃。但是在js这些方法中仍然被主流浏览器支持。

参考资料

https://sass-lang.com/documentation/at-rules/mixin
https://sass-lang.com/documentation/at-rules/function
https://developer.mozilla.org/en-US/docs/Web/API/Element/querySelector
https://developer.mozilla.org/en-US/docs/Web/API/Element/querySelectorAll
https://developer.mozilla.org/en-US/docs/Web/API/Element/closest