在阅读方法的文档时,参数的括号是什么意思？

Question

通常在阅读可以传递给方法的参数的文档时,我会在参数列表中看到括号,如下所示:

括号在这种情况下意味着什么？为什么是逗号内部括号？

Answer 1

required [optional] <required> [<optional>, <but both needed>].

几乎总是如此.

Answer 2

参数周围的括号表示它是可选的。

当像这样单独编写时，这意味着您可以任意组合使用任何参数。该方法根据值的数据类型确定您使用的内容。所有这些组合都可以用于该方法：

.animate(properties, duration, easing, complete)
.animate(properties, duration, easing)
.animate(properties, duration, complete)
.animate(properties, duration)
.animate(properties, easing, complete)
.animate(properties, easing)
.animate(properties, complete)
.animate(properties)

您可以看到以其他方式使用的括号，而不是围绕每个参数。例如：

.method(p1 [, p2 [, p3]])

这意味着第二个和第三个参数是可选的，并且只有在第二个参数存在时才能使用第三个参数。