如何让JSDoc将我的param标记为jQuery对象?

Nic*_* G. 27 javascript jquery jsdoc

我试图彻底评论我的JavaScript,我正在使用JSDoc.我有一个消耗jQuery对象的函数,我想将参数标记为这样.

目前,我有这个:

/**
 * Initializes a login object.
 * @param formEl {JQuery} The login form element on the page.
 */
var login = function(formEl){ ... }
Run Code Online (Sandbox Code Playgroud)

但JSDoc无法识别(或正确格式化)"JQuery"作为变量类型.有帮助吗?

One*_*One 37

根据http://code.google.com/p/jsdoc-toolkit/wiki/TagParam它应该是

参数名称之前的参数类型.

/**
 * Initializes a login object.
 * @param {jQuery} formEl The login form element on the page.
 */
var login = function(formEl){ ... }
Run Code Online (Sandbox Code Playgroud)

  • 通常(至少在我见过的代码中)类型是`jQuery`以匹配导出的全局变量的名称. (14认同)
  • 作为惯例,使用`$`为JQuery对象添加前缀是有帮助的.这样每个人都知道`$ formEl`是对元素的JQuery引用. (4认同)
  • @用户5147563。你是对的,JQuery 是 jQuery 对象,这里的答案应该更改为带有大写 J IMO 的 JQuery。 (4认同)
  • `@param {JQuery}`应该是`@param {jQuery}`,小写j. (3认同)
  • @LoopDuplicate VSCode 告诉我 `jQuery` 是 `$` 后面的对象,用于选择元素。另一方面,`JQuery` 是`$(...)` 返回的元素集对象。 (3认同)