sách gpt4 ăn đã đi

javascript - 文档中是否有 JSDoc 标签的正式命令?

In lại 作者:数据小太阳 更新时间:2023-10-29 04:40:33 25 4
mua khóa gpt4 giày nike

我正在记录一个 JavaScript API。我正在遵循谷歌风格指南,但我没有发现任何关于标签顺序的信息。

我通常记录这样一个变量:

/**
* @description Radius of the circle
* @private
* @memberOf Circle
* @type {Number}
* @default
*/
Circle.prototype._radius = 1;

如您所见,我使用自己的顺序编写标签,这是我认为最直观的顺序。

这是按字母顺序排列标签的同一文档:

/**
* @default
* @description Radius of the circle
* @memberOf Circle
* @private
* @type {Number}
*/
Circle.prototype._radius = 1;

尽管有明确定义的顺序(按字母顺序),但我发现这有点令人困惑,因为它打乱了评论的自然顺序。这就是为什么我正在寻找一种方法来编写带有特定官方命令的标签。

这些标签是否有官方订单?

Cảm ơn

câu trả lời hay nhất

JSDoc 标签没有官方规定。我倾向于先放置更通用的标签,然后放置更具体的标签,类似于您的第一个示例。

一般来说,JSDoc 不关心标签的顺序,但也有一些值得注意的异常(exception):

  • 第一个标签之前的任何文本都将用作描述。您还可以使用 @desc(hoặc @description)标记提供描述,就像您在示例中所做的那样。
  • 当您使用@param 标记来记录函数参数时,参数必须使用与函数签名相同的顺序。

关于javascript - 文档中是否有 JSDoc 标签的正式命令?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/24306839/

25 4 0
Chứng chỉ ICP Bắc Kinh số 000000
Hợp tác quảng cáo: 1813099741@qq.com 6ren.com
Xem sitemap của VNExpress