理解jQuery API文档语法

Question

来自http://api.jquery.com/on/：

.on( events [, selector ] [, data ], handler(eventObject) )

我知道这可能听起来有点愚蠢，但有人能解释一下这里的语法吗？

方括号 [] 代表什么意思？我认为它表示您可以添加多个选项（选择器/数据），但由于您还可以添加多个事件，为什么 events 没有方括号呢？

这里是一个 .on() 的示例：

    $(document).on("click", ".item", function() {
alert("hi");
});

这里的方法语法中写入的data是什么意思？

- frrlod

---

我认为它们是可选的，但事件是必需的。 - KryptoniteDove

Answer 1

方括号表示参数是可选的。对于.on()方法，selector和data都是可选的，但events和handler是必需的。

例如：

$(something).on("click", function () {});
//                 ^ events    ^ handler

$(something).on("click", ".child", function () {});
//                ^ events   ^ selector   ^ handler

$(something).on(function () {}); // Won't work, missing events argument

- James Allardice

Answer 2

"[] 表示这些参数是可选的。您可以有零个或一个 selector 和 data。"

"示例调用省略了 data 参数。"

- Chowlett

Answer 3

方括号表示参数是可选的。因此，您可以选择提供选择器（用于事件委托）或数据（用于在事件处理程序函数内部使用），但不一定要这样做。

关于您特定的示例，没有任何值传递给data（因为您不必这样做）。在jQuery on函数的代码中，它根据值的类型确定值实际上是哪个参数的。

- Anthony Grist