购物车
登陆 / 注册
微信扫码登陆

@property

@property
@property标签很容易描述类,命名空间或其它对象的静态属性列表。
编辑:青灯夜游 青灯夜游 更新时间:2019-01-07 14:40:42

@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
        }
    }
};
网站导航
网站首页
学习路径
视频教程
开发软件
旗下子站
php中文网
phpstudy
文章列表
教程文档
关于我们
企业合作
人才招聘
联系我们
讲师招募
QQ交流群
QQ交流群
微信公众号
微信公众号