html内联注释,块标签和内联标签

块标签和内联标签

概述

JSDoc支持两种不同类型的标签：块标签, 这是在一个JSDoc注释的最高级别。

内联标签, 块标签文本中的标签或说明。

块标签通常会提供有关您的代码的详细信息，如一个函数接受的参数。内联标签通常链接到文件的其他部分，类似于HTML中的锚标记()。

块标签总是以 at 符号(@)开头。除了JSDoc注释中最后一个块标记，每个块标签后面必须跟一个换行符。

内联标签也以 at 符号(@)开。然而，内联标签及其文本必须用花括号({ and })括起来。 { 表示行内联标签的开始，而}表示内联标签的结束。如果你的标签文本中包含右花括号(})，则必须用反斜线( \ )进行转义。在内联标签后,你并不需要使用一个换行符。

大多数JSDoc标签是块标签。一般来说，当这个网站上说"JSDoc 标签",我们真正的意思是"块标签"。

示例

在下面的例子中， @param 是一个块标签，而{@link}是一个内联标签。

例如，JSDoc注释中的块标签和内联标签：/**

* Set the shoe's color. Use {@link Shoe#setSize} to set the shoe size.

*

* @param {string} color - The shoe's color.

*/Shoe.prototype.setColor = function(color) {    // ...};

您可以在描述中使用内联标签，如上图所示，或在块标记中使用内联标签，如下图所示。

例如，块标签内使用内嵌标签：/**

* Set the shoe's color.

*

* @param {SHOE_COLORS} color - The shoe color. Must be an enumerated

* value of {@link SHOE_COLORS}.

*/Shoe.prototype.setColor = function(color) {    // ...};

当您在JSDoc注释中使用多个块标记，它们必须使用换行符将他们分开。

例如，用换行符分隔的多个块标签：/**

* Set the color and type of the shoelaces.

*

* @param {LACE_COLORS} color - The shoelace color.

* @param {LACE_TYPES} type - The type of shoelace.

*/Shoe.prototype.setLaceType = function(color, type) {    // ...};