javascript - 理解 JavaScript 文档符号

Question

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

例如

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

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

Answer 1

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

$.load( url , data , complete ) - ok

$.load( url , data , complete ) - ok

$.load( url , data, complete ) - ok

在 d3 代码段中，如果省略 value，则还必须省略 priority

selection.style(name , value, priority) - ok

selection.style(name, value , priority) - ok

selection.style(name , value , priority) - NOT ok