在阅读方法的文档时，参数周围的括号是什么意思？ [复制]答案

【问题标题】：What do the brackets around the arguments mean when reading documentation for a method? [duplicate]在阅读方法的文档时，参数周围的括号是什么意思？ [复制]
【发布时间】：2014-03-06 10:13:07
【问题描述】：

通常在阅读有关可以将哪些参数传递给方法的文档时，我会看到参数列表中使用的括号如下所示：

在这种情况下，括号是什么意思？为什么逗号在括号内？

【问题讨论】：

方括号表示可选，就像在所有其他 API/库文档中一样。

标签： javascript api

【解决方案1】：

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

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

.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]])

这意味着第二个和第三个参数是可选的，第三个参数只有在有第二个参数的情况下才能使用。

【讨论】：

你有 4 个参数吗？ p4 在哪里？

【解决方案2】：

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

几乎总是这样。

【讨论】：

直到！我一直想知道[<x>,<y>] 语法。
我很震惊更多的教程没有解释更多的符号。假设人们知道 [, param] 是什么意思是错误的。谢谢你的好回答。

【解决方案3】：

方括号表示它们是可选参数。您不需要传递可选参数。 .animate(properties) 会起作用。逗号也在括号内，因为如果它在外面，它们会拖尾

animate(properties, [duration]) 意味着属性和 , 是强制性的，而持续时间不是......它想：动画（属性，）

【讨论】：