javascript - 有关 JavaScript 和复杂对象描述的 Visual Studio Intellisense 文档

Question

我正在尝试描述输入和输出对象参数。我有一个获取对象作为参数的方法，我想为智能感知描述它，以便团队在使用我正在开发的库时可以启用智能感知。

    var getSomething(element, params) {
            /// <summary>Function summary</summary>
            /// <param name="element" type="jQuery">Valeur textuelle permettant le groupage</param>
            /// <param name="params" type="Object">{autoCreate:boolean, sSomething:string}</param>
    };

如何使用 Microsoft Visual Studio 的 Intellisense 描述“params”内容？

Answer 1

由于智能感知是由您的 IDE 提供的，因此语法取决于您使用的 IDE。然而，最常见的是源自输出生成文档的工具 JsDoc ( http://usejsdoc.org/ )

例如，要在 IntelliJ 系列(WebStorm、PhpStorm)中得到认可，您的示例可以这样编写:

/**
 * @param {jQuery} element Valeur textuelle permettant le groupage. PS: You need to define jQuery somewhere else
 * @param {Object} params
 * @param {boolean} params.autoCreate
 * @param {string} params.sSomething
 */
var getSomething = function(element, params) { // (your previous syntax was invalid)
};

我的建议是查看您的 IDE 文档以寻求帮助。