了解 JavaScript 文档表示法

【问题标题】：Understanding JavaScript Doc Notations了解 JavaScript 文档表示法
【发布时间】：2016-01-29 11:13:47
【问题描述】：

我正在尝试了解如何阅读 javascript 文档。为什么方括号不在逗号前关闭？

例如

d3.js: selection.style(name[, value[, priority]])

jQuery: $.load( url [, data ] [, complete ] )

【问题讨论】：

因为它们引用非必需参数，如果没有参数名称，也不需要逗号。
好的，我知道这可能是一个非常愚蠢的问题，所以请耐心等待。你是说如果括号关闭，例如如果输入参数是 ([name])，那么这意味着 'name' 是必需的参数/参数，但如果它的 (name[,value]) 则 'value' 是可选的，但 'name' 是必需的？

【解决方案1】：

方括号表示可选部分 - 想象一下从[ 到最近的] 画一条删除线。因此，在 jquery 示例中，您可以省略 data 或 complete 或两者：

$.load( url ~~, 数据~~ , 完成) - 好的

$.load( url , data ~~, complete~~ ) - 好的

$.load( url ~~, data, complete~~ ) - 好的

在d3 sn-p中，如果你省略value，你也必须省略priority

selection.style(name ~~, value, priority~~) - 好的

selection.style(name, value ~~, priority~~) - 好的

selection.style(name ~~, value~~ , priority) - 不好

【讨论】：