sass:math

兼容性
Dart Sass
自 1.23.0 起
LibSass
Ruby Sass

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

变量变量永久链接

math.$e
兼容性
Dart Sass
自 1.25.0 起
LibSass
Ruby Sass

最接近 64 位浮点数的数学常数 e 近似值。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.$e; // 2.7182818285
游乐场

Sass 语法

@use 'sass:math'

@debug math.$e  // 2.7182818285
math.$epsilon
兼容性
Dart Sass
自 1.55.0 起
LibSass
Ruby Sass

1 和根据浮点比较大于 1 的最小 64 位浮点数之间的差值。由于 Sass 数字的10 位精度,在许多情况下这将看起来像 0。

math.$max-number
兼容性
Dart Sass
自 1.55.0 起
LibSass
Ruby Sass

可以表示为 64 位浮点数的 最大有限数。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.$max-number; // 179769313486231570000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
游乐场

Sass 语法

@use 'sass:math'

@debug math.$max-number  // 179769313486231570000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000
math.$max-safe-integer
兼容性
Dart Sass
自 1.55.0 起
LibSass
Ruby Sass

最大整数 n,使得 nn + 1 都可以精确地表示为 64 位浮点数 

游乐场

SCSS 语法

@use 'sass:math';

@debug math.$max-safe-integer; // 9007199254740991
游乐场

Sass 语法

@use 'sass:math'

@debug math.$max-safe-integer  // 9007199254740991
math.$min-number
兼容性
Dart Sass
自 1.55.0 起
LibSass
Ruby Sass

可以表示为 64 位浮点数的最小正数。由于 Sass 数字的10 位精度,在许多情况下这将看起来像 0。

math.$min-safe-integer
兼容性
Dart Sass
自 1.55.0 起
LibSass
Ruby Sass

最小整数 n,使得 nn - 1 都可以精确地表示为 64 位浮点数 

游乐场

SCSS 语法

@use 'sass:math';

@debug math.$min-safe-integer; // -9007199254740991
游乐场

Sass 语法

@use 'sass:math'

@debug math.$min-safe-integer  // -9007199254740991
math.$pi
兼容性
Dart Sass
自 1.25.0 起
LibSass
Ruby Sass

最接近 64 位浮点数的数学常数 π 近似值。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.$pi; // 3.1415926536
游乐场

Sass 语法

@use 'sass:math'

@debug math.$pi  // 3.1415926536

边界函数边界函数永久链接

math.ceil($number)
ceil($number) //=> number

$number 向上舍入到下一个最高整数 

游乐场

SCSS 语法

@use 'sass:math';

@debug math.ceil(4); // 4
@debug math.ceil(4.2); // 5
@debug math.ceil(4.9); // 5
游乐场

Sass 语法

@use 'sass:math'

@debug math.ceil(4)  // 4
@debug math.ceil(4.2)  // 5
@debug math.ceil(4.9)  // 5
math.clamp($min, $number, $max) //=> number
兼容性
Dart Sass
自 1.25.0 起
LibSass
Ruby Sass

$number 限制在 $min$max 之间的范围内。如果 $number 小于 $min,则返回 $min,如果它大于 $max,则返回 $max

$min$number$max 必须具有兼容的单位,或者全部为 无单位。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.clamp(-1, 0, 1); // 0
@debug math.clamp(1px, -1px, 10px); // 1px
@debug math.clamp(-1in, 1cm, 10mm); // 10mm
游乐场

Sass 语法

@use 'sass:math'

@debug math.clamp(-1, 0, 1) // 0
@debug math.clamp(1px, -1px, 10px) // 1px
@debug math.clamp(-1in, 1cm, 10mm) // 10mm
math.floor($number)
floor($number) //=> number

$number 向下舍入到下一个最低整数 

游乐场

SCSS 语法

@use 'sass:math';

@debug math.floor(4); // 4
@debug math.floor(4.2); // 4
@debug math.floor(4.9); // 4
游乐场

Sass 语法

@use 'sass:math'

@debug math.floor(4)  // 4
@debug math.floor(4.2)  // 4
@debug math.floor(4.9)  // 4
math.max($number...)
max($number...) //=> number

返回一个或多个 数字中最高的那个。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.max(1px, 4px); // 4px

$widths: 50px, 30px, 100px;
@debug math.max($widths...); // 100px
游乐场

Sass 语法

@use 'sass:math'

@debug math.max(1px, 4px)  // 4px

$widths: 50px, 30px, 100px
@debug math.max($widths...)  // 100px
math.min($number...)
min($number...) //=> number

返回一个或多个 数字中最低的那个。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.min(1px, 4px); // 1px

$widths: 50px, 30px, 100px;
@debug math.min($widths...); // 30px
游乐场

Sass 语法

@use 'sass:math'

@debug math.min(1px, 4px)  // 1px

$widths: 50px, 30px, 100px
@debug math.min($widths...)  // 30px
math.round($number)
round($number) //=> number

$number 舍入到最接近的整数 

游乐场

SCSS 语法

@use 'sass:math';

@debug math.round(4); // 4
@debug math.round(4.2); // 4
@debug math.round(4.9); // 5
游乐场

Sass 语法

@use 'sass:math'

@debug math.round(4)  // 4
@debug math.round(4.2)  // 4
@debug math.round(4.9)  // 5

距离函数距离函数永久链接

math.abs($number)
abs($number) //=> number

返回 $number绝对值。如果 $number 为负数,则返回 -$number,如果 $number 为正数,则按原样返回 $number

游乐场

SCSS 语法

@use 'sass:math';

@debug math.abs(10px); // 10px
@debug math.abs(-10px); // 10px
游乐场

Sass 语法

@use 'sass:math'

@debug math.abs(10px) // 10px
@debug math.abs(-10px) // 10px
math.hypot($number...) //=> number
兼容性
Dart Sass
自 1.25.0 起
LibSass
Ruby Sass

返回每个 $number 等于组件的 n向量 的长度。例如,对于三个数字 abc,这将返回 a² + b² +  的平方根。

这些数字必须要么全部具有兼容的单位,要么全部为无单位。并且由于这些数字的单位可能不同,因此输出将采用第一个 数字的单位。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.hypot(3, 4); // 5

$lengths: 1in, 10cm, 50px;
@debug math.hypot($lengths...); // 4.0952775683in
游乐场

Sass 语法

@use 'sass:math'

@debug math.hypot(3, 4) // 5

$lengths: 1in, 10cm, 50px
@debug math.hypot($lengths...) // 4.0952775683in

指数函数指数函数永久链接

math.log($number, $base: null) //=> number
兼容性
Dart Sass
自 1.25.0 起
LibSass
Ruby Sass

返回 $number 相对于 $base对数。如果 $basenull,则计算自然对数 

$number$base 必须为 无单位。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.log(10); // 2.302585093
@debug math.log(10, 10); // 1
游乐场

Sass 语法

@use 'sass:math'

@debug math.log(10) // 2.302585093
@debug math.log(10, 10) // 1
math.pow($base, $exponent) //=> number
兼容性
Dart Sass
自 1.25.0 起
LibSass
Ruby Sass

$base 提升到 $exponent 幂。

$base$exponent 必须为 无单位。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.pow(10, 2); // 100
@debug math.pow(100, math.div(1, 3)); // 4.6415888336
@debug math.pow(5, -2); // 0.04
游乐场

Sass 语法

@use 'sass:math'

@debug math.pow(10, 2) // 100
@debug math.pow(100, math.div(1, 3)) // 4.6415888336
@debug math.pow(5, -2) // 0.04
math.sqrt($number) //=> number
兼容性
Dart Sass
自 1.25.0 起
LibSass
Ruby Sass

返回 $number平方根

$number 必须为 无单位。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.sqrt(100); // 10
@debug math.sqrt(math.div(1, 3)); // 0.5773502692
@debug math.sqrt(-1); // NaN
游乐场

Sass 语法

@use 'sass:math'

@debug math.sqrt(100) // 10
@debug math.sqrt(math.div(1, 3)) // 0.5773502692
@debug math.sqrt(-1) // NaN

三角函数三角函数永久链接

math.cos($number) //=> number
兼容性
Dart Sass
自 1.25.0 起
LibSass
Ruby Sass

返回 $number余弦

