> JSDoc在线手册 > @lends

@lends


描述: 将一个字面量对象的所有属性标记为某个标识符(类或模块)的成员。

语法

@lends <namepath>

概述

@lends标签允许你将一个字面量对象的所有成员标记为某个标识符(类或模块)的成员,就像他们是给定名称的标识符成员。你可能想这样做,如果你传递一个对象字面量给一个函数,创建一个成员为对象字面量的命名类。

例子

在这个例子中,我们要使用一个辅助函数创建一个名为"Person"的类,以及名为"initialize" 和 "say"的实例方法。类似于一些流行框架创建类的方式。

例如,给makeClass函数传入一个对象字面量,此对象字面量将会成为类Person的成员:

// We want to document this as being a class
var Person = makeClass(
    // We want to document these as being methods
    {
        initialize: function(name) {
            this.name = name;
        },
        say: function(message) {
            return this.name + " says: " + message;
        }
    }
); 

没有任何意见,JSDoc将无法识别该代码创建的一个Person类有两个方法。为了将他们正确文档化,我们需要在对象字面量紧邻的上方书写"@lends"的标签。@lends标签告诉JSDoc,这一对象字面量的所有成员都会被“借”给"Person"类。

下面的例子更加接近我们想要的,例如,描述静态方法:

/** @class */
var Person = makeClass(
    /** @lends Person */
    {
        initialize: function(name) {
            this.name = name;
        },
        say: function(message) {
            return this.name + " says: " + message;
        }
    }
); 

现在名为"initialize"和"say"的函数会被文档化,但它们被标记为"Person" 类的静态方法。这可能是你的意思,但有种情况下我们想要"initialize"和"say"属于"Person"类的实例。所以,我们通过少做改动,使其成为原型的方法。

例如,标注实例方法:

/** @class */
var Person = makeClass(
    /** @lends Person.prototype */
    {
        initialize: function(name) {
            this.name = name;
        },
        say: function(message) {
            return this.name + " says: " + message;
        }
    }
); 

最后一个步骤:我们类框架使用借来的"initialize"函数来构建Person类的实例,但一个Person实例不具有自己的"initialize"方法。该解决方案是将@constructs标签添加到借出去的函数上。请记住最好删除@class标签,否则两个类将被文档化。

例如,通过 constructor 文档化:

var Person = makeClass(
    /** @lends Person.prototype */
    {
        /** @constructs */
        initialize: function(name) {
            this.name = name;
        },
        say: function(message) {
            return this.name + " says: " + message;
        }
    }
); 

上一篇:
下一篇: