@property

描述: 记录一个对象的属性。

别名:

  • prop

概述

@property标签很容易描述类,命名空间或其它对象的静态属性列表。

通常JSDoc模板将创造一个全新的页面来显示关于命名空间嵌套的每一层级的信息。有时候,你真的想要在同一张页面上列出所有属性,包括嵌套的属性。

请注意,@property标记必须在命名空间或类的文档注释块中使用。该标签适用于静态属性的简单集合,它不允许你为每个属性提供@examples或类似的复杂信息,只包含类型,名称和说明。

例子

在这个例子中,我们有一个名为"config"的命名空间。我们想要所有有关默认属性及嵌套值的信息,输出到与"config"同一个页面上。

例如,描述命名空间的默认属性及嵌套属性:

/**
 * @namespace
 * @property {object}  defaults               - The default values for parties.
 * @property {number}  defaults.players       - The default number of players.
 * @property {string}  defaults.level         - The default level for the party.
 * @property {object}  defaults.treasure      - The default treasure.
 * @property {number}  defaults.treasure.gold - How much gold the party starts with.
 */
var config = {
    defaults: {
        players: 1,
        level:   'beginner',
        treasure: {
            gold: 0
        }
    }
};