JSDoc:正确记录事件监听器

问题描述 投票:0回答:1

我一直在学习如何在我的项目中使用 JSDoc,除了一两件事之外,我大部分都了解如何使用它。其中之一就是记录事件监听器。

我看过关于

@listens
的文档,但他们给出的解释/示例对我来说没有意义。这是该页面的链接: https://jsdoc.app/tags-listens.html

我想知道是否有人有更好的方法向我解释它,或者也许是如何记录基本事件侦听器的示例。 (我将在下面提供一个。)

document.getElementById('some_element')
  .addEventListener('mousedown', function () {
    // some code
});

谢谢。

javascript jsdoc
1个回答
3
投票

扩展我上面的评论,我认为以下是记录该行代码的可接受方式,其中

document
是命名空间,后跟事件名称
mousedown
:

/**
 * Listen to mousedown event
 *
 * @type {HTMLElement} - the target of the event
 * @listens document#mousedown - the namespace and name of the event
 */

document.getElementById('some_element').addEventListener('mousedown', function () {
  // Some code
});
© www.soinside.com 2019 - 2024. All rights reserved.