跳到主要内容

函数

Stylus 具有强大的语言内函数定义功能。函数定义与 mixin 完全相同；但是，函数可以返回一个值。

返回值​

让我们尝试一个简单的例子：创建一个将两个数字相加的函数。

add(a, b)
  a + b

然后我们可以在条件语句、属性值等中使用这个函数。

body
  padding add(10px, 5)

渲染结果：

body {
  padding: 15px;
}

参数默认值​

可选参数可以默认为给定的表达式。在 Stylus 中，我们甚至可以将参数默认为之前的参数！

例如：

add(a, b = a)
  a + b

add(10, 5)
// => 15

add(10)
// => 20

注意：由于参数默认值是赋值，我们也可以使用函数调用作为默认值：

add(a, b = unit(a, px))
  a + b

命名参数​

函数接受命名参数。这使您不必记住参数的顺序，或者仅仅提高了代码的可读性。

例如：

subtract(a, b)
  a - b

subtract(b: 10, a: 25)

函数体​

我们可以进一步完善我们简单的 add() 函数。让我们通过内置的 unit() 将所有传递的单位转换为 px。它重新分配每个参数，并提供一个单位类型字符串（或标识符），它忽略单位转换。

add(a, b = a)
  a = unit(a, px)
  b = unit(b, px)
  a + b

add(15%, 10deg)
// => 25

多个返回值​

Stylus 函数可以返回多个值，就像您可以将多个值分配给一个变量一样。

例如，以下是一个有效的赋值：

sizes = 15px 10px

sizes[0]
// => 15px

同样，我们可以返回多个值：

sizes()
  15px 10px

sizes()[0]
// => 15px

一个小例外是当返回值是标识符时。例如，以下内容看起来像是 Stylus 的属性赋值（因为没有运算符）：

swap(a, b)
  b a

为了消除歧义，我们可以用括号括起来，或者使用 return 关键字：

swap(a, b)
  (b a)

swap(a, b)
  return b a

条件语句​

假设我们想创建一个名为 stringish() 的函数来确定参数是否可以转换为字符串。我们检查 val 是否为字符串或标识符（类似于字符串）。因为未定义的标识符将它们自己作为值返回，我们可以将它们与自己进行比较，如下所示（其中 yes 和 no 用于代替 true 和 false）：

将代码语言 Stylus 的英文文本翻译成中文，相关的专有名词不做翻译：

stringish(val)
  if val is a 'string' or val is a 'ident'
    yes
  else
    no

用法：

stringish('yay') == yes
// => true

stringish(yay) == yes
// => true

stringish(0) == no
// => true

注意：yes 和 no 不是布尔字面量。在这种情况下，它们只是未定义的标识符。

另一个例子：

compare(a, b)
  if a > b
    higher
  else if a < b
    lower
  else
    equal

用法：

compare(5, 2)
// => higher

compare(1, 5)
// => lower

compare(10, 10)
// => equal

别名​

要为函数设置别名，只需将函数的名称分配给一个新标识符。例如，我们的 add() 函数可以被别名为 plus()，如下所示：

plus = add

plus(1, 2)
// => 3

变量函数​

与我们可以“别名”函数的方式相同，我们也可以传递函数。在这里，我们的 invoke() 函数接受一个函数，因此我们可以将它传递给 add() 或 sub()。

add(a, b)
  a + b

sub(a, b)
  a - b

invoke(a, b, fn)
  fn(a, b)

body
  padding invoke(5, 10, add)
  padding invoke(5, 10, sub)

产生：

body {
  padding: 15;
  padding: -5;
}

匿名函数​

您可以使用 @(){} 语法在需要时使用匿名函数。以下是如何使用它来创建自定义的 sort() 函数：

sort(list, fn = null)
  // 默认排序函数
  if fn == null
    fn = @(a, b) {
      a > b
    }

  // 冒泡排序
  for $i in 1..length(list) - 1
    for $j in 0..$i - 1
      if fn(list[$j], list[$i])
        $temp = list[$i]
        list[$i] = list[$j]
        list[$j] = $temp
  return list

  sort('e' 'c' 'f' 'a' 'b' 'd')
  // => 'a' 'b' 'c' 'd' 'e' 'f'

  sort(5 3 6 1 2 4, @(a, b){
    a < b
  })
  // => 6 5 4 3 2 1

arguments​

arguments 局部变量对所有函数体都可用，并包含传递的所有参数。

例如：

sum()
  n = 0
  for num in arguments
    n = n + num

sum(1,2,3,4,5)
// => 15

哈希示例​

下面我们定义了 get(hash, key) 函数，它返回 key 的值（或 null）。我们迭代 hash 中的每个 pair，当第一个（key）匹配时，返回该对的第二个节点。

get(hash, key)
  return pair[1] if pair[0] == key for pair in hash

如下所示，语言内函数与强大的 Stylus 表达式配对可以提供极大的灵活性：

hash = (one 1) (two 2) (three 3)

get(hash, two)
// => 2

get(hash, three)
// => 3

get(hash, something)
// => 空值