在 class 中记录属性-命名空间

Question

如何在 class 中记录属性-命名空间？

/**
 * @constructor User
 * @param forename
 * @param surname
 */
function User(forename, surname) {

    /**
     * How to document such a property-namespace?
     */
    this.name = {
        /**
         * How to document such a property?
         */
        first: forename,

        /**
         * How to document such a property?
         */
        second: surname
    };

}

更新：

使用 @namespace 和 @property 确实有效，但它显示在 Namespaces 而不是 Members 或 Properties 下，并且仅作为 link 将我带到一个单独的页面，这很尴尬，因为我只记录了一个 class。更糟糕的是，这样的名称空间也出现在全局名称空间列表中。似乎是一个糟糕的解决方案。还有更好的吗？

Answer 1

这个有效：

/**
 * @constructor User
 * @param forename
 * @param surname
 */
function User(forename, surname) {

    /**
     * @member {Object} User.name
     *
     * @property {String} forename
     *
     * @property {String} surname
     */
    this.name = {
        forename: forename,
        surname: surname
    };

}

谢谢@mostruash！

在 class 中记录属性-命名空间

Documenting a property-namespace inside a class

javascript

jsdoc

在 class 中记录 属性-命名空间

Documenting a property-namespace inside a class

javascript

jsdoc

在 class 中记录属性-命名空间