javascript - 如何告诉 JSDoc 某个函数是函数定义类的方法？

Question

示例代码:

/**
 * @module mymodule
 */

/**
 * my namespace
 * @namespace
 */
var MYMODULE = function() {
    var that = {};

    var MyClass;

    /**
     * @class
     */
    MyClass = function() {
        var that = {};

        var myClassMethod;

        /**
         * what to put here?
         */
        myClassMethod = function() {
        };
        that.myClassMethod = myClassMethod;

        return that;
    };
    that.MyClass = MyClass;

    return that;
}();

我希望 myClassMethod() 的文档出现在 JSDoc 为类 MyClass 生成的 HTML 页面上。我该怎么做？

Answer 1

您已将 @module 定义为 mymodule，从此时起，定义应从 module:mymodule... 开始，出现在您的HTML 文档中的模块。以下是示例...

/**
 * @module mymodule
 */
 var mymodule= mymodule|| {};
 /**
  * my namespace
  * @namespace module:mymodule.MYMODULE
  */
 var MYMODULE = function() {
     /**
      * @class
      * @memberof module:mymodule.MYMODULE
      */
     MyClass = function() {
         /**
          * what to put here?
          * @memberof module:mymodule.MYMODULE.MyClass
          */
         myClassMethod = function() {
         }
     }
 }

请注意，如果您不会在注释中重新定义名称，那么在没有 @memberof 注释的情况下，一切都应该正常工作。我们将上述方法与 @memberof 结合使用 @alias 来精细控制我们希望在结果文档中显示的内容。