sass:math

变量

math.$e

等于数学常数e的值。

@debug math.$e; // 2.7182818285

math.$pi

等于数学常数π的值。

@debug math.$pi; // 3.1415926536

边界函数

math.ceil()

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

四舍五入$number到下一个最大的整数。

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

math.clamp()

math.clamp($min, $number, $max) //=> number 

将$number限制在$min和$max之间。如果$number小于$min，则返回$min；如果大于$max，则返回$max。$min、$number和$max必须具有兼容的单元，或者都是无单元的。

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

math.floor()

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

向下舍入$number到下一个最小的整数。

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

math.max()

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

返回一个或多个数字中的最大值。

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

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

math.min()

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

返回一个或多个数字中的最小值。

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

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

math.round()

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

四舍五入$number到最接近的整数。

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

距离函数

math.abs()

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

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

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

math.hypot()

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

返回具有等于每个$number的分量的n维向量的长度。例如，对于三个数字a、b和c，这将返回a²+b²+c²的平方根。这些数字必须要么都具有兼容的单位，要么都没有单位。由于数字的单位可能不同，因此输出采用第一个数字的单位。

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

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

指数函数

math.log()

math.log($number, $base: null) //=> number 

返回$number相对于$base的对数。如果$base为空，则计算自然对数。$number和$base必须是无单位的。

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

math.pow()

math.pow($base, $exponent) //=> number 

将$base提高到$exponent的幂。$base和$exponent必须是无单位的。

@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()

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

返回$number的平方根。$number必须是无单位的。

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

三角函数

math.cos()

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

返回$number的余弦。$number必须是角度（其单位必须与deg兼容）或无单位。如果$number没有单位，，则假设其单位为rad。

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

math.sin()

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

返回$number的正弦值。$number必须是角度（其单位必须与deg兼容）或无单位。如果$number没有单位，则假设其单位为rad。

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

math.tan()

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

返回$number的正切。$number必须是角度（其单位必须与deg兼容）或无单位。如果$number没有单位，则假设其单位为rad。

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

math.acos()

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

返回以度为单位的$number的反余弦。$number必须是无单位的。

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

math.asin()

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

返回以度为单位的$number的反正弦值。$number必须是无单位的。

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

math.atan()

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

返回以度为单位的$number的反正切值。$number必须是无单位的。

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

math.atan2()

math.atan2($y, $x) //=> number 

返回以度为单位的$y和$x的2参数反正切。$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。

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

单位功能

math.compatible()

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

返回是否$number1并$number2具有兼容的单位。如果返回true，$number1并且$number2可以安全地进行加法、减法和比较。否则，这样做会产生错误。

⚠️注意！
该函数的全局名称是可比较的，但当它被添加到 sass:math 模块时，名称被更改为 compatible，以更清楚地传达函数的功能。

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

math.is-unitless()

math.is-unitless($number)
unitless($number) //=> boolean

返回是否$number没有单位。

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

math.unit()

math.unit($number)
unit($number) //=> quoted string

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

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

@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()

math.div($number1, $number2) //=> number

返回将$number1除以$number2的结果。两个数字共享的任何单元都将被取消。$number1中不在$number2中的单位将在返回值的分子中结束，而$number2中不在$number1中的单位将在其分母中结束。

⚠️注意！
出于向后兼容的目的，这将返回与不推荐使用的/运算符完全相同的结果，包括将两个字符串连接在一起并在它们之间使用/字符。然而，这种行为最终将被删除，不应在新的样式表中使用。

@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()

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

将无单位$number（通常是 0 和 1 之间的小数）转换为百分比。

此功能与$number * 100%

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

math.random()

math.random($limit: null)
random($limit: null) //=> number

如果$limit是null，则返回 0 到 1 之间的随机十进制数。

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

如果$limit是大于或等于 1 的数字，则返回 1 和$limit之间的随机整数。

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

鹏仔微信 15129739599 鹏仔QQ344225443 鹏仔前端 pjxi.com 共享博客 sharedbk.com