当前位置: 首页 > 文档资料 > JSDoc 中文文档 >

@inheritdoc

优质
小牛编辑
129浏览
2023-12-01

描述: 指明这个标识应继承其父类的文档。

版本: '>=3.3.0'

Overview(概述)

@inheritdoc标签指示该标识应继承其父类的文档。在你的JSDoc注释中的任何其它标签都将被忽略。

这个标签是为Closure Compiler提供了兼容性。默认情况下,如果不给标识符加JSDoc注释,标识符将继承其父级的文档。

@inheritdoc标签的存在意味着@override 标签存在。

Examples(例子)

下面的例子显示了一个类的描述如何从它的父类继承文档。

例如,一个类继承自他的父类:

/**
 * @classdesc Abstract class representing a network connection.
 * @class
 */
function Connection() {}

/**
 * Open the connection.
 */
Connection.prototype.open = function() {
    // ...
};


/**
 * @classdesc Class representing a socket connection.
 * @class
 * @augments Connection
 */
function Socket() {}

/** @inheritdoc */
Socket.prototype.open = function() {
    // ...
};

省略Socket#open的JSDoc注释,你可以得到同样的结果。

例如, 没有@inheritdoc标签继承文档:

/**
 * @classdesc Abstract class representing a network connection.
 * @class
 */
function Connection() {}

/**
 * Open the connection.
 */
Connection.prototype.open = function() {
    // ...
};


/**
 * @classdesc Class representing a socket connection.
 * @class
 * @augments Connection
 */
function Socket() {}

Socket.prototype.open = function() {
    // ...
};