Functions（功能）

abs($number)

返回数字的绝对值。

例子：

参数：

• $number (Number)

返回：

• (Number)

增加：

• （ArgumentError） - 如果$ number不是数字

adjust_color($color, $red, $green, $blue, $hue, $saturation, $lightness, $alpha)

增加或减少颜色的一个或多个属性。这可以改变红色、绿色、蓝色、色调、饱和度、值和alpha属性。属性被指定为关键字参数，并被添加到该属性的颜色当前值或从该属性的当前值中减去。

所有属性都是可选的。你不能同时在同一时间指定RGB属性（$red，$green，$blue）和HSL属性（$hue，$saturation，$value）。

例子：

参数：

• $ color（Color）
• $ red（Number） - 对红色组件进行的调整，介于-255和255之间
• $ green（Number） - 在绿色组件上进行的调整，介于-255和255之间
• $ blue（Number） - 在蓝色组件上进行的调整，介于-255和255之间
• $ hue（Number） - 对色相组件进行的调整，以度为单位
• $ saturation（Number） - 在饱和度分量上进行的调整，范围在-100％和100％之间
• $ lightness（Number） - 亮度分量的调整值，在-100％和100％之间
• $ alpha（Number） - 对alpha组件进行的调整，介于-1和1之间

返回：

• (Color)

增加：

• （ArgumentError） - 如果有任何参数是错误的类型或者出界，或者RGB属性和HSL属性同时被调整。

adjust_hue($color, $degrees)

改变颜色的色调。采用颜色和度数（通常介于-360deg和360deg之间），并返回一个颜色，并沿着色轮以该数量旋转色调。

例子：

参数：

• $ color（Color）
• $ degrees（Number） - 旋转色相的度数

返回：

• (Color)

增加：

• （ArgumentError） - 如果任一参数是错误的类型

alpha($color)

返回颜色的alpha分量（不透明度）。除非另有说明，这是1。

此功能还支持专有的Microsoft alpha(opacity=20)语法作为特例。

参数：

• $color (Color)

返回：

• （Number） - α分量，介于0和1之间

增加:

• （ArgumentError） - 如果$ color不是一种颜色

append($list, $val, $separator:auto)

将单个值附加到列表的末尾。

除非通过$separator参数，否则如果列表只有一个项目，则结果列表将以空格分隔。

像所有列表函数一样，append()返回一个新列表而不是修改它的参数。

例子：

参数：

• $ list（Base）
• $ val（Base）
• $ separator（String） - 要使用的列表分隔符。如果这是逗号或空格，将使用该分隔符。如果这是自动的（默认），则按上面所述确定分隔符。

返回：

• (List)

blue($color)

获取颜色的蓝色部分。必要时通过该算法从HSL中计算。

参数：

• $color (Color)

返回：

• （Number） - 蓝色分量，介于0和255之间（包括0和255）

Raises:

• (ArgumentError) — if $color isn't a color

call($function, $args...)

动态调用一个函数。这可以调用用户定义的函数，内置函数或纯CSS函数。它会将所有参数（包括关键字参数）传递给被调用的函数。

例子：

参数：

• $ function（Function） - 要调用的函数。

ceil($number)

将数字四舍五入到下一个整数。

例子：

参数：

• $number (Number)

返回：

• (Number)

增加：

• （ArgumentError） - 如果$ number不是数字

change_color($color, $red, $green, $blue, $hue, $saturation, $lightness, $alpha)

更改颜色的一个或多个属性。这可以改变红色，绿色，蓝色，色调，饱和度，值以及alpha属性。这些属性被指定为关键字参数，并替换该属性的颜色当前值。

所有属性都是可选的。你不能同时指定RGB属性（$red，$green，$blue）和HSL属性（$hue，$saturation，$value）在同一时间。

例子：

参数：

• $ color（Color）
• $ red（Number） - 颜色的新红色分量，在0到255之间
• $ green（Number） - 颜色的新绿色组件，在0到255之间
• $ blue（Number） - 颜色的新蓝色分量，在0到255之间
• $ hue（Number） - 颜色的新色相组件，以度为单位
• $ saturation（Number） - 颜色的新饱和度分量，介于0％和100％之间
• $ lightness（Number） - 颜色的新亮度分量，在0％和100％范围内
• $ alpha（Number） - 颜色的新alpha组件，在0和1范围内

返回：

• (Color)

增加：

• （ArgumentError） - 如果有任何参数是错误的类型或出界，或者RGB属性和HSL属性同时被调整

comparable($number1, $number2)

返回是否可以添加，减去或比较两个数字。

例子：

参数：

• $number1 (Number)
• $number2 (Number)

返回：

• (Bool)

增加：

• （ArgumentError） - 如果任一参数是错误的类型

complement($color)

返回颜色的补码。这与adjust-hue(color, 180deg)相同。

参数：

• $color (Color)

返回：

• (Color)

增加：

• （ArgumentError） - 如果$ color不是一种颜色

content_exists

检查一个mixin是否通过了一个内容块。

除非content-exists()直接从mixin调用，否则会引发错误。

例子：

返回：

• （Bool） - 内容块是否传递给了mixin。

counter($args...)

此功能仅作为IE7 content: counter错误的解决方法而存在。它与任何其他纯CSS功能的工作方式相同，只是它避免了在参数逗号之间添加空格。

例子：

返回：

• (String)

counters($args...)

此功能仅作为IE7 content: counter错误的解决方法而存在。它与任何其他纯CSS功能的工作方式相同，只是它避免了在参数逗号之间添加空格。

例子：

返回：

• (String)

darken($color, $amount)

使颜色变深。使用0％到100％之间的颜色和数字，并返回一个颜色，亮度降低该数量。

例子：

参数：

• $ color（Color）
• $ amount（数量） - 减少0％到100％之间亮度的数量

返回：

• (Color)

增加：

• （ArgumentError） - 如果$ amount超出范围，或者两个参数都是错误的类型

desaturate($color, $amount)

使颜色饱和度降低。取一个颜色和一个介于0％和100％之间的数字，并返回一个颜色，饱和度降低该值。

例子：

参数：

• $ color（Color）
• $ amount（数量） - 减少饱和度的数量，介于0％和100％之间

返回：

• (Color)

增加：

• （ArgumentError） - 如果$ amount超出范围，或者两个参数都是错误的类型

feature_exists($feature)

返回当前Sass运行时是否存在功能。

支持以下功能：

• global-variable-shadowing表示一个局部变量将会影响一个全局变量，除非!global被使用。
• extend-selector-pseudoclass表示@extend将进入选择器伪类似:not。
• units-level-3表示完全支持使用“ 值和单位3级”规范中定义的单位进行单位算术运算。
• at-error表示支持Sass @error指令。
• custom-property表示支持自定义属性级别1规范。这意味着自定义属性是静态分析的，只有插值被视为SassScript。

例子：

参数：

• $ feature（String） - 要素的名称

返回：

• （Bool） - 该版本的Sass是否支持该功能

增加：

• （ArgumentError） - 如果$ feature不是一个字符串

floor($number)

将数字向下舍入到前一个整数。

例子：

参数：

• $number (Number)

返回：

• (Number)

Raises:

• （ArgumentError） - 如果$ number不是数字

function_exists($name)

Check whether a function with the given name exists.

Examples:

参数：

• name（String） - 要检查的函数的名称或函数引用。

返回：

• （Bool） - 功能是否被定义。

get_function($name, $css:false)

返回对函数的引用，以便稍后使用该call()函数调用。

如果$css是false，函数引用可能引用样式表中定义的函数或内置于主机环境的函数。如果它是true指一个纯CSS的函数。

例子：

参数：

• name（String） - 被引用函数的名称。
• css（Bool） - 是否获得普通的CSS函数。

返回：

• （Function） - 功能参考。

global_variable_exists($name)

检查具有给定名称的变量是否存在于全局范围内（在文件的顶层）。

例子：

参数：

• $ name（String） - 要检查的变量的名称。该名称不应包含$。

返回：

• （Bool） - 变量是否在全局范围内定义。

grayscale($color)

将颜色转换为灰度。这与之相同desaturate(color, 100%)。

参数：

• $color (Color)

返回：

• (Color)

增加：

• （ArgumentError） - 如果$ color不是一种颜色

green($color)

获取颜色的绿色部分。必要时通过该算法从HSL计算。

参数：

• $color (Color)

返回：

• （Number） - 绿色部分，介于0和255之间

增加：

• （ArgumentError） - 如果$ color不是一种颜色

hsl($hue, $saturation, $lightness)

根据色调，饱和度和亮度值创建颜色。使用CSS3规范中的算法。

参数：

• $ hue（Number） - 颜色的色调。应该在0到360度之间，包括在内
• $ saturation（Number） - 颜色的饱和度。必须介于0％和100％之间，包括0和100％
• $ lightness（Number） - 颜色的亮度。必须介于0％和100％之间，包括0和100％

返回：

• (Color)

增加：

• （ArgumentError） - 如果$ saturation或$ lightness超出范围，或者任何参数都是错误的类型

hsla($hue, $saturation, $lightness, $alpha)

根据色调，饱和度，亮度和Alpha值创建颜色。使用CSS3规范中的算法。

参数：

• $ hue（Number） - 颜色的色调。应该在0到360度之间，包括在内
• $ saturation（Number） - 颜色的饱和度。必须介于0％和100％之间，包括0和100％
• $ lightness（Number） - 颜色的亮度。必须介于0％和100％之间，包括0和100％
• $ alpha（Number） - 颜色的不透明度。必须介于0和1之间，包括0和1

返回：

• (Color)

增加：

• （ArgumentError） - 如果$ saturation，$ lightness或$ alpha超出范围或者任何参数是错误的类型

hue($color)

返回颜色的色相分量。请参阅CSS3 HSL规范。在必要时通过该算法从RGB计算。

参数：

• $color (Color)

返回：

• （Number） - 色调成分，介于0deg和360deg之间

增加：

• （ArgumentError） - 如果$ color不是一种颜色

ie_hex_str($color)

将颜色转换为IE筛选器可理解的格式。

例子：

参数：

• $color (Color)

返回：

• （String） - 颜色的IE格式的字符串表示形式

增加：

• （ArgumentError） - 如果$ color不是一种颜色

if($condition, $if-true, $if-false)

根据是否$condition为真返回两个值中的一个。就像在@if，比其他所有的值false和null被认为是真的。

例子：

参数：

• $ condition（Base） - 是否返回$ if-true或$ if-false
• $ if-true（Tree :: Node）
• $ if-false（Tree :: Node）

返回：

• (Base) — $if-true or $if-false

index($list, $value)

返回列表中某个值的位置。如果找不到该值，则返回null。

请注意，与某些语言不同，Sass列表中的第一项是数字1，第二个数字是2，依此类推。

这可以返回地图中一对的位置。

例子：

参数：

• $list (Base)
• $value (Base)

返回：

• （Number，Null） - $ list中从$ 1开始的索引，或者为null

inspect($value)

返回一个包含该值的字符串作为其Sass表示。

参数：

• $ value（Base） - 要检查的值。

返回：

• （String） - 表示将在Sass中写入的值。

invert($color) invert($color, $weight:100%)

返回颜色的反（负）。红色，绿色和蓝色的值是倒置的，而不透明度是独立的。

重载：

• 反转（$ color）参数：

• 反转（$ color，$ weight：100％）参数：

返回：

• (Color)

增加：

• （ArgumentError） - 如果$ color不是颜色或$ weight不是0％到100％之间的百分比

is_bracketed($list)

返回列表是否使用方括号。

例子：

参数：

• $list (Base)

返回：

• (Bool)

is_superselector($super, $sub)

返回是否$super是超级选择器$sub。这意味着$super匹配所有匹配的元素，$sub以及可能的附加元素。一般来说，简单的选择器往往是更复杂的超级选择器。

例子：

返回是否$selector1是一个超级选择器$selector2。

参数：

• $ super（String，List） - 潜在的超级选择器。这可以是字符串，字符串列表或由＆返回的字符串列表列表。
• $ sub（String，List） - 潜在的子选择器。这可以是字符串，字符串列表或由＆返回的字符串列表列表。

返回：

• （Bool） - $ selector1是否是$ selector2的超级选择器。

join($list1, $list2, $separator:auto, $bracketed:auto)

将两个列表合并成一个。

除非$separator通过，否则，如果一个列表以逗号分隔且一个以空格分隔，则第一个参数的分隔符将用于结果列表。如果两个列表都少于两个项目，则空格将用于结果列表。

除非$bracketed通过，否则如果第一个参数是，则结果列表被括起来。

像所有列表函数一样，join()返回一个新列表而不是修改其参数。

例子：

参数：

• $ list1（Base）
• $ list2（Base）
• $ separator（String） - 要使用的列表分隔符。如果这是逗号或空格，将使用该分隔符。如果这是自动的（默认），则按上面所述确定分隔符。
• $括号（Base） - 结果列表是否被括起来。如果这是自动的（默认），则按上面所述确定分隔符。

返回：

• (List)

keywords($args)

返回传递给具有可变参数列表的函数或mixin的命名参数的映射。参数名称是字符串，并且不包含前导$。

例子：

参数：

• $args (ArgList)

返回：

• (Map)

增加：

• （ArgumentError） - 如果$ args不是可变参数列表

length($list)

返回列表的长度。

这也可以返回地图中对的数量。

例子：

参数：

• $list (Base)

返回：

• (Number)

lighten($color, $amount)

使颜色变浅。在0%和100%之间取一个颜色和一个数字，并返回一个颜色，亮度增加了该数量。

例子：

参数：

• $ color（Color）
• $ amount（数量） - 增加亮度的量，介于0％和100％之间

返回：

• (Color)

增加：

• （ArgumentError） - 如果$ amount超出范围，或者两个参数都是错误的类型

lightness($color)

返回颜色的亮度分量。请参阅CSS3 HSL规范。在必要时通过该算法从RGB计算。

参数：

• $color (Color)

返回：

• （Number） - 亮度分量，介于0％和100％之间

增加：

• （ArgumentError） - 如果$ color不是一种颜色

list_separator($list)

返回列表的分隔符。如果由于少于两个元素而导致列表中没有分隔符，则返回space。

例子：

参数：

• $list (Base)

返回：

• （String） - 逗号或空格

map_get($map, $key)

返回与给定键相关联的映射中的值。如果地图没有这样的密钥，则返回null。

例子：

参数：

• $map (Map)
• $key (Base)

返回：

• （Base） - 由$ key索引的值，如果映射不包含给定的键，则为null

增加：

• （ArgumentError） - 如果$ map不是地图

map_has_key($map, $key)

返回映射是否具有与给定键相关联的值。

例子：

参数：

• $map (Map)
• $key (Base)

返回：

• (Bool)

增加：

• （ArgumentError） - 如果$ map不是地图

map_keys($map)

返回地图中所有键的列表。

例子：

参数：

• $map (Map)

返回：

• （List） - 用逗号分隔的键列表

增加：

• （ArgumentError） - 如果$ map不是地图

map_merge($map1, $map2)

将两张地图合并成一张新地图。在键$map2将优先于键$map1。

这是向地图添加新值的最佳方式。

返回的地图中的所有键也会出现在$map1并与$map1中的顺序相同。从$map2出的新的键将放置在地图的末尾。

像所有的地图函数一样，map-merge()返回一个新的地图而不是修改它的参数。

例子：

参数：

• $map1 (Map)
• $map2 (Map)

返回：

• (Map)

增加：

• （ArgumentError） - 如果任一参数不是地图

map_remove($map, $keys...)

返回删除了键的新地图。

像所有的地图函数一样，map-merge()返回一个新的地图而不是修改它的参数。

例子：

参数：

• $map (Map)
• $keys (Base)

返回：

• (Map)

增加：

• （ArgumentError） - 如果$ map不是地图

map_values($map)

返回地图中所有值的列表。如果多个键具有相同的值，则此列表可能包含重复的值。

例子：

参数：

• $map (Map)

返回：

• （List） - 以逗号分隔的值列表

增加：

• (ArgumentError) — if $map is not a map

max($numbers...)

查找最多的几个数字。该函数可以使用任意数量的参数。

例子：

参数：

• $numbers (Number)

返回：

• (Number)

增加：

• （ArgumentError） - 如果任何参数不是数字，或者如果不是所有参数都有可比较的单位

min($numbers...)

查找几个数字中的最小值。该函数可以使用任意数量的参数。

例子：

参数：

• $numbers (Number)

返回：

• (Number)

增加：

• （ArgumentError） - 如果任何参数不是数字，或者如果不是所有参数都有可比较的单位

mix($color1, $color2, $weight:50%)

将两种颜色混合在一起。具体来说，取每个RGB分量的平均值，可选地按给定百分比加权。加权组件时也会考虑颜色的不透明度。

重量指定应该包含在返回的颜色中的第一种颜色的数量。默认值，50%意味着应该使用第一种颜色的一半和第二种颜色的一半。25%意味着应该使用第一种颜色的四分之一和第二种颜色的四分之三。

例子：

参数：

• $ color1（Color）
• $ color2（Color）
• $ weight（Number） - 每种颜色的相对重量。接近100％给予$ color1更多的权重，接近0％给予$ color2更多的权重

返回：

• (Color)

增加：

• （ArgumentError） - 如果$ weight超出范围或者任何参数是错误的类型

mixin_exists($name)

检查是否存在具有给定名称的混音。

例子：

参数：

• name（String） - 要检查的mixin的名称。

返回：

• （Bool） - mixin是否被定义。

nth($list, $n)

获取列表中的第n个项目。

请注意，与某些语言不同，Sass列表中的第一项是数字1，第二个数字是2，依此类推。

这也可以返回地图中的第n对。

负索引值以相反顺序处理元素，从列表中的最后一个元素开始。

例子：

参数：

• $ list（Base）
• $ n（Number） - 要获取的项目的索引。负数来自列表末尾。

返回：

• (Base)

增加：

• （ArgumentError） - 如果$ n不是1和$ list长度之间的整数

opacify($color, $amount) Also known as: fade_in

使颜色更加不透明。采用0到1之间的颜色和数字，并返回一个颜色，并将不透明度增加该数量。

例子：

参数：

• $ color（Color）
• $ amount（Number） - 在0和1之间增加不透明度的数量

返回：

• (Color)

增加：

• （ArgumentError） - 如果$ amount超出范围，或者两个参数都是错误的类型

opacity($color)

返回颜色的alpha分量（不透明度）。除非另有说明，这就是1。

参数：

• $color (Color)

返回：

• （Number） - α分量，介于0和1之间

增加：

• （ArgumentError） - 如果$ color不是一种颜色

percentage($number)

将无单位数转换为百分比。

例子：

参数：

• $number (Number)

返回：

• (Number)

增加：

• （ArgumentError） - 如果$ number不是一个无单位的数字

quote($string)

如果字符串未被引用，则将引号添加到字符串；如果是，则返回相同的字符串。

例子：

参数：

• $string (String)

返回：

• (String)

增加：

• （ArgumentError） - 如果$ string不是字符串

random random($limit)

重载：

• 随机 在0和1之间返回一个小数，包括0但不是1.返回：

• random（$ limit）返回1和$limit之间的整数，包括1和$limit。参数：