@param
タグを使用すると、プロパティをドキュメント化できます。
/**
* @param {Object} userInfo Information about the user.
* @param {String} userInfo.name The name of the user.
* @param {String} userInfo.email The email of the user.
*/
@thisタグのプロパティをどのように文書化しますか?
/**
* @this {Object}
* @param {String} this.name The name of the user.
* @param {String} this.email The email of the user.
*/
プロジェクトに取り組んでいる誰かが知っているかどうか疑問に思っています。 (ドキュメントはまだ作成中です...)
インスタンスメンバーを文書化するには、@name Class#member
を使用します。
/**
Construct a new component
@class Component
@classdesc A generic component
@param {Object} options - Options to initialize the component with
@param {String} options.name - This component's name, sets {@link Component#name}
@param {Boolean} options.visible - Whether this component is vislble, sets {@link Component#visible}
*/
function Component(options) {
/**
Whether this component is visible or not
@name Component#visible
@type Boolean
@default false
*/
this.visible = options.visible;
/**
This component's name
@name Component#name
@type String
@default "Component"
@readonly
*/
Object.defineProperty(this, 'name', {
value: options.name || 'Component',
writable: false
});
}
その結果、ドキュメントのMembersセクションに、各メンバー、そのタイプ、デフォルト値、および読み取り専用かどうかがリストされます。
[email protected]によって生成される出力は次のようになります。
以下も参照してください。
使用 @property
タグは、オブジェクトの属性を説明します。
@param
は、メソッドまたはコンストラクターのパラメーターを定義するために使用されます。
@this
は、this
が参照するオブジェクトを定義するために使用されます。 JSDOC 3を使用した例を次に示します。
/**
* @class Person
* @classdesc A person object that only takes in names.
* @property {String} this.name - The name of the Person.
* @param {String} name - The name that will be supplied to this.name.
* @this Person
*/
var Person = function( name ){
this.name = name;
};
JSDOC 3: https://github.com/jsdoc3/jsdoc
Jsdocは、クラスのコンストラクター内で、ドキュメント化されたプロパティがクラスのインスタンスに属していること自体を認識します。したがって、これで十分です:
/**
* @classdesc My little class.
*
* @class
* @memberof module:MyModule
* @param {*} myParam Constructor parameter.
*/
function MyLittleClass(myParam) {
/**
* Instance property.
* @type {string}
*/
this.myProp = 'foo';
}
Jsdocで関数がクラスコンストラクターであることが明確でない場合は、@this
を使用して、this
が参照するものを定義できます。
/**
* @classdesc My little class.
*
* @class
* @memberof module:MyModule
* @name MyLittleClass
* @param {*} myParam Constructor parameter.
*/
// Somewhere else, the constructor is defined:
/**
* @this module:MyModule.MyLittleClass
*/
function(myParam) {
/**
* Instance property.
* @type {string}
*/
this.myProp = 'foo';
}