$number 必须是一个角度(它的单位必须与 deg 兼容)或无单位。如果 $number 没有单位,则假定它为 rad

游乐场

SCSS 语法

@use 'sass:math';

@debug math.cos(100deg); // -0.1736481777
@debug math.cos(1rad); // 0.5403023059
@debug math.cos(1); // 0.5403023059
游乐场

Sass 语法

@use 'sass:math'

@debug math.cos(100deg) // -0.1736481777
@debug math.cos(1rad) // 0.5403023059
@debug math.cos(1) // 0.5403023059
math.sin($number) //=> number
兼容性
Dart Sass
自 1.25.0 起
LibSass
Ruby Sass

返回 $number正弦

$number 必须是一个角度(它的单位必须与 deg 兼容)或无单位。如果 $number 没有单位,则假定它为 rad

游乐场

SCSS 语法

@use 'sass:math';

@debug math.sin(100deg); // 0.984807753
@debug math.sin(1rad); // 0.8414709848
@debug math.sin(1); // 0.8414709848
游乐场

Sass 语法

@use 'sass:math'

@debug math.sin(100deg) // 0.984807753
@debug math.sin(1rad) // 0.8414709848
@debug math.sin(1) // 0.8414709848
math.tan($number) //=> number
兼容性
Dart Sass
自 1.25.0 起
LibSass
Ruby Sass

返回 $number正切

$number 必须是一个角度(它的单位必须与 deg 兼容)或无单位。如果 $number 没有单位,则假定它为 rad

游乐场

SCSS 语法

@use 'sass:math';

@debug math.tan(100deg); // -5.6712818196
@debug math.tan(1rad); // 1.5574077247
@debug math.tan(1); // 1.5574077247
游乐场

Sass 语法

@use 'sass:math'

@debug math.tan(100deg) // -5.6712818196
@debug math.tan(1rad) // 1.5574077247
@debug math.tan(1) // 1.5574077247
math.acos($number) //=> number
兼容性
Dart Sass
自 1.25.0 起
LibSass
Ruby Sass

返回 $number反余弦,以 deg 为单位。

$number 必须为 无单位。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.acos(0.5); // 60deg
@debug math.acos(2); // NaNdeg
游乐场

Sass 语法

@use 'sass:math'

@debug math.acos(0.5) // 60deg
@debug math.acos(2) // NaNdeg
math.asin($number) //=> number
兼容性
Dart Sass
自 1.25.0 起
LibSass
Ruby Sass

返回 $number反正弦,以 deg 为单位。

$number 必须为 无单位。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.asin(0.5); // 30deg
@debug math.asin(2); // NaNdeg
游乐场

Sass 语法

@use 'sass:math'

@debug math.asin(0.5) // 30deg
@debug math.asin(2) // NaNdeg
math.atan($number) //=> number
兼容性
Dart Sass
自 1.25.0 起
LibSass
Ruby Sass

返回 $number反正切,以 deg 为单位。

$number 必须为 无单位。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.atan(10); // 84.2894068625deg
游乐场

Sass 语法

@use 'sass:math'

@debug math.atan(10) // 84.2894068625deg
math.atan2($y, $x) //=> number
兼容性
Dart Sass
自 1.25.0 起
LibSass
Ruby Sass

返回 $y$x2 参数反正切,以 deg 为单位。

$y$x 必须具有兼容的单位或为 无单位。

💡 有趣的事实

math.atan2($y, $x) 不同于 atan(math.div($y, $x)),因为它保留了相关点的象限。例如,math.atan2(1, -1) 对应于点 (-1, 1) 并返回 135deg。相比之下,math.atan(math.div(1, -1))math.atan(math.div(-1, 1)) 首先解析为 atan(-1),因此两者都返回 -45deg

游乐场

SCSS 语法

@use 'sass:math';

@debug math.atan2(-1, 1); // 135deg
游乐场

Sass 语法

@use 'sass:math'

@debug math.atan2(-1, 1) // 135deg

单位函数单位函数永久链接

math.compatible($number1, $number2)
comparable($number1, $number2) //=> boolean

返回 $number1$number2 是否具有兼容的 单位。

如果返回 true,则 $number1$number2 可以安全地进行加法减法比较。否则,这样做会导致 错误。

⚠️ 注意!

此函数的全局名称是 comparable,但在将其添加到 sass:math 模块时,名称更改为 compatible,以便更清楚地传达函数 的功能。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.compatible(2px, 1px); // true
@debug math.compatible(100px, 3em); // false
@debug math.compatible(10cm, 3mm); // true
游乐场

Sass 语法

@use 'sass:math'

@debug math.compatible(2px, 1px)  // true
@debug math.compatible(100px, 3em)  // false
@debug math.compatible(10cm, 3mm)  // true
math.is-unitless($number)
unitless($number) //=> boolean

返回 $number 是否没有 单位。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.is-unitless(100); // true
@debug math.is-unitless(100px); // false
游乐场

Sass 语法

@use 'sass:math'

@debug math.is-unitless(100)  // true
@debug math.is-unitless(100px)  // false
math.unit($number)
unit($number) //=> quoted string

返回 $number 单位的字符串表示形式。

⚠️ 注意!

此函数旨在用于调试;它的输出格式不保证在 Sass 版本或 实现之间保持一致。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.unit(100); // ""
@debug math.unit(100px); // "px"
@debug math.unit(5px * 10px); // "px*px"
@debug math.unit(math.div(5px, 1s)); // "px/s"
游乐场

Sass 语法

@use 'sass:math'

@debug math.unit(100)  // ""
@debug math.unit(100px)  // "px"
@debug math.unit(5px * 10px)  // "px*px"
@debug math.unit(math.div(5px, 1s))  // "px/s"

其他函数其他函数永久链接

math.div($number1, $number2) //=> number
兼容性
Dart Sass
自 1.33.0 起
LibSass
Ruby Sass

返回 $number1 除以 $number2 的结果。

两个数字共有的任何单位都将被抵消。$number1 中不在 $number2 中的单位将最终出现在返回值的分子中,而 $number2 中不在 $number1 中的单位将最终出现在其 分母中。

⚠️ 注意!

出于向后兼容性的目的,这将返回与已弃用的 / 运算符 完全相同的结果,包括将两个字符串与它们之间的 / 字符连接在一起。但是,这种行为最终将被移除,不应该在新 样式表中使用。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.div(1, 2); // 0.5
@debug math.div(100px, 5px); // 20
@debug math.div(100px, 5); // 20px
@debug math.div(100px, 5s); // 20px/s
游乐场

Sass 语法

@use 'sass:math'

@debug math.div(1, 2)  // 0.5
@debug math.div(100px, 5px)  // 20
@debug math.div(100px, 5)  // 20px
@debug math.div(100px, 5s)  // 20px/s
math.percentage($number)
percentage($number) //=> number

将无单位的 $number(通常是 0 到 1 之间的十进制数)转换为 百分比。

💡 有趣的事实

此函数与 $number * 100% 相同。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.percentage(0.2); // 20%
@debug math.percentage(math.div(100px, 50px)); // 200%
游乐场

Sass 语法

@use 'sass:math'

@debug math.percentage(0.2)  // 20%
@debug math.percentage(math.div(100px, 50px))  // 200%
math.random($limit: null)
random($limit: null) //=> number

如果 $limitnull,则返回 0 到 1 之间的随机十进制数。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.random(); // 0.2821251858
@debug math.random(); // 0.6221325814
游乐场

Sass 语法

@use 'sass:math'

@debug math.random()  // 0.2821251858
@debug math.random()  // 0.6221325814

如果 $limit 是一个大于或等于 1 的数字,则返回 1 到 $limit 之间的随机整数。

⚠️ 注意!

random() 会忽略 $limit 中的单位。 此行为已弃用random($limit) 将返回一个与 $limit 参数具有相同单位的随机整数。

游乐场

SCSS 语法

@use 'sass:math';

@debug math.random(100px); // 42
游乐场

Sass 语法

@use 'sass:math'

@debug math.random(100px)  // 42
游乐场

SCSS 语法

@use 'sass:math';

@debug math.random(10); // 4
@debug math.random(10000); // 5373
游乐场

Sass 语法

@use 'sass:math'

@debug math.random(10)  // 4
@debug math.random(10000)  // 5373