sass:meta

Dart·Sass（Dart Sass）: 从 1.23.0开始
LibSass: ✗
rubySass: ✗

目前只有Dart Sass支持使用加载内置模块@use。其他实现的用户必须使用其全局名称来调用函数。

Mixins永久链接 Mixins

meta.load-css($url, $with: null)

Dart·Sass（Dart Sass）: 由于（未发行）
LibSass: ✗
rubySass: ✗

当前只有Dart Sass支持此混合。

加载模块时$url，包括其CSS，就好像是写，因为这混入的内容。该$with参数提供了模块的配置。如果传递了，它必须是变量名（不带$）到要在加载的模块中使用的那些变量的值的映射。

如果$url为relative，则将其解释为相对于其中meta.load-css()包含的文件。

像@use规则：

即使给定模块以不同方式多次加载，这只会评估一次。
这无法为已经加载的模块提供配置，无论模块是否已经加载了配置。

与@use规则不同：

这不会使已加载模块中的任何成员在当前模块中可用。
可以在样式表中的任何位置使用它。它甚至可以嵌套在样式规则中以创建嵌套样式！
所加载的模块URL可以来自变量，并包含插值。

Head️抬头！

该$url参数应该是包含一个字符串URL像你传递给@use规则。它不应该是CSS url()！

SCSS
Sass
css
SCSS  语法// dark-theme/_code.scss
$border-contrast: false !default;

code {
  background-color: #6b717f;
  color: #d2e1dd;
  @if $border-contrast {
    border-color: #dadbdf;
  }
}
// style.scss
@use "sass:meta";

body.dark {
  @include meta.load-css("dark-theme/code",
      $with: ("border-contrast": true));
}
Sass语法// dark-theme/_code.sass
$border-contrast: false !default

code
  background-color: #6b717f
  color: #d2e1dd
  @if $border-contrast
    border-color: #dadbdf


// style.sass
@use "sass:meta"

body.dark
  $configuration: ("border-contrast": true)
  @include meta.load-css("dark-theme/code", $with: $configuration)

CSS  输出body.dark code {
  background-color: #6b717f;
  color: #d2e1dd;
  border-color: #dadbdf;
}

函数永久链接函数

meta.call($function, $args...)
call($function, $args...)

Dart·Sass（Dart Sass）: ✓
LibSass: 从 3.5.0开始
rubySass: 从 3.5.0开始

在较旧的LibSass和Ruby Sass版本中，该call()函数采用了代表函数名称的字符串。为了准备一个新的模块系统（功能不再是全局的），所以更改了它的功能值，以准备一个新的模块系统，因此给定的名称可能并不总是引用相同的功能。

将字符串传递给call()所有实现仍然可以使用，但已弃用，并且在以后的版本中将不允许使用。

调用$function与$args返回结果。

本$function应该是一个函数的返回meta.get-function()。

SCSS
Sass
css
SCSS  语法@use "sass:list";
@use "sass:meta";
@use "sass:string";

/// Return a copy of $list with all elements for which $condition returns `true`
/// removed.
@function remove-where($list, $condition) {
  $new-list: ();
  $separator: list.separator($list);
  @each $element in $list {
    @if not meta.call($condition, $element) {
      $new-list: list.append($new-list, $element, $separator: $separator);
    }
  }
  @return $new-list;
}

$fonts: Tahoma, Geneva, "Helvetica Neue", Helvetica, Arial, sans-serif;

content {
  @function contains-helvetica($string) {
    @return string.index($string, "Helvetica");
  }
  font-family: remove-where($fonts, meta.get-function("contains-helvetica"));
}
Sass语法@use "sass:list"
@use "sass:meta"
@use "sass:string"

/// Return a copy of $list with all elements for which $condition returns `true`
/// removed.
@function remove-where($list, $condition)
  $new-list: ()
  $separator: list.separator($list)
  @each $element in $list
    @if not meta.call($condition, $element)
      $new-list: list.append($new-list, $element, $separator: $separator)


  @return $new-list


$fonts: Tahoma, Geneva, "Helvetica Neue", Helvetica, Arial, sans-serif

content
  @function contains-helvetica($string)
    @return string.index($string, "Helvetica")

  font-family: remove-where($fonts, meta.get-function("contains-helvetica"))

CSS  输出content {
  font-family: Tahoma, Geneva, Arial, sans-serif;
}

meta.content-exists()
content-exists() //=> boolean

返回当前的mixin是否通过了@contentblock。

如果在mixin之外调用，则会引发错误。

SCSS
Sass
SCSS  语法@mixin debug-content-exists {
  @debug meta.content-exists();
  @content;
}

@include debug-content-exists; // false
@include debug-content-exists { // true
  // Content!
}
Sass语法@mixin debug-content-exists
  @debug meta.content-exists()
  @content


@include debug-content-exists  // false
@include debug-content-exists   // true
  // Content!

meta.feature-exists($feature)
feature-exists($feature) //=> boolean

返回当前Sass实现是否支持 $feature。

本$feature必须是一个字符串。当前公认的功能是：

global-variable-shadowing，这意味着除非具有标志，否则局部变量将隐藏全局变量!global。
extend-selector-pseudoclass，这意味着该@extend规则将影响嵌套在伪类（如）中的选择器 :not()。
units-level3，这意味着单位算术支持CSS值和单位级别3中定义的单位。
at-error，表示该@error规则受支持。
custom-property，这意味着自定义属性声明值不支持除插值以外的任何表达式。

返回false任何无法识别的 $feature。

SCSS
Sass
SCSS  语法@debug meta.feature-exists("at-error"); // true
@debug meta.feature-exists("unrecognized"); // false
Sass语法@debug meta.feature-exists("at-error")  // true
@debug meta.feature-exists("unrecognized")  // false

meta.function-exists($name)
function-exists($name) //=> boolean

返回是否将命名函数$name定义为内置函数还是用户定义函数。

SCSS
Sass
SCSS  语法@debug meta.function-exists("scale-color"); // true
@debug meta.function-exists("add"); // false

@function add($num1, $num2) {
  @return $num1 + $num2;
}
@debug meta.function-exists("add"); // true
Sass语法@debug meta.function-exists("scale-color")  // true
@debug meta.function-exists("add")  // false

@function add($num1, $num2)
  @return $num1 + $num2

@debug meta.function-exists("add")  // true

meta.get-function($name, $css: false, $module: null)
get-function($name, $css: false, $module: null) //=> function

返回名为的函数$name。

如果$module为is null，则返回$name不带名称空间的命名函数（包括全局内置函数）。否则，$module必须是与当前文件中@use规则的命名空间匹配的字符串，在这种情况下，它将返回名为的模块中的函数 $name。

默认情况下，如果$name不引用Sass函数，则会引发错误。但是，如果$css是true，它将返回一个普通的CSS函数。

可以使用调用返回的函数meta.call()。

SCSS
Sass
css
SCSS  语法@use "sass:list";
@use "sass:meta";
@use "sass:string";

/// Return a copy of $list with all elements for which $condition returns `true`
/// removed.
@function remove-where($list, $condition) {
  $new-list: ();
  $separator: list.separator($list);
  @each $element in $list {
    @if not meta.call($condition, $element) {
      $new-list: list.append($new-list, $element, $separator: $separator);
    }
  }
  @return $new-list;
}

$fonts: Tahoma, Geneva, "Helvetica Neue", Helvetica, Arial, sans-serif;

content {
  @function contains-helvetica($string) {
    @return string.index($string, "Helvetica");
  }
  font-family: remove-where($fonts, meta.get-function("contains-helvetica"));
}
Sass语法@use "sass:list"
@use "sass:meta"
@use "sass:string"

/// Return a copy of $list with all elements for which $condition returns `true`
/// removed.
@function remove-where($list, $condition)
  $new-list: ()
  $separator: list.separator($list)
  @each $element in $list
    @if not meta.call($condition, $element)
      $new-list: list.append($new-list, $element, $separator: $separator)


  @return $new-list


$fonts: Tahoma, Geneva, "Helvetica Neue", Helvetica, Arial, sans-serif

content
  @function contains-helvetica($string)
    @return string.index($string, "Helvetica")

  font-family: remove-where($fonts, meta.get-function("contains-helvetica"))

CSS  输出content {
  font-family: Tahoma, Geneva, Arial, sans-serif;
}

meta.global-variable-exists($name, $module: null)
global-variable-exists($name, $module: null) //=> boolean

返回是否存在名为（不带）的全局变量。$name$

如果$module为is null，则返回是否$name存在没有命名空间的命名变量。否则，$module必须是与当前文件中@use规则的命名空间匹配的字符串，在这种情况下，它将返回该模块是否具有名为的变量 $name。

另请参阅meta.variable-exists()。

SCSS
Sass
SCSS  语法@debug meta.global-variable-exists("var1"); // false

$var1: value;
@debug meta.global-variable-exists("var1"); // true

h1 {
  // $var2 is local.
  $var2: value;
  @debug meta.global-variable-exists("var2"); // false
}
Sass语法@debug meta.global-variable-exists("var1")  // false

$var1: value 
@debug meta.global-variable-exists("var1")  // true

h1
  // $var2 is local.
  $var2: value
  @debug meta.global-variable-exists("var2")  // false

meta.inspect($value)
inspect($value) //=> unquoted string

返回的字符串表示形式 $value。

返回任何 Sass值的表示形式，而不仅仅是可以在CSS中表示的值。因此，不能保证其返回值是有效的 CSS。

Head️抬头！

此功能用于调试；它的输出格式不能保证在Sass版本或实现中保持一致。

SCSS
Sass
SCSS  语法@debug meta.inspect(10px 20px 30px); // unquote("10px 20px 30px")
@debug meta.inspect(("width": 200px)); // unquote('("width": 200px)')
@debug meta.inspect(null); // unquote("null")
@debug meta.inspect("Helvetica"); // unquote('"Helvetica"')
Sass语法@debug meta.inspect(10px 20px 30px)  // unquote("10px 20px 30px")
@debug meta.inspect(("width": 200px))  // unquote('("width": 200px)')
@debug meta.inspect(null)  // unquote("null")
@debug meta.inspect("Helvetica")  // unquote('"Helvetica"')

meta.keywords($args)
keywords($args) //=> map

返回传递给带有任意参数的mixin或函数的关键字。该$args参数必须是参数列表。

关键字从参数名称（作为未加引号的字符串（不包括$））到这些参数的值的映射返回。

SCSS
Sass
css
SCSS  语法@use "sass:meta";

@mixin syntax-colors($args...) {
  @debug meta.keywords($args);
  // (string: #080, comment: #800, variable: $60b)

  @each $name, $color in meta.keywords($args) {
    pre span.stx-#{$name} {
      color: $color;
    }
  }
}

@include syntax-colors(
  $string: #080,
  $comment: #800,
  $variable: #60b,
)
Sass语法@use "sass:meta"

@mixin syntax-colors($args...)
  @debug meta.keywords($args)
  // (string: #080, comment: #800, variable: $60b)

  @each $name, $color in meta.keywords($args)
    pre span.stx-#{$name}
      color: $color




@include syntax-colors($string: #080, $comment: #800, $variable: #60b)




CSS  输出pre span.stx-string {
  color: #080;
}

pre span.stx-comment {
  color: #800;
}

pre span.stx-variable {
  color: #60b;
}

meta.mixin-exists($name, $module: null)
mixin-exists($name, $module: null) //=> boolean

返回是否存在名为的mixin$name。

如果$module为is null，则返回是否$name存在没有命名空间的命名混合。否则，$module必须是与当前文件中@use规则的命名空间匹配的字符串，在这种情况下，这将返回该模块是否具有名为的mixin $name。

SCSS
Sass
SCSS  语法@debug meta.mixin-exists("shadow-none"); // false

@mixin shadow-none {
  box-shadow: none;
}

@debug meta.mixin-exists("shadow-none"); // true
Sass语法@debug meta.mixin-exists("shadow-none")  // false

@mixin shadow-none
  box-shadow: none


@debug meta.mixin-exists("shadow-none")  // true

meta.module-functions($module) //=> map

Dart·Sass（Dart Sass）: 从 1.23.0开始
LibSass: ✗
rubySass: ✗

当前仅Dart Sass支持此功能。

返回模块中定义的所有函数，作为从函数名称到函数值的映射。

该$module参数必须是与当前文件中@use规则的命名空间匹配的字符串。

SCSS
Sass
SCSS  语法// _functions.scss
@function pow($base, $exponent) {
  $result: 1;
  @for $_ from 1 through $exponent {
    $result: $result * $base;
  }
  @return $result;
}
@use "sass:map";
@use "sass:meta";

@use "functions";

@debug meta.module-functions("functions"); // ("pow": get-function("pow"))

@debug meta.call(map.get(meta.module-variables("functions"), "pow"), 3, 4); // 16
Sass语法// _functions.sass
@function pow($base, $exponent)
  $result: 1
  @for $_ from 1 through $exponent
    $result: $result * $base

  @return $result

@use "sass:map"
@use "sass:meta"

@use "functions"

@debug meta.module-functions("functions") // ("pow": get-function("pow"))

@debug meta.call(map.get(meta.module-variables("functions"), "pow"), 3, 4) // 16

meta.module-variables($module) //=> map

Dart·Sass（Dart Sass）: 从 1.23.0开始
LibSass: ✗
rubySass: ✗

当前仅Dart Sass支持此功能。

返回模块中定义的所有变量，作为变量名（不带$）到这些变量值的映射。

该$module参数必须是与当前文件中@use规则的命名空间匹配的字符串。

SCSS
Sass
SCSS  语法// _variables.scss
$hopbush: #c69;
$midnight-blue: #036;
$wafer: #e1d7d2;
@use "sass:meta";

@use "variables";

@debug meta.module-variables("variables");
// (
//   "hopbush": #c69,