Question

假设我有这样一个类：

function myClass(q) {
  this.someFunction = function(e) {
      console.log("Click event");
  };

  jQuery(q).click(this.someFunction);
}

有没有办法向JSDoc表明someFunction不仅仅是一个应该直接调用的函数，而是一个事件处理程序？

我看到@event标签，但是如果我理解正确的话，这更多的是记录我班上的一个函数，我认为它是一个事件（客户端代码也会注册，我的类会在需要时触发）而不是事件处理函数？

Answer 1

关键字为@listens

用法示例：

/**
 * Outputs the event that happened
 *
 * @param {MyEvent} e - The observable event.
 * @listens MyEvent
 */
function myEventLogger(e) {
    console.log(e);
}

推论是用于举起活动的@fires关键字。

Answer 2

不，没有办法记录事件处理程序。

因此，最好的方法是将其记录为正常功能，也可以用粗体文字或大写字母书写“事件处理程序”。

你现在可能已经这样了，但为了以下情况：只需将文本包装成html标签<strong></strong>即可以粗体编写。

如何在JSDoc中记录事件处理程序？

2 个答案